Upgrade to ExtJS 4.0.1 - Released 05/18/2011
[extjs.git] / docs / source / Toolbar.html
index 703aa00..e627c73 100644 (file)
+<!DOCTYPE html>
 <html>
 <head>
 <html>
 <head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <title>The source code</title>
   <title>The source code</title>
-    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
-    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+  <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
+  <script type="text/javascript" src="../prettify/prettify.js"></script>
+  <style type="text/css">
+    .highlight { display: block; background-color: #ddd; }
+  </style>
+  <script type="text/javascript">
+    function highlight() {
+      document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
+    }
+  </script>
 </head>
 </head>
-<body  onload="prettyPrint();">
-    <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
- * licensing@extjs.com
- * http://www.extjs.com/license
+<body onload="prettyPrint(); highlight();">
+  <pre class="prettyprint lang-js"><span id='Ext-toolbar-Toolbar-method-constructor'><span id='Ext-toolbar-Toolbar'>/**
+</span></span> * @class Ext.toolbar.Toolbar
+ * @extends Ext.container.Container
+
+Basic Toolbar class. Although the {@link Ext.container.Container#defaultType defaultType} for Toolbar is {@link Ext.button.Button button}, Toolbar 
+elements (child items for the Toolbar container) may be virtually any type of Component. Toolbar elements can be created explicitly via their 
+constructors, or implicitly via their xtypes, and can be {@link #add}ed dynamically.
+
+__Some items have shortcut strings for creation:__
+
+| Shortcut | xtype         | Class                         | Description                                        |
+|:---------|:--------------|:------------------------------|:---------------------------------------------------|
+| `-&gt;`     | `tbspacer`    | {@link Ext.toolbar.Fill}      | begin using the right-justified button container   |
+| `-`      | `tbseparator` | {@link Ext.toolbar.Separator} | add a vertical separator bar between toolbar items |
+| ` `      | `tbspacer`    | {@link Ext.toolbar.Spacer}    | add horiztonal space between elements              |
+
+{@img Ext.toolbar.Toolbar/Ext.toolbar.Toolbar1.png Toolbar component}
+Example usage:
+
+    Ext.create('Ext.toolbar.Toolbar', {
+        renderTo: document.body,
+        width   : 500,
+        items: [
+            {
+                // xtype: 'button', // default for Toolbars
+                text: 'Button'
+            },
+            {
+                xtype: 'splitbutton',
+                text : 'Split Button'
+            },
+            // begin using the right-justified button container
+            '-&gt;', // same as {xtype: 'tbfill'}, // Ext.toolbar.Fill
+            {
+                xtype    : 'textfield',
+                name     : 'field1',
+                emptyText: 'enter search term'
+            },
+            // add a vertical separator bar between toolbar items
+            '-', // same as {xtype: 'tbseparator'} to create Ext.toolbar.Separator
+            'text 1', // same as {xtype: 'tbtext', text: 'text1'} to create Ext.toolbar.TextItem
+            {xtype: 'tbspacer'},// same as ' ' to create Ext.toolbar.Spacer
+            'text 2',
+            {xtype: 'tbspacer', width: 50}, // add a 50px space
+            'text 3'
+        ]
+    });
+
+Toolbars have {@link #enable} and {@link #disable} methods which when called, will enable/disable all items within your toolbar.
+
+{@img Ext.toolbar.Toolbar/Ext.toolbar.Toolbar2.png Toolbar component}
+Example usage:
+
+    Ext.create('Ext.toolbar.Toolbar', {
+        renderTo: document.body,
+        width   : 400,
+        items: [
+            {
+                text: 'Button'
+            },
+            {
+                xtype: 'splitbutton',
+                text : 'Split Button'
+            },
+            '-&gt;',
+            {
+                xtype    : 'textfield',
+                name     : 'field1',
+                emptyText: 'enter search term'
+            }
+        ]
+    });
+
+{@img Ext.toolbar.Toolbar/Ext.toolbar.Toolbar3.png Toolbar component}
+Example usage:
+    
+    var enableBtn = Ext.create('Ext.button.Button', {
+        text    : 'Enable All Items',
+        disabled: true,
+        scope   : this,
+        handler : function() {
+            //disable the enable button and enable the disable button
+            enableBtn.disable();
+            disableBtn.enable();
+            
+            //enable the toolbar
+            toolbar.enable();
+        }
+    });
+    
+    var disableBtn = Ext.create('Ext.button.Button', {
+        text    : 'Disable All Items',
+        scope   : this,
+        handler : function() {
+            //enable the enable button and disable button
+            disableBtn.disable();
+            enableBtn.enable();
+            
+            //disable the toolbar
+            toolbar.disable();
+        }
+    });
+    
+    var toolbar = Ext.create('Ext.toolbar.Toolbar', {
+        renderTo: document.body,
+        width   : 400,
+        margin  : '5 0 0 0',
+        items   : [enableBtn, disableBtn]
+    });
+
+Adding items to and removing items from a toolbar is as simple as calling the {@link #add} and {@link #remove} methods. There is also a {@link #removeAll} method 
+which remove all items within the toolbar.
+
+{@img Ext.toolbar.Toolbar/Ext.toolbar.Toolbar4.png Toolbar component}
+Example usage:
+
+    var toolbar = Ext.create('Ext.toolbar.Toolbar', {
+        renderTo: document.body,
+        width   : 700,
+        items: [
+            {
+                text: 'Example Button'
+            }
+        ]
+    });
+    
+    var addedItems = [];
+    
+    Ext.create('Ext.toolbar.Toolbar', {
+        renderTo: document.body,
+        width   : 700,
+        margin  : '5 0 0 0',
+        items   : [
+            {
+                text   : 'Add a button',
+                scope  : this,
+                handler: function() {
+                    var text = prompt('Please enter the text for your button:');
+                    addedItems.push(toolbar.add({
+                        text: text
+                    }));
+                }
+            },
+            {
+                text   : 'Add a text item',
+                scope  : this,
+                handler: function() {
+                    var text = prompt('Please enter the text for your item:');
+                    addedItems.push(toolbar.add(text));
+                }
+            },
+            {
+                text   : 'Add a toolbar seperator',
+                scope  : this,
+                handler: function() {
+                    addedItems.push(toolbar.add('-'));
+                }
+            },
+            {
+                text   : 'Add a toolbar spacer',
+                scope  : this,
+                handler: function() {
+                    addedItems.push(toolbar.add('-&gt;'));
+                }
+            },
+            '-&gt;',
+            {
+                text   : 'Remove last inserted item',
+                scope  : this,
+                handler: function() {
+                    if (addedItems.length) {
+                        toolbar.remove(addedItems.pop());
+                    } else if (toolbar.items.length) {
+                        toolbar.remove(toolbar.items.last());
+                    } else {
+                        alert('No items in the toolbar');
+                    }
+                }
+            },
+            {
+                text   : 'Remove all items',
+                scope  : this,
+                handler: function() {
+                    toolbar.removeAll();
+                }
+            }
+        ]
+    });
+
+ * @constructor
+ * Creates a new Toolbar
+ * @param {Object/Array} config A config object or an array of buttons to &lt;code&gt;{@link #add}&lt;/code&gt;
+ * @xtype toolbar
+ * @docauthor Robert Dougan &lt;rob@sencha.com&gt;
+ * @markdown
  */
  */
-<div id="cls-Ext.layout.ToolbarLayout"></div>/**\r
- * @class Ext.layout.ToolbarLayout\r
- * @extends Ext.layout.ContainerLayout\r
- * Layout manager implicitly used by Ext.Toolbar.\r
- */\r
-Ext.layout.ToolbarLayout = Ext.extend(Ext.layout.ContainerLayout, {\r
-    monitorResize : true,\r
-    triggerWidth : 18,\r
-    lastOverflow : false,\r
-\r
-    noItemsMenuText : '<div class="x-toolbar-no-items">(None)</div>',\r
-    // private\r
-    onLayout : function(ct, target){\r
-        if(!this.leftTr){\r
-            target.addClass('x-toolbar-layout-ct');\r
-            target.insertHtml('beforeEnd',\r
-                 '<table cellspacing="0" class="x-toolbar-ct"><tbody><tr><td class="x-toolbar-left" align="left"><table cellspacing="0"><tbody><tr class="x-toolbar-left-row"></tr></tbody></table></td><td class="x-toolbar-right" align="right"><table cellspacing="0" class="x-toolbar-right-ct"><tbody><tr><td><table cellspacing="0"><tbody><tr class="x-toolbar-right-row"></tr></tbody></table></td><td><table cellspacing="0"><tbody><tr class="x-toolbar-extras-row"></tr></tbody></table></td></tr></tbody></table></td></tr></tbody></table>');\r
-            this.leftTr = target.child('tr.x-toolbar-left-row', true);\r
-            this.rightTr = target.child('tr.x-toolbar-right-row', true);\r
-            this.extrasTr = target.child('tr.x-toolbar-extras-row', true);\r
-        }\r
-        var side = this.leftTr;\r
-        var pos = 0;\r
-\r
-        var items = ct.items.items;\r
-        for(var i = 0, len = items.length, c; i < len; i++, pos++) {\r
-            c = items[i];\r
-            if(c.isFill){\r
-                side = this.rightTr;\r
-                pos = -1;\r
-            }else if(!c.rendered){\r
-                c.render(this.insertCell(c, side, pos));\r
-            }else{\r
-                if(!c.xtbHidden && !this.isValidParent(c, side.childNodes[pos])){\r
-                    var td = this.insertCell(c, side, pos);\r
-                    td.appendChild(c.getDomPositionEl().dom);\r
-                    c.container = Ext.get(td);\r
-                }\r
-            }\r
-        }\r
-        //strip extra empty cells\r
-        this.cleanup(this.leftTr);\r
-        this.cleanup(this.rightTr);\r
-        this.cleanup(this.extrasTr);\r
-        this.fitToSize(target);\r
-    },\r
-\r
-    cleanup : function(row){\r
-        var cn = row.childNodes;\r
-        for(var i = cn.length-1, c; i >= 0 && (c = cn[i]); i--){\r
-            if(!c.firstChild){\r
-                row.removeChild(c);\r
-            }\r
-        }\r
-    },\r
-\r
-    insertCell : function(c, side, pos){\r
-        var td = document.createElement('td');\r
-        td.className='x-toolbar-cell';\r
-        side.insertBefore(td, side.childNodes[pos]||null);\r
-        return td;\r
-    },\r
-\r
-    hideItem : function(item){\r
-        var h = (this.hiddens = this.hiddens || []);\r
-        h.push(item);\r
-        item.xtbHidden = true;\r
-        item.xtbWidth = item.getDomPositionEl().dom.parentNode.offsetWidth;\r
-        item.hide();\r
-    },\r
-\r
-    unhideItem : function(item){\r
-        item.show();\r
-        item.xtbHidden = false;\r
-        this.hiddens.remove(item);\r
-        if(this.hiddens.length < 1){\r
-            delete this.hiddens;\r
-        }\r
-    },\r
-\r
-    getItemWidth : function(c){\r
-        return c.hidden ? (c.xtbWidth || 0) : c.getDomPositionEl().dom.parentNode.offsetWidth;\r
-    },\r
-\r
-    fitToSize : function(t){\r
-        if(this.container.enableOverflow === false){\r
-            return;\r
-        }\r
-        var w = t.dom.clientWidth;\r
-        var lw = this.lastWidth || 0;\r
-        this.lastWidth = w;\r
-        var iw = t.dom.firstChild.offsetWidth;\r
-\r
-        var clipWidth = w - this.triggerWidth;\r
-        var hideIndex = -1;\r
-\r
-        if(iw > w || (this.hiddens && w >= lw)){\r
-            var i, items = this.container.items.items, len = items.length, c;\r
-            var loopWidth = 0;\r
-            for(i = 0; i < len; i++) {\r
-                c = items[i];\r
-                if(!c.isFill){\r
-                    loopWidth += this.getItemWidth(c);\r
-                    if(loopWidth > clipWidth){\r
-                        if(!c.xtbHidden){\r
-                            this.hideItem(c);\r
-                        }\r
-                    }else{\r
-                        if(c.xtbHidden){\r
-                            this.unhideItem(c);\r
-                        }\r
-                    }\r
-                }\r
-            }\r
-        }\r
-        if(this.hiddens){\r
-            this.initMore();\r
-            if(!this.lastOverflow){\r
-                this.container.fireEvent('overflowchange', this.container, true);\r
-                this.lastOverflow = true;\r
-            }\r
-        }else if(this.more){\r
-            this.clearMenu();\r
-            this.more.destroy();\r
-            delete this.more;\r
-            if(this.lastOverflow){\r
-                this.container.fireEvent('overflowchange', this.container, false);\r
-                this.lastOverflow = false;\r
-            }\r
-        }\r
-    },\r
-\r
-    createMenuConfig : function(c, hideOnClick){\r
-        var cfg = Ext.apply({}, c.initialConfig),\r
-            group = c.toggleGroup;\r
-\r
-        Ext.apply(cfg, {\r
-            text: c.overflowText || c.text,\r
-            iconCls: c.iconCls,\r
-            icon: c.icon,\r
-            itemId: c.itemId,\r
-            disabled: c.disabled,\r
-            handler: c.handler,\r
-            scope: c.scope,\r
-            menu: c.menu,\r
-            hideOnClick: hideOnClick\r
-        });\r
-        if(group || c.enableToggle){\r
-            Ext.apply(cfg, {\r
-                group: group,\r
-                checked: c.pressed,\r
-                listeners: {\r
-                    checkchange: function(item, checked){\r
-                        c.toggle(checked);\r
-                    }\r
-                }\r
-            });\r
-        }\r
-        delete cfg.xtype;\r
-        delete cfg.id;\r
-        return cfg;\r
-    },\r
-\r
-    // private\r
-    addComponentToMenu : function(m, c){\r
-        if(c instanceof Ext.Toolbar.Separator){\r
-            m.add('-');\r
-        }else if(Ext.isFunction(c.isXType)){\r
-            if(c.isXType('splitbutton')){\r
-                m.add(this.createMenuConfig(c, true));\r
-            }else if(c.isXType('button')){\r
-                m.add(this.createMenuConfig(c, !c.menu));\r
-            }else if(c.isXType('buttongroup')){\r
-                c.items.each(function(item){\r
-                     this.addComponentToMenu(m, item);\r
-                }, this);\r
-            }\r
-        }\r
-    },\r
-\r
-    clearMenu : function(){\r
-        var m = this.moreMenu;\r
-        if(m && m.items){\r
-            m.items.each(function(item){\r
-                delete item.menu;\r
-            });\r
-        }\r
-    },\r
-\r
-    // private\r
-    beforeMoreShow : function(m){\r
-        var h = this.container.items.items,\r
-            len = h.length,\r
-            c,\r
-            prev,\r
-            needsSep = function(group, item){\r
-                return group.isXType('buttongroup') && !(item instanceof Ext.Toolbar.Separator);\r
-            };\r
-\r
-        this.clearMenu();\r
-        m.removeAll();\r
-        for(var i = 0; i < len; i++){\r
-            c = h[i];\r
-            if(c.xtbHidden){\r
-                if(prev && (needsSep(c, prev) || needsSep(prev, c))){\r
-                    m.add('-');\r
-                }\r
-                this.addComponentToMenu(m, c);\r
-                prev = c;\r
-            }\r
-        }\r
-        // put something so the menu isn't empty\r
-        // if no compatible items found\r
-        if(m.items.length < 1){\r
-            m.add(this.noItemsMenuText);\r
-        }\r
-    },\r
-\r
-    initMore : function(){\r
-        if(!this.more){\r
-            this.moreMenu = new Ext.menu.Menu({\r
-                listeners: {\r
-                    beforeshow: this.beforeMoreShow,\r
-                    scope: this\r
-                }\r
-            });\r
-            this.moreMenu.ownerCt = this.container;\r
-            this.more = new Ext.Button({\r
-                iconCls: 'x-toolbar-more-icon',\r
-                cls: 'x-toolbar-more',\r
-                menu: this.moreMenu\r
-            });\r
-            var td = this.insertCell(this.more, this.extrasTr, 100);\r
-            this.more.render(td);\r
-        }\r
-    },\r
-\r
-    destroy : function(){\r
-        Ext.destroy(this.more, this.moreMenu);\r
-        Ext.layout.ToolbarLayout.superclass.destroy.call(this);\r
-    }\r
-    <div id="prop-Ext.layout.ToolbarLayout-activeItem"></div>/**\r
-     * @property activeItem\r
-     * @hide\r
-     */\r
-});\r
-\r
-Ext.Container.LAYOUTS.toolbar = Ext.layout.ToolbarLayout;\r
-\r
-<div id="cls-Ext.Toolbar"></div>/**\r
- * @class Ext.Toolbar\r
- * @extends Ext.Container\r
- * <p>Basic Toolbar class. Although the <tt>{@link Ext.Container#defaultType defaultType}</tt> for Toolbar\r
- * is <tt>{@link Ext.Button button}</tt>, Toolbar elements (child items for the Toolbar container) may\r
- * be virtually any type of Component. Toolbar elements can be created explicitly via their constructors,\r
- * or implicitly via their xtypes, and can be <tt>{@link #add}</tt>ed dynamically.</p>\r
- * <p>Some items have shortcut strings for creation:</p>\r
- * <pre>\r
-<u>Shortcut</u>  <u>xtype</u>          <u>Class</u>                  <u>Description</u>\r
-'->'      'tbfill'       {@link Ext.Toolbar.Fill}       begin using the right-justified button container\r
-'-'       'tbseparator'  {@link Ext.Toolbar.Separator}  add a vertical separator bar between toolbar items\r
-' '       'tbspacer'     {@link Ext.Toolbar.Spacer}     add horiztonal space between elements\r
- * </pre>\r
- *\r
- * Example usage of various elements:\r
- * <pre><code>\r
-var tb = new Ext.Toolbar({\r
-    renderTo: document.body,\r
-    width: 600,\r
-    height: 100,\r
-    items: [\r
-        {\r
-            // xtype: 'button', // default for Toolbars, same as 'tbbutton'\r
-            text: 'Button'\r
-        },\r
-        {\r
-            xtype: 'splitbutton', // same as 'tbsplitbutton'\r
-            text: 'Split Button'\r
-        },\r
-        // begin using the right-justified button container\r
-        '->', // same as {xtype: 'tbfill'}, // Ext.Toolbar.Fill\r
-        {\r
-            xtype: 'textfield',\r
-            name: 'field1',\r
-            emptyText: 'enter search term'\r
-        },\r
-        // add a vertical separator bar between toolbar items\r
-        '-', // same as {xtype: 'tbseparator'} to create Ext.Toolbar.Separator\r
-        'text 1', // same as {xtype: 'tbtext', text: 'text1'} to create Ext.Toolbar.TextItem\r
-        {xtype: 'tbspacer'},// same as ' ' to create Ext.Toolbar.Spacer\r
-        'text 2',\r
-        {xtype: 'tbspacer', width: 50}, // add a 50px space\r
-        'text 3'\r
-    ]\r
-});\r
- * </code></pre>\r
- * Example adding a ComboBox within a menu of a button:\r
- * <pre><code>\r
-// ComboBox creation\r
-var combo = new Ext.form.ComboBox({\r
-    store: new Ext.data.ArrayStore({\r
-        autoDestroy: true,\r
-        fields: ['initials', 'fullname'],\r
-        data : [\r
-            ['FF', 'Fred Flintstone'],\r
-            ['BR', 'Barney Rubble']\r
-        ]\r
-    }),\r
-    displayField: 'fullname',\r
-    typeAhead: true,\r
-    mode: 'local',\r
-    forceSelection: true,\r
-    triggerAction: 'all',\r
-    emptyText: 'Select a name...',\r
-    selectOnFocus: true,\r
-    width: 135,\r
-    getListParent: function() {\r
-        return this.el.up('.x-menu');\r
-    },\r
-    iconCls: 'no-icon' //use iconCls if placing within menu to shift to right side of menu\r
-});\r
-\r
-// put ComboBox in a Menu\r
-var menu = new Ext.menu.Menu({\r
-    id: 'mainMenu',\r
-    items: [\r
-        combo // A Field in a Menu\r
-    ]\r
-});\r
-\r
-// add a Button with the menu\r
-tb.add({\r
-        text:'Button w/ Menu',\r
-        menu: menu  // assign menu by instance\r
-    });\r
-tb.doLayout();\r
- * </code></pre>\r
- * @constructor\r
- * Creates a new Toolbar\r
- * @param {Object/Array} config A config object or an array of buttons to <tt>{@link #add}</tt>\r
- * @xtype toolbar\r
- */\r
-Ext.Toolbar = function(config){\r
-    if(Ext.isArray(config)){\r
-        config = {items: config, layout: 'toolbar'};\r
-    } else {\r
-        config = Ext.apply({\r
-            layout: 'toolbar'\r
-        }, config);\r
-        if(config.buttons) {\r
-            config.items = config.buttons;\r
-        }\r
-    }\r
-    Ext.Toolbar.superclass.constructor.call(this, config);\r
-};\r
-\r
-(function(){\r
-\r
-var T = Ext.Toolbar;\r
-\r
-Ext.extend(T, Ext.Container, {\r
-\r
-    defaultType: 'button',\r
-\r
-    <div id="cfg-Ext.Toolbar-layout"></div>/**\r
-     * @cfg {String/Object} layout\r
-     * This class assigns a default layout (<code>layout:'<b>toolbar</b>'</code>).\r
-     * Developers <i>may</i> override this configuration option if another layout\r
-     * is required (the constructor must be passed a configuration object in this\r
-     * case instead of an array).\r
-     * See {@link Ext.Container#layout} for additional information.\r
-     */\r
-\r
-    trackMenus : true,\r
-    internalDefaults: {removeMode: 'container', hideParent: true},\r
-    toolbarCls: 'x-toolbar',\r
-\r
-    initComponent : function(){\r
-        T.superclass.initComponent.call(this);\r
-\r
-        <div id="event-Ext.Toolbar-overflowchange"></div>/**\r
-         * @event overflowchange\r
-         * Fires after the overflow state has changed.\r
-         * @param {Object} c The Container\r
-         * @param {Boolean} lastOverflow overflow state\r
-         */\r
-        this.addEvents('overflowchange');\r
-    },\r
-\r
-    // private\r
-    onRender : function(ct, position){\r
-        if(!this.el){\r
-            if(!this.autoCreate){\r
-                this.autoCreate = {\r
-                    cls: this.toolbarCls + ' x-small-editor'\r
-                };\r
-            }\r
-            this.el = ct.createChild(Ext.apply({ id: this.id },this.autoCreate), position);\r
-            Ext.Toolbar.superclass.onRender.apply(this, arguments);\r
-        }\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-add"></div>/**\r
-     * <p>Adds element(s) to the toolbar -- this function takes a variable number of\r
-     * arguments of mixed type and adds them to the toolbar.</p>\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @param {Mixed} arg1 The following types of arguments are all valid:<br />\r
-     * <ul>\r
-     * <li>{@link Ext.Button} config: A valid button config object (equivalent to {@link #addButton})</li>\r
-     * <li>HtmlElement: Any standard HTML element (equivalent to {@link #addElement})</li>\r
-     * <li>Field: Any form field (equivalent to {@link #addField})</li>\r
-     * <li>Item: Any subclass of {@link Ext.Toolbar.Item} (equivalent to {@link #addItem})</li>\r
-     * <li>String: Any generic string (gets wrapped in a {@link Ext.Toolbar.TextItem}, equivalent to {@link #addText}).\r
-     * Note that there are a few special strings that are treated differently as explained next.</li>\r
-     * <li>'-': Creates a separator element (equivalent to {@link #addSeparator})</li>\r
-     * <li>' ': Creates a spacer element (equivalent to {@link #addSpacer})</li>\r
-     * <li>'->': Creates a fill element (equivalent to {@link #addFill})</li>\r
-     * </ul>\r
-     * @param {Mixed} arg2\r
-     * @param {Mixed} etc.\r
-     * @method add\r
-     */\r
-\r
-    // private\r
-    lookupComponent : function(c){\r
-        if(Ext.isString(c)){\r
-            if(c == '-'){\r
-                c = new T.Separator();\r
-            }else if(c == ' '){\r
-                c = new T.Spacer();\r
-            }else if(c == '->'){\r
-                c = new T.Fill();\r
-            }else{\r
-                c = new T.TextItem(c);\r
-            }\r
-            this.applyDefaults(c);\r
-        }else{\r
-            if(c.isFormField || c.render){ // some kind of form field, some kind of Toolbar.Item\r
-                c = this.constructItem(c);\r
-            }else if(c.tag){ // DomHelper spec\r
-                c = new T.Item({autoEl: c});\r
-            }else if(c.tagName){ // element\r
-                c = new T.Item({el:c});\r
-            }else if(Ext.isObject(c)){ // must be button config?\r
-                c = c.xtype ? this.constructItem(c) : this.constructButton(c);\r
-            }\r
-        }\r
-        return c;\r
-    },\r
-\r
-    // private\r
-    applyDefaults : function(c){\r
-        if(!Ext.isString(c)){\r
-            c = Ext.Toolbar.superclass.applyDefaults.call(this, c);\r
-            var d = this.internalDefaults;\r
-            if(c.events){\r
-                Ext.applyIf(c.initialConfig, d);\r
-                Ext.apply(c, d);\r
-            }else{\r
-                Ext.applyIf(c, d);\r
-            }\r
-        }\r
-        return c;\r
-    },\r
-\r
-    // private\r
-    constructItem : function(item, type){\r
-        return Ext.create(item, type || this.defaultType);\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addSeparator"></div>/**\r
-     * Adds a separator\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @return {Ext.Toolbar.Item} The separator {@link Ext.Toolbar.Item item}\r
-     */\r
-    addSeparator : function(){\r
-        return this.add(new T.Separator());\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addSpacer"></div>/**\r
-     * Adds a spacer element\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @return {Ext.Toolbar.Spacer} The spacer item\r
-     */\r
-    addSpacer : function(){\r
-        return this.add(new T.Spacer());\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addFill"></div>/**\r
-     * Forces subsequent additions into the float:right toolbar\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     */\r
-    addFill : function(){\r
-        this.add(new T.Fill());\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addElement"></div>/**\r
-     * Adds any standard HTML element to the toolbar\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @param {Mixed} el The element or id of the element to add\r
-     * @return {Ext.Toolbar.Item} The element's item\r
-     */\r
-    addElement : function(el){\r
-        return this.addItem(new T.Item({el:el}));\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addItem"></div>/**\r
-     * Adds any Toolbar.Item or subclass\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @param {Ext.Toolbar.Item} item\r
-     * @return {Ext.Toolbar.Item} The item\r
-     */\r
-    addItem : function(item){\r
-        return this.add.apply(this, arguments);\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addButton"></div>/**\r
-     * Adds a button (or buttons). See {@link Ext.Button} for more info on the config.\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @param {Object/Array} config A button config or array of configs\r
-     * @return {Ext.Button/Array}\r
-     */\r
-    addButton : function(config){\r
-        if(Ext.isArray(config)){\r
-            var buttons = [];\r
-            for(var i = 0, len = config.length; i < len; i++) {\r
-                buttons.push(this.addButton(config[i]));\r
-            }\r
-            return buttons;\r
-        }\r
-        return this.add(this.constructButton(config));\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addText"></div>/**\r
-     * Adds text to the toolbar\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @param {String} text The text to add\r
-     * @return {Ext.Toolbar.Item} The element's item\r
-     */\r
-    addText : function(text){\r
-        return this.addItem(new T.TextItem(text));\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addDom"></div>/**\r
-     * Adds a new element to the toolbar from the passed {@link Ext.DomHelper} config\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @param {Object} config\r
-     * @return {Ext.Toolbar.Item} The element's item\r
-     */\r
-    addDom : function(config){\r
-        return this.add(new T.Item({autoEl: config}));\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-addField"></div>/**\r
-     * Adds a dynamically rendered Ext.form field (TextField, ComboBox, etc). Note: the field should not have\r
-     * been rendered yet. For a field that has already been rendered, use {@link #addElement}.\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @param {Ext.form.Field} field\r
-     * @return {Ext.Toolbar.Item}\r
-     */\r
-    addField : function(field){\r
-        return this.add(field);\r
-    },\r
-\r
-    <div id="method-Ext.Toolbar-insertButton"></div>/**\r
-     * Inserts any {@link Ext.Toolbar.Item}/{@link Ext.Button} at the specified index.\r
-     * <br><p><b>Note</b>: See the notes within {@link Ext.Container#add}.</p>\r
-     * @param {Number} index The index where the item is to be inserted\r
-     * @param {Object/Ext.Toolbar.Item/Ext.Button/Array} item The button, or button config object to be\r
-     * inserted, or an array of buttons/configs.\r
-     * @return {Ext.Button/Item}\r
-     */\r
-    insertButton : function(index, item){\r
-        if(Ext.isArray(item)){\r
-            var buttons = [];\r
-            for(var i = 0, len = item.length; i < len; i++) {\r
-               buttons.push(this.insertButton(index + i, item[i]));\r
-            }\r
-            return buttons;\r
-        }\r
-        return Ext.Toolbar.superclass.insert.call(this, index, item);\r
-    },\r
-\r
-    // private\r
-    initMenuTracking : function(item){\r
-        if(this.trackMenus && item.menu){\r
-            this.mon(item, {\r
-                'menutriggerover' : this.onButtonTriggerOver,\r
-                'menushow' : this.onButtonMenuShow,\r
-                'menuhide' : this.onButtonMenuHide,\r
-                scope: this\r
-            });\r
-        }\r
-    },\r
-\r
-    // private\r
-    constructButton : function(item){\r
-        var b = item.events ? item : this.constructItem(item, item.split ? 'splitbutton' : this.defaultType);\r
-        this.initMenuTracking(b);\r
-        return b;\r
-    },\r
-\r
-    // private\r
-    onDisable : function(){\r
-        this.items.each(function(item){\r
-             if(item.disable){\r
-                 item.disable();\r
-             }\r
-        });\r
-    },\r
-\r
-    // private\r
-    onEnable : function(){\r
-        this.items.each(function(item){\r
-             if(item.enable){\r
-                 item.enable();\r
-             }\r
-        });\r
-    },\r
-\r
-    // private\r
-    onButtonTriggerOver : function(btn){\r
-        if(this.activeMenuBtn && this.activeMenuBtn != btn){\r
-            this.activeMenuBtn.hideMenu();\r
-            btn.showMenu();\r
-            this.activeMenuBtn = btn;\r
-        }\r
-    },\r
-\r
-    // private\r
-    onButtonMenuShow : function(btn){\r
-        this.activeMenuBtn = btn;\r
-    },\r
-\r
-    // private\r
-    onButtonMenuHide : function(btn){\r
-        delete this.activeMenuBtn;\r
-    }\r
-});\r
-Ext.reg('toolbar', Ext.Toolbar);\r
-\r
-<div id="cls-Ext.Toolbar.Item"></div>/**\r
- * @class Ext.Toolbar.Item\r
- * @extends Ext.BoxComponent\r
- * The base class that other non-interacting Toolbar Item classes should extend in order to\r
- * get some basic common toolbar item functionality.\r
- * @constructor\r
- * Creates a new Item\r
- * @param {HTMLElement} el\r
- * @xtype tbitem\r
- */\r
-T.Item = Ext.extend(Ext.BoxComponent, {\r
-    hideParent: true, //  Hiding a Toolbar.Item hides its containing TD\r
-    enable:Ext.emptyFn,\r
-    disable:Ext.emptyFn,\r
-    focus:Ext.emptyFn\r
-    <div id="cfg-Ext.Toolbar.Item-overflowText"></div>/**\r
-     * @cfg {String} overflowText Text to be used for the menu if the item is overflowed.\r
-     */\r
-});\r
-Ext.reg('tbitem', T.Item);\r
-\r
-<div id="cls-Ext.Toolbar.Separator"></div>/**\r
- * @class Ext.Toolbar.Separator\r
- * @extends Ext.Toolbar.Item\r
- * A simple class that adds a vertical separator bar between toolbar items\r
- * (css class:<tt>'xtb-sep'</tt>). Example usage:\r
- * <pre><code>\r
-new Ext.Panel({\r
-    tbar : [\r
-        'Item 1',\r
-        {xtype: 'tbseparator'}, // or '-'\r
-        'Item 2'\r
-    ]\r
-});\r
-</code></pre>\r
- * @constructor\r
- * Creates a new Separator\r
- * @xtype tbseparator\r
- */\r
-T.Separator = Ext.extend(T.Item, {\r
-    onRender : function(ct, position){\r
-        this.el = ct.createChild({tag:'span', cls:'xtb-sep'}, position);\r
-    }\r
-});\r
-Ext.reg('tbseparator', T.Separator);\r
-\r
-<div id="cls-Ext.Toolbar.Spacer"></div>/**\r
- * @class Ext.Toolbar.Spacer\r
- * @extends Ext.Toolbar.Item\r
- * A simple element that adds extra horizontal space between items in a toolbar.\r
- * By default a 2px wide space is added via css specification:<pre><code>\r
-.x-toolbar .xtb-spacer {\r
-    width:2px;\r
-}\r
- * </code></pre>\r
- * <p>Example usage:</p>\r
- * <pre><code>\r
-new Ext.Panel({\r
-    tbar : [\r
-        'Item 1',\r
-        {xtype: 'tbspacer'}, // or ' '\r
-        'Item 2',\r
-        // space width is also configurable via javascript\r
-        {xtype: 'tbspacer', width: 50}, // add a 50px space\r
-        'Item 3'\r
-    ]\r
-});\r
-</code></pre>\r
- * @constructor\r
- * Creates a new Spacer\r
- * @xtype tbspacer\r
- */\r
-T.Spacer = Ext.extend(T.Item, {\r
-    <div id="cfg-Ext.Toolbar.Spacer-width"></div>/**\r
-     * @cfg {Number} width\r
-     * The width of the spacer in pixels (defaults to 2px via css style <tt>.x-toolbar .xtb-spacer</tt>).\r
-     */\r
-\r
-    onRender : function(ct, position){\r
-        this.el = ct.createChild({tag:'div', cls:'xtb-spacer', style: this.width?'width:'+this.width+'px':''}, position);\r
-    }\r
-});\r
-Ext.reg('tbspacer', T.Spacer);\r
-\r
-<div id="cls-Ext.Toolbar.Fill"></div>/**\r
- * @class Ext.Toolbar.Fill\r
- * @extends Ext.Toolbar.Spacer\r
- * A non-rendering placeholder item which instructs the Toolbar's Layout to begin using\r
- * the right-justified button container.\r
- * <pre><code>\r
-new Ext.Panel({\r
-    tbar : [\r
-        'Item 1',\r
-        {xtype: 'tbfill'}, // or '->'\r
-        'Item 2'\r
-    ]\r
-});\r
-</code></pre>\r
- * @constructor\r
- * Creates a new Fill\r
- * @xtype tbfill\r
- */\r
-T.Fill = Ext.extend(T.Item, {\r
-    // private\r
-    render : Ext.emptyFn,\r
-    isFill : true\r
-});\r
-Ext.reg('tbfill', T.Fill);\r
-\r
-<div id="cls-Ext.Toolbar.TextItem"></div>/**\r
- * @class Ext.Toolbar.TextItem\r
- * @extends Ext.Toolbar.Item\r
- * A simple class that renders text directly into a toolbar\r
- * (with css class:<tt>'xtb-text'</tt>). Example usage:\r
- * <pre><code>\r
-new Ext.Panel({\r
-    tbar : [\r
-        {xtype: 'tbtext', text: 'Item 1'} // or simply 'Item 1'\r
-    ]\r
-});\r
-</code></pre>\r
- * @constructor\r
- * Creates a new TextItem\r
- * @param {String/Object} text A text string, or a config object containing a <tt>text</tt> property\r
- * @xtype tbtext\r
- */\r
-T.TextItem = Ext.extend(T.Item, {\r
-    <div id="cfg-Ext.Toolbar.TextItem-text"></div>/**\r
-     * @cfg {String} text The text to be used as innerHTML (html tags are accepted)\r
-     */ \r
-\r
-    constructor: function(config){\r
-        T.TextItem.superclass.constructor.call(this, Ext.isString(config) ? {text: config} : config);\r
-    },\r
-    \r
-    // private\r
-    onRender : function(ct, position) {\r
-        this.autoEl = {cls: 'xtb-text', html: this.text || ''};\r
-        T.TextItem.superclass.onRender.call(this, ct, position);\r
-    },\r
-    \r
-    <div id="method-Ext.Toolbar.TextItem-setText"></div>/**\r
-     * Updates this item's text, setting the text to be used as innerHTML.\r
-     * @param {String} t The text to display (html accepted).\r
-     */\r
-    setText : function(t) {\r
-        if(this.rendered){\r
-            this.el.update(t);\r
-        }else{\r
-            this.text = t;\r
-        }\r
-    }\r
-});\r
-Ext.reg('tbtext', T.TextItem);\r
-\r
-// backwards compat\r
-T.Button = Ext.extend(Ext.Button, {});\r
-T.SplitButton = Ext.extend(Ext.SplitButton, {});\r
-Ext.reg('tbbutton', T.Button);\r
-Ext.reg('tbsplit', T.SplitButton);\r
-\r
-})();\r
-</pre>
+Ext.define('Ext.toolbar.Toolbar', {
+    extend: 'Ext.container.Container',
+    requires: [
+        'Ext.toolbar.Fill',
+        'Ext.layout.container.HBox',
+        'Ext.layout.container.VBox',
+        'Ext.FocusManager'
+    ],
+    uses: [
+        'Ext.toolbar.Separator'
+    ],
+    alias: 'widget.toolbar',
+    alternateClassName: 'Ext.Toolbar',
+    
+    isToolbar: true,
+    baseCls  : Ext.baseCSSPrefix + 'toolbar',
+    ariaRole : 'toolbar',
+    
+    defaultType: 'button',
+    
+<span id='Ext-toolbar-Toolbar-cfg-vertical'>    /**
+</span>     * @cfg {Boolean} vertical
+     * Set to `true` to make the toolbar vertical. The layout will become a `vbox`.
+     * (defaults to `false`)
+     */
+    vertical: false,
+
+<span id='Ext-toolbar-Toolbar-cfg-layout'>    /**
+</span>     * @cfg {String/Object} layout
+     * This class assigns a default layout (&lt;code&gt;layout:'&lt;b&gt;hbox&lt;/b&gt;'&lt;/code&gt;).
+     * Developers &lt;i&gt;may&lt;/i&gt; override this configuration option if another layout
+     * is required (the constructor must be passed a configuration object in this
+     * case instead of an array).
+     * See {@link Ext.container.Container#layout} for additional information.
+     */
+
+<span id='Ext-toolbar-Toolbar-cfg-enableOverflow'>    /**
+</span>     * @cfg {Boolean} enableOverflow
+     * Defaults to false. Configure &lt;code&gt;true&lt;/code&gt; to make the toolbar provide a button
+     * which activates a dropdown Menu to show items which overflow the Toolbar's width.
+     */
+    enableOverflow: false,
+    
+    // private
+    trackMenus: true,
+    
+    itemCls: Ext.baseCSSPrefix + 'toolbar-item',
+    
+    initComponent: function() {
+        var me = this,
+            keys;
+
+        // check for simplified (old-style) overflow config:
+        if (!me.layout &amp;&amp; me.enableOverflow) {
+            me.layout = { overflowHandler: 'Menu' };
+        }
+        
+        if (me.dock === 'right' || me.dock === 'left') {
+            me.vertical = true;
+        }
+
+        me.layout = Ext.applyIf(Ext.isString(me.layout) ? {
+            type: me.layout
+        } : me.layout || {}, {
+            type: me.vertical ? 'vbox' : 'hbox',
+            align: me.vertical ? 'stretchmax' : 'middle'
+        });
+        
+        if (me.vertical) {
+            me.addClsWithUI('vertical');
+        }
+        
+        // @TODO: remove this hack and implement a more general solution
+        if (me.ui === 'footer') {
+            me.ignoreBorderManagement = true;
+        }
+        
+        me.callParent();
+
+<span id='Ext-toolbar-Toolbar-event-overflowchange'>        /**
+</span>         * @event overflowchange
+         * Fires after the overflow state has changed.
+         * @param {Object} c The Container
+         * @param {Boolean} lastOverflow overflow state
+         */
+        me.addEvents('overflowchange');
+        
+        // Subscribe to Ext.FocusManager for key navigation
+        keys = me.vertical ? ['up', 'down'] : ['left', 'right'];
+        Ext.FocusManager.subscribe(me, {
+            keys: keys
+        });
+    },
+
+<span id='Ext-toolbar-Toolbar-method-add'>    /**
+</span>     * &lt;p&gt;Adds element(s) to the toolbar -- this function takes a variable number of
+     * arguments of mixed type and adds them to the toolbar.&lt;/p&gt;
+     * &lt;br&gt;&lt;p&gt;&lt;b&gt;Note&lt;/b&gt;: See the notes within {@link Ext.container.Container#add}.&lt;/p&gt;
+     * @param {Mixed} arg1 The following types of arguments are all valid:&lt;br /&gt;
+     * &lt;ul&gt;
+     * &lt;li&gt;{@link Ext.button.Button} config: A valid button config object (equivalent to {@link #addButton})&lt;/li&gt;
+     * &lt;li&gt;HtmlElement: Any standard HTML element (equivalent to {@link #addElement})&lt;/li&gt;
+     * &lt;li&gt;Field: Any form field (equivalent to {@link #addField})&lt;/li&gt;
+     * &lt;li&gt;Item: Any subclass of {@link Ext.toolbar.Item} (equivalent to {@link #addItem})&lt;/li&gt;
+     * &lt;li&gt;String: Any generic string (gets wrapped in a {@link Ext.toolbar.TextItem}, equivalent to {@link #addText}).
+     * Note that there are a few special strings that are treated differently as explained next.&lt;/li&gt;
+     * &lt;li&gt;'-': Creates a separator element (equivalent to {@link #addSeparator})&lt;/li&gt;
+     * &lt;li&gt;' ': Creates a spacer element (equivalent to {@link #addSpacer})&lt;/li&gt;
+     * &lt;li&gt;'-&gt;': Creates a fill element (equivalent to {@link #addFill})&lt;/li&gt;
+     * &lt;/ul&gt;
+     * @param {Mixed} arg2
+     * @param {Mixed} etc.
+     * @method add
+     */
+
+    // private
+    lookupComponent: function(c) {
+        if (Ext.isString(c)) {
+            var shortcut = Ext.toolbar.Toolbar.shortcuts[c];
+            if (shortcut) {
+                c = {
+                    xtype: shortcut
+                };
+            } else {
+                c = {
+                    xtype: 'tbtext',
+                    text: c
+                };
+            }
+            this.applyDefaults(c);
+        }
+        return this.callParent(arguments);
+    },
+
+    // private
+    applyDefaults: function(c) {
+        if (!Ext.isString(c)) {
+            c = this.callParent(arguments);
+            var d = this.internalDefaults;
+            if (c.events) {
+                Ext.applyIf(c.initialConfig, d);
+                Ext.apply(c, d);
+            } else {
+                Ext.applyIf(c, d);
+            }
+        }
+        return c;
+    },
+
+    // private
+    trackMenu: function(item, remove) {
+        if (this.trackMenus &amp;&amp; item.menu) {
+            var method = remove ? 'mun' : 'mon',
+                me = this;
+
+            me[method](item, 'menutriggerover', me.onButtonTriggerOver, me);
+            me[method](item, 'menushow', me.onButtonMenuShow, me);
+            me[method](item, 'menuhide', me.onButtonMenuHide, me);
+        }
+    },
+
+    // private
+    constructButton: function(item) {
+        return item.events ? item : this.createComponent(item, item.split ? 'splitbutton' : this.defaultType);
+    },
+
+    // private
+    onBeforeAdd: function(component) {
+        if (component.is('field') || (component.is('button') &amp;&amp; this.ui != 'footer')) {
+            component.ui = component.ui + '-toolbar';
+        }
+        
+        // Any separators needs to know if is vertical or not
+        if (component instanceof Ext.toolbar.Separator) {
+            component.setUI((this.vertical) ? 'vertical' : 'horizontal');
+        }
+        
+        this.callParent(arguments);
+    },
+
+    // private
+    onAdd: function(component) {
+        this.callParent(arguments);
+
+        this.trackMenu(component);
+        if (this.disabled) {
+            component.disable();
+        }
+    },
+
+    // private
+    onRemove: function(c) {
+        this.callParent(arguments);
+        this.trackMenu(c, true);
+    },
+
+    // private
+    onButtonTriggerOver: function(btn){
+        if (this.activeMenuBtn &amp;&amp; this.activeMenuBtn != btn) {
+            this.activeMenuBtn.hideMenu();
+            btn.showMenu();
+            this.activeMenuBtn = btn;
+        }
+    },
+
+    // private
+    onButtonMenuShow: function(btn) {
+        this.activeMenuBtn = btn;
+    },
+
+    // private
+    onButtonMenuHide: function(btn) {
+        delete this.activeMenuBtn;
+    }
+}, function() {
+    this.shortcuts = {
+        '-' : 'tbseparator',
+        ' ' : 'tbspacer',
+        '-&gt;': 'tbfill'
+    };
+});</pre>
 </body>
 </body>
-</html>
\ No newline at end of file
+</html>