/javascripts/lib/docs/output/Ext.Toolbar.html
HTML | 1288 lines | 1277 code | 11 blank | 0 comment | 0 complexity | 382700d2eef7abea85f67b5cfbd64dfe MD5 | raw file
Possible License(s): GPL-3.0
Large files files are truncated, but you can click here to view the full file
1<div class="body-wrap" xmlns:ext="http://www.extjs.com"><div class="top-tools"><a class="inner-link" href="#Ext.Toolbar-props"><img src="../resources/images/default/s.gif" class="item-icon icon-prop">Properties</a> <a class="inner-link" href="#Ext.Toolbar-methods"><img src="../resources/images/default/s.gif" class="item-icon icon-method">Methods</a> <a class="inner-link" href="#Ext.Toolbar-events"><img src="../resources/images/default/s.gif" class="item-icon icon-event">Events</a> <a class="inner-link" href="#Ext.Toolbar-configs"><img src="../resources/images/default/s.gif" class="item-icon icon-config">Config Options</a> <a class="bookmark" href="../docs/?class=Ext.Toolbar"><img src="../resources/images/default/s.gif" class="item-icon icon-fav">Direct Link</a> </div><div class="inheritance res-block"><pre class="res-block-inner"><a href="output/Ext.util.Observable.html" ext:member="" ext:cls="Ext.util.Observable">Observable</a> <img src="resources/elbow-end.gif"><a href="output/Ext.Component.html" ext:member="" ext:cls="Ext.Component">Component</a> <img src="resources/elbow-end.gif"><a href="output/Ext.BoxComponent.html" ext:member="" ext:cls="Ext.BoxComponent">BoxComponent</a> <img src="resources/elbow-end.gif"><a href="output/Ext.Container.html" ext:member="" ext:cls="Ext.Container">Container</a> <img src="resources/elbow-end.gif">Toolbar</pre></div><h1>Class <a href="source/Toolbar.html#cls-Ext.Toolbar">Ext.Toolbar</a></h1><table cellspacing="0"><tr><td class="label">Package:</td><td class="hd-info">Ext</td></tr><tr><td class="label">Defined In:</td><td class="hd-info"><a href="source/Toolbar.html#cls-Ext.Toolbar">Toolbar.js</a></td></tr><tr><td class="label">Class:</td><td class="hd-info"><a href="source/Toolbar.html#cls-Ext.Toolbar">Toolbar</a></td></tr><tr><td class="label">Subclasses:</td><td class="hd-info"><a href="output/Ext.PagingToolbar.html" ext:cls="Ext.PagingToolbar">PagingToolbar</a></td></tr><tr><td class="label">Extends:</td><td class="hd-info"><a href="output/Ext.Container.html" ext:cls="Ext.Container" ext:member="">Container</a></td></tr></table><div class="description"><p>Basic Toolbar class. Although the <tt><a href="output/Ext.Container.html#Ext.Container-defaultType" ext:member="defaultType" ext:cls="Ext.Container">defaultType</a></tt> for Toolbar 2is <tt><a href="output/Ext.Button.html" ext:cls="Ext.Button">button</a></tt>, Toolbar elements (child items for the Toolbar container) may 3be virtually any type of Component. Toolbar elements can be created explicitly via their constructors, 4or implicitly via their xtypes, and can be <tt><a href="output/Ext.Toolbar.html#Ext.Toolbar-add" ext:member="add" ext:cls="Ext.Toolbar">add</a></tt>ed dynamically.</p> 5<p>Some items have shortcut strings for creation:</p> 6<pre> 7<u>Shortcut</u> <u>xtype</u> <u>Class</u> <u>Description</u> 8'->' 'tbfill' <a href="output/Ext.Toolbar.Fill.html" ext:cls="Ext.Toolbar.Fill">Ext.Toolbar.Fill</a> begin using the right-justified button container 9'-' 'tbseparator' <a href="output/Ext.Toolbar.Separator.html" ext:cls="Ext.Toolbar.Separator">Ext.Toolbar.Separator</a> add a vertical separator bar between toolbar items 10' ' 'tbspacer' <a href="output/Ext.Toolbar.Spacer.html" ext:cls="Ext.Toolbar.Spacer">Ext.Toolbar.Spacer</a> add horiztonal space between elements 11</pre> 12Example usage of various elements: 13<pre><code><b>var</b> tb = <b>new</b> Ext.Toolbar({ 14 renderTo: document.body, 15 width: 600, 16 height: 100, 17 items: [ 18 { 19 <i>// xtype: <em>'button'</em>, // <b>default</b> <b>for</b> Toolbars, same as <em>'tbbutton'</em></i> 20 text: <em>'Button'</em> 21 }, 22 { 23 xtype: <em>'splitbutton'</em>, <i>// same as <em>'tbsplitbutton'</em></i> 24 text: <em>'Split Button'</em> 25 }, 26 <i>// begin using the right-justified button container</i> 27 <em>'->'</em>, <i>// same as {xtype: <em>'tbfill'</em>}, // Ext.Toolbar.Fill</i> 28 { 29 xtype: <em>'textfield'</em>, 30 name: <em>'field1'</em>, 31 emptyText: <em>'enter search term'</em> 32 }, 33 <i>// add a vertical separator bar between toolbar items</i> 34 <em>'-'</em>, <i>// same as {xtype: <em>'tbseparator'</em>} to create Ext.Toolbar.Separator</i> 35 <em>'text 1'</em>, <i>// same as {xtype: <em>'tbtext'</em>, text: <em>'text1'</em>} to create Ext.Toolbar.TextItem</i> 36 {xtype: <em>'tbspacer'</em>},<i>// same as <em>' '</em> to create Ext.Toolbar.Spacer</i> 37 <em>'text 2'</em>, 38 {xtype: <em>'tbspacer'</em>, width: 50}, <i>// add a 50px space</i> 39 <em>'text 3'</em> 40 ] 41});</code></pre> 42Example adding a ComboBox within a menu of a button: 43<pre><code><i>// ComboBox creation</i> 44<b>var</b> combo = <b>new</b> Ext.form.ComboBox({ 45 store: <b>new</b> Ext.data.ArrayStore({ 46 autoDestroy: true, 47 fields: [<em>'initials'</em>, <em>'fullname'</em>], 48 data : [ 49 [<em>'FF'</em>, <em>'Fred Flintstone'</em>], 50 [<em>'BR'</em>, <em>'Barney Rubble'</em>] 51 ] 52 }), 53 displayField: <em>'fullname'</em>, 54 typeAhead: true, 55 mode: <em>'local'</em>, 56 forceSelection: true, 57 triggerAction: <em>'all'</em>, 58 emptyText: <em>'Select a name...'</em>, 59 selectOnFocus: true, 60 width: 135, 61 getListParent: <b>function</b>() { 62 <b>return</b> this.el.up(<em>'.x-menu'</em>); 63 }, 64 iconCls: <em>'no-icon'</em> <i>//use iconCls <b>if</b> placing within menu to shift to right side of menu</i> 65}); 66 67<i>// put ComboBox <b>in</b> a Menu</i> 68<b>var</b> menu = <b>new</b> Ext.menu.Menu({ 69 id: <em>'mainMenu'</em>, 70 items: [ 71 combo <i>// A Field <b>in</b> a Menu</i> 72 ] 73}); 74 75<i>// add a Button <b>with</b> the menu</i> 76tb.add({ 77 text:<em>'Button w/ Menu'</em>, 78 menu: menu <i>// assign menu by instance</i> 79 }); 80tb.doLayout();</code></pre></div><div class="hr"></div><a id="Ext.Toolbar-configs"></a><h2>Config Options</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Config Options</th><th class="msource-header">Defined By</th></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Container-activeItem"></a><b><a href="source/Container.html#cfg-Ext.Container-activeItem">activeItem</a></b> : String/Number<div class="mdesc"><div class="short">A string component id or the numeric index of the component that should be initially activated within the 81container's...</div><div class="long">A string component id or the numeric index of the component that should be initially activated within the 82container's layout on render. For example, activeItem: 'item-1' or activeItem: 0 (index 0 = the first 83item in the container's collection). activeItem only applies to layout styles that can display 84items one at a time (like <a href="output/Ext.layout.AccordionLayout.html" ext:cls="Ext.layout.AccordionLayout">Ext.layout.AccordionLayout</a>, <a href="output/Ext.layout.CardLayout.html" ext:cls="Ext.layout.CardLayout">Ext.layout.CardLayout</a> and 85<a href="output/Ext.layout.FitLayout.html" ext:cls="Ext.layout.FitLayout">Ext.layout.FitLayout</a>). Related to <a href="output/Ext.layout.ContainerLayout.html#Ext.layout.ContainerLayout-activeItem" ext:member="activeItem" ext:cls="Ext.layout.ContainerLayout">Ext.layout.ContainerLayout.activeItem</a>.</div></div></td><td class="msource"><a href="output/Ext.Container.html#activeItem" ext:member="#activeItem" ext:cls="Ext.Container">Container</a></td></tr><tr class="config-row inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-allowDomMove"></a><b><a href="source/Component.html#cfg-Ext.Component-allowDomMove">allowDomMove</a></b> : Boolean<div class="mdesc">Whether the component can move the Dom node when rendering (defaults to true).</div></td><td class="msource"><a href="output/Ext.Component.html#allowDomMove" ext:member="#allowDomMove" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-anchor"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-anchor">anchor</a></b> : String<div class="mdesc"><div class="short">Note: this config is only used when this Component is rendered 86by a Container which has been configured to use an Anc...</div><div class="long"><p><b>Note</b>: this config is only used when this Component is rendered 87by a Container which has been configured to use an <b><a href="output/Ext.layout.AnchorLayout.html" ext:cls="Ext.layout.AnchorLayout">AnchorLayout</a> (or subclass thereof).</b> 88based layout manager, for example:<div class="mdetail-params"><ul> 89<li><a href="output/Ext.form.FormPanel.html" ext:cls="Ext.form.FormPanel">Ext.form.FormPanel</a></li> 90<li>specifying <code>layout: <em>'anchor'</em> <i>// or <em>'form'</em>, or <em>'absolute'</em></i></code></li> 91</ul></div></p> 92<p>See <a href="output/Ext.layout.AnchorLayout.html" ext:cls="Ext.layout.AnchorLayout">Ext.layout.AnchorLayout</a>.<a href="output/Ext.layout.AnchorLayout.html#Ext.layout.AnchorLayout-anchor" ext:member="anchor" ext:cls="Ext.layout.AnchorLayout">anchor</a> also.</p></div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#anchor" ext:member="#anchor" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-applyTo"></a><b><a href="source/Component.html#cfg-Ext.Component-applyTo">applyTo</a></b> : Mixed<div class="mdesc"><div class="short">Specify the id of the element, a DOM element or an existing Element corresponding to a DIV 93that is already present in...</div><div class="long"><p>Specify the id of the element, a DOM element or an existing Element corresponding to a DIV 94that is already present in the document that specifies some structural markup for this 95component.</p><div><ul> 96<li><b>Description</b> : <ul> 97<div class="sub-desc">When <tt>applyTo</tt> is used, constituent parts of the component can also be specified 98by id or CSS class name within the main element, and the component being created may attempt 99to create its subcomponents from that markup if applicable.</div> 100</ul></li> 101<li><b>Notes</b> : <ul> 102<div class="sub-desc">When using this config, a call to render() is not required.</div> 103<div class="sub-desc">If applyTo is specified, any value passed for <a href="output/Ext.Component.html#Ext.Component-renderTo" ext:member="renderTo" ext:cls="Ext.Component">renderTo</a> will be ignored and the target 104element's parent node will automatically be used as the component's container.</div> 105</ul></li> 106</ul></div></div></div></td><td class="msource"><a href="output/Ext.Component.html#applyTo" ext:member="#applyTo" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Container-autoDestroy"></a><b><a href="source/Container.html#cfg-Ext.Container-autoDestroy">autoDestroy</a></b> : Boolean<div class="mdesc"><div class="short">If true the container will automatically destroy any contained component that is removed from it, else 107destruction mu...</div><div class="long">If true the container will automatically destroy any contained component that is removed from it, else 108destruction must be handled manually (defaults to true).</div></div></td><td class="msource"><a href="output/Ext.Container.html#autoDestroy" ext:member="#autoDestroy" ext:cls="Ext.Container">Container</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-autoEl"></a><b><a href="source/Component.html#cfg-Ext.Component-autoEl">autoEl</a></b> : Mixed<div class="mdesc"><div class="short">A tag name or DomHelper spec used to create the Element which will 109encapsulate this Component. 110You do not normally ne...</div><div class="long"><p>A tag name or <a href="output/Ext.DomHelper.html" ext:cls="Ext.DomHelper">DomHelper</a> spec used to create the <a href="output/Ext.Component.html#Ext.Component-getEl" ext:member="getEl" ext:cls="Ext.Component">Element</a> which will 111encapsulate this Component.</p> 112<p>You do not normally need to specify this. For the base classes <a href="output/Ext.Component.html" ext:cls="Ext.Component">Ext.Component</a>, <a href="output/Ext.BoxComponent.html" ext:cls="Ext.BoxComponent">Ext.BoxComponent</a>, 113and <a href="output/Ext.Container.html" ext:cls="Ext.Container">Ext.Container</a>, this defaults to <b><tt>'div'</tt></b>. The more complex Ext classes use a more complex 114DOM structure created by their own onRender methods.</p> 115<p>This is intended to allow the developer to create application-specific utility Components encapsulated by 116different DOM elements. Example usage:</p><pre><code>{ 117 xtype: <em>'box'</em>, 118 autoEl: { 119 tag: <em>'img'</em>, 120 src: <em>'http:<i>//www.example.com/example.jpg'</em></i> 121 } 122}, { 123 xtype: <em>'box'</em>, 124 autoEl: { 125 tag: <em>'blockquote'</em>, 126 html: <em>'autoEl is cool!'</em> 127 } 128}, { 129 xtype: <em>'container'</em>, 130 autoEl: <em>'ul'</em>, 131 cls: <em>'ux-unordered-list'</em>, 132 items: { 133 xtype: <em>'box'</em>, 134 autoEl: <em>'li'</em>, 135 html: <em>'First list item'</em> 136 } 137}</code></pre></div></div></td><td class="msource"><a href="output/Ext.Component.html#autoEl" ext:member="#autoEl" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-autoHeight"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-autoHeight">autoHeight</a></b> : Boolean<div class="mdesc"><div class="short">True to use height:'auto', false to use fixed height (or allow it to be managed by its parent 138Container's layout mana...</div><div class="long"><p>True to use height:'auto', false to use fixed height (or allow it to be managed by its parent 139Container's <a href="output/Ext.Container.html#Ext.Container-layout" ext:member="layout" ext:cls="Ext.Container">layout manager</a>. Defaults to false.</p> 140<p><b>Note</b>: Although many components inherit this config option, not all will 141function as expected with a height of 'auto'. Setting autoHeight:true means that the 142browser will manage height based on the element's contents, and that Ext will not manage it at all.</p> 143<p>If the <i>browser</i> is managing the height, be aware that resizes performed by the browser in response 144to changes within the structure of the Component cannot be detected. Therefore changes to the height might 145result in elements needing to be synchronized with the new height. Example:</p><pre><code><b>var</b> w = <b>new</b> Ext.Window({ 146 title: <em>'Window'</em>, 147 width: 600, 148 autoHeight: true, 149 items: { 150 title: <em>'Collapse Me'</em>, 151 height: 400, 152 collapsible: true, 153 border: false, 154 listeners: { 155 beforecollapse: <b>function</b>() { 156 w.el.shadow.hide(); 157 }, 158 beforeexpand: <b>function</b>() { 159 w.el.shadow.hide(); 160 }, 161 collapse: <b>function</b>() { 162 w.syncShadow(); 163 }, 164 expand: <b>function</b>() { 165 w.syncShadow(); 166 } 167 } 168 } 169}).show();</code></pre></div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#autoHeight" ext:member="#autoHeight" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-autoScroll"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-autoScroll">autoScroll</a></b> : Boolean<div class="mdesc"><div class="short">true to use overflow:'auto' on the components layout element and show scroll bars automatically when 170necessary, false...</div><div class="long"><code>true</code> to use overflow:'auto' on the components layout element and show scroll bars automatically when 171necessary, <code>false</code> to clip any overflowing content (defaults to <code>false</code>).</div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#autoScroll" ext:member="#autoScroll" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-autoShow"></a><b><a href="source/Component.html#cfg-Ext.Component-autoShow">autoShow</a></b> : Boolean<div class="mdesc"><div class="short">True if the component should check for hidden classes (e.g. 'x-hidden' or 'x-hide-display') and remove 172them on render...</div><div class="long">True if the component should check for hidden classes (e.g. 'x-hidden' or 'x-hide-display') and remove 173them on render (defaults to false).</div></div></td><td class="msource"><a href="output/Ext.Component.html#autoShow" ext:member="#autoShow" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-autoWidth"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-autoWidth">autoWidth</a></b> : Boolean<div class="mdesc"><div class="short">True to use width:'auto', false to use fixed width (or allow it to be managed by its parent 174Container's layout manage...</div><div class="long"><p>True to use width:'auto', false to use fixed width (or allow it to be managed by its parent 175Container's <a href="output/Ext.Container.html#Ext.Container-layout" ext:member="layout" ext:cls="Ext.Container">layout manager</a>. Defaults to false.</p> 176<p><b>Note</b>: Although many components inherit this config option, not all will 177function as expected with a width of 'auto'. Setting autoWidth:true means that the 178browser will manage width based on the element's contents, and that Ext will not manage it at all.</p> 179<p>If the <i>browser</i> is managing the width, be aware that resizes performed by the browser in response 180to changes within the structure of the Component cannot be detected. Therefore changes to the width might 181result in elements needing to be synchronized with the new width. For example, where the target element is:</p><pre><code><div id=<em>'grid-container'</em> style=<em>'margin-left:25%;width:50%'</em>></div></code></pre> 182A Panel rendered into that target element must listen for browser window resize in order to relay its 183child items when the browser changes its width:<pre><code><b>var</b> myPanel = <b>new</b> Ext.Panel({ 184 renderTo: <em>'grid-container'</em>, 185 monitorResize: true, <i>// relay on browser resize</i> 186 title: <em>'Panel'</em>, 187 height: 400, 188 autoWidth: true, 189 layout: <em>'hbox'</em>, 190 layoutConfig: { 191 align: <em>'stretch'</em> 192 }, 193 defaults: { 194 flex: 1 195 }, 196 items: [{ 197 title: <em>'Box 1'</em>, 198 }, { 199 title: <em>'Box 2'</em> 200 }, { 201 title: <em>'Box 3'</em> 202 }], 203});</code></pre></div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#autoWidth" ext:member="#autoWidth" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-boxMaxHeight"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-boxMaxHeight">boxMaxHeight</a></b> : Number<div class="mdesc"><div class="short">The maximum value in pixels which this BoxComponent will set its height to. 204Warning: This will override any size mana...</div><div class="long"><p>The maximum value in pixels which this BoxComponent will set its height to.</p> 205<p><b>Warning:</b> This will override any size management applied by layout managers.</p></div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#boxMaxHeight" ext:member="#boxMaxHeight" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-boxMaxWidth"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-boxMaxWidth">boxMaxWidth</a></b> : Number<div class="mdesc"><div class="short">The maximum value in pixels which this BoxComponent will set its width to. 206Warning: This will override any size manag...</div><div class="long"><p>The maximum value in pixels which this BoxComponent will set its width to.</p> 207<p><b>Warning:</b> This will override any size management applied by layout managers.</p></div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#boxMaxWidth" ext:member="#boxMaxWidth" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-boxMinHeight"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-boxMinHeight">boxMinHeight</a></b> : Number<div class="mdesc"><div class="short">The minimum value in pixels which this BoxComponent will set its height to. 208Warning: This will override any size mana...</div><div class="long"><p>The minimum value in pixels which this BoxComponent will set its height to.</p> 209<p><b>Warning:</b> This will override any size management applied by layout managers.</p></div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#boxMinHeight" ext:member="#boxMinHeight" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-boxMinWidth"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-boxMinWidth">boxMinWidth</a></b> : Number<div class="mdesc"><div class="short">The minimum value in pixels which this BoxComponent will set its width to. 210Warning: This will override any size manag...</div><div class="long"><p>The minimum value in pixels which this BoxComponent will set its width to.</p> 211<p><b>Warning:</b> This will override any size management applied by layout managers.</p></div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#boxMinWidth" ext:member="#boxMinWidth" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Container-bubbleEvents"></a><b><a href="source/Container.html#cfg-Ext.Container-bubbleEvents">bubbleEvents</a></b> : Array<div class="mdesc"><div class="short">An array of events that, when fired, should be bubbled to any parent container. 212See Ext.util.Observable.enableBubble....</div><div class="long"><p>An array of events that, when fired, should be bubbled to any parent container. 213See <a href="output/Ext.util.Observable.html#Ext.util.Observable-enableBubble" ext:member="enableBubble" ext:cls="Ext.util.Observable">Ext.util.Observable.enableBubble</a>. 214Defaults to <code>[<em>'add'</em>, <em>'remove'</em>]</code>.</div></div></td><td class="msource"><a href="output/Ext.Container.html#bubbleEvents" ext:member="#bubbleEvents" ext:cls="Ext.Container">Container</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Container-bufferResize"></a><b><a href="source/Container.html#cfg-Ext.Container-bufferResize">bufferResize</a></b> : Boolean/Number<div class="mdesc"><div class="short">When set to true (50 milliseconds) or a number of milliseconds, the layout assigned for this container will buffer 215th...</div><div class="long">When set to true (50 milliseconds) or a number of milliseconds, the layout assigned for this container will buffer 216the frequency it calculates and does a re-layout of components. This is useful for heavy containers or containers 217with a large quantity of sub-components for which frequent layout calls would be expensive. Defaults to <code>50</code>.</div></div></td><td class="msource"><a href="output/Ext.Container.html#bufferResize" ext:member="#bufferResize" ext:cls="Ext.Container">Container</a></td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Toolbar-buttonAlign"></a><b><a href="source/Toolbar.html#cfg-Ext.Toolbar-buttonAlign">buttonAlign</a></b> : String<div class="mdesc"><div class="short">The default position at which to align child items. Defaults to "left" 218May be specified as "center" to cause items ad...</div><div class="long"><p>The default position at which to align child items. Defaults to <code><em>"left"</em></code></p> 219<p>May be specified as <code><em>"center"</em></code> to cause items added before a Fill (A <code><em>"->"</em></code>) item 220to be centered in the Toolbar. Items added after a Fill are still right-aligned.</p> 221<p>Specify as <code><em>"right"</em></code> to right align all child items.</p></div></div></td><td class="msource">Toolbar</td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-clearCls"></a><b><a href="source/Component.html#cfg-Ext.Component-clearCls">clearCls</a></b> : String<div class="mdesc"><div class="short">The CSS class used to to apply to the special clearing div rendered 222directly after each form field wrapper to provide...</div><div class="long"><p>The CSS class used to to apply to the special clearing div rendered 223directly after each form field wrapper to provide field clearing (defaults to 224<tt>'x-form-clear-left'</tt>).</p> 225<br><p><b>Note</b>: this config is only used when this Component is rendered by a Container 226which has been configured to use the <b><a href="output/Ext.layout.FormLayout.html" ext:cls="Ext.layout.FormLayout">FormLayout</a></b> layout 227manager (e.g. <a href="output/Ext.form.FormPanel.html" ext:cls="Ext.form.FormPanel">Ext.form.FormPanel</a> or specifying <tt>layout:'form'</tt>) and either a 228<tt><a href="output/Ext.Component.html#Ext.Component-fieldLabel" ext:member="fieldLabel" ext:cls="Ext.Component">fieldLabel</a></tt> is specified or <tt>isFormField=true</tt> is specified.</p><br> 229<p>See <a href="output/Ext.layout.FormLayout.html" ext:cls="Ext.layout.FormLayout">Ext.layout.FormLayout</a>.<a href="output/Ext.layout.FormLayout.html#Ext.layout.FormLayout-fieldTpl" ext:member="fieldTpl" ext:cls="Ext.layout.FormLayout">fieldTpl</a> also.</p></div></div></td><td class="msource"><a href="output/Ext.Component.html#clearCls" ext:member="#clearCls" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-cls"></a><b><a href="source/Component.html#cfg-Ext.Component-cls">cls</a></b> : String<div class="mdesc"><div class="short">An optional extra CSS class that will be added to this component's Element (defaults to ''). This can be 230useful for ...</div><div class="long">An optional extra CSS class that will be added to this component's Element (defaults to ''). This can be 231useful for adding customized styles to the component or any of its children using standard CSS rules.</div></div></td><td class="msource"><a href="output/Ext.Component.html#cls" ext:member="#cls" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-contentEl"></a><b><a href="source/Component.html#cfg-Ext.Component-contentEl">contentEl</a></b> : String<div class="mdesc"><div class="short">Optional. Specify an existing HTML element, or the id of an existing HTML element to use as the content 232for this comp...</div><div class="long"><p>Optional. Specify an existing HTML element, or the <code>id</code> of an existing HTML element to use as the content 233for this component.</p> 234<ul> 235<li><b>Description</b> : 236<div class="sub-desc">This config option is used to take an existing HTML element and place it in the layout element 237of a new component (it simply moves the specified DOM element <i>after the Component is rendered</i> to use as the content.</div></li> 238<li><b>Notes</b> : 239<div class="sub-desc">The specified HTML element is appended to the layout element of the component <i>after any configured 240<a href="output/Ext.Component.html#Ext.Component-html" ext:member="html" ext:cls="Ext.Component">HTML</a> has been inserted</i>, and so the document will not contain this element at the time the <a href="output/Ext.Component.html#Ext.Component-render" ext:member="render" ext:cls="Ext.Component">render</a> event is fired.</div> 241<div class="sub-desc">The specified HTML element used will not participate in any <code><b><a href="output/Ext.Container.html#Ext.Container-layout" ext:member="layout" ext:cls="Ext.Container">layout</a></b></code> 242scheme that the Component may use. It is just HTML. Layouts operate on child <code><b><a href="output/Ext.Container.html#Ext.Container-items" ext:member="items" ext:cls="Ext.Container">items</a></b></code>.</div> 243<div class="sub-desc">Add either the <code>x-hidden</code> or the <code>x-hide-display</code> CSS class to 244prevent a brief flicker of the content before it is rendered to the panel.</div></li> 245</ul></div></div></td><td class="msource"><a href="output/Ext.Component.html#contentEl" ext:member="#contentEl" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-ctCls"></a><b><a href="source/Component.html#cfg-Ext.Component-ctCls">ctCls</a></b> : String<div class="mdesc"><div class="short">An optional extra CSS class that will be added to this component's container. This can be useful for 246adding customize...</div><div class="long"><p>An optional extra CSS class that will be added to this component's container. This can be useful for 247adding customized styles to the container or any of its children using standard CSS rules. See 248<a href="output/Ext.layout.ContainerLayout.html" ext:cls="Ext.layout.ContainerLayout">Ext.layout.ContainerLayout</a>.<a href="output/Ext.layout.ContainerLayout.html#Ext.layout.ContainerLayout-extraCls" ext:member="extraCls" ext:cls="Ext.layout.ContainerLayout">extraCls</a> also.</p> 249<p><b>Note</b>: <tt>ctCls</tt> defaults to <tt>''</tt> except for the following class 250which assigns a value by default: 251<div class="mdetail-params"><ul> 252<li><a href="output/Ext.layout.Box.html" ext:cls="Ext.layout.Box">Box Layout</a> : <tt>'x-box-layout-ct'</tt></li> 253</ul></div> 254To configure the above Class with an extra CSS class append to the default. For example, 255for BoxLayout (Hbox and Vbox):<pre><code>ctCls: <em>'x-box-layout-ct custom-class'</em></code></pre> 256</p></div></div></td><td class="msource"><a href="output/Ext.Component.html#ctCls" ext:member="#ctCls" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-data"></a><b><a href="source/Component.html#cfg-Ext.Component-data">data</a></b> : Mixed<div class="mdesc">The initial set of data to apply to the <code><a href="output/Ext.Component.html#Ext.Component-tpl" ext:member="tpl" ext:cls="Ext.Component">tpl</a></code> to 257update the content area of the Component.</div></td><td class="msource"><a href="output/Ext.Component.html#data" ext:member="#data" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Container-defaultType"></a><b><a href="source/Container.html#cfg-Ext.Container-defaultType">defaultType</a></b> : String<div class="mdesc"><div class="short">The default xtype of child Components to create in this Container when 258a child item is specified as a raw configurati...</div><div class="long"><p>The default <a href="output/Ext.Component.html" ext:cls="Ext.Component">xtype</a> of child Components to create in this Container when 259a child item is specified as a raw configuration object, rather than as an instantiated Component.</p> 260<p>Defaults to <code><em>'panel'</em></code>, except <a href="output/Ext.menu.Menu.html" ext:cls="Ext.menu.Menu">Ext.menu.Menu</a> which defaults to <code><em>'menuitem'</em></code>, 261and <a href="output/Ext.Toolbar.html" ext:cls="Ext.Toolbar">Ext.Toolbar</a> and <a href="output/Ext.ButtonGroup.html" ext:cls="Ext.ButtonGroup">Ext.ButtonGroup</a> which default to <code><em>'button'</em></code>.</p></div></div></td><td class="msource"><a href="output/Ext.Container.html#defaultType" ext:member="#defaultType" ext:cls="Ext.Container">Container</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Container-defaults"></a><b><a href="source/Container.html#cfg-Ext.Container-defaults">defaults</a></b> : Object|Function<div class="mdesc"><div class="short">This option is a means of applying default settings to all added items whether added through the items 262config or via ...</div><div class="long"><p>This option is a means of applying default settings to all added items whether added through the <a href="output/Ext.Container.html#Ext.Container-items" ext:member="items" ext:cls="Ext.Container">items</a> 263config or via the <a href="output/Ext.Container.html#Ext.Container-add" ext:member="add" ext:cls="Ext.Container">add</a> or <a href="output/Ext.Container.html#Ext.Container-insert" ext:member="insert" ext:cls="Ext.Container">insert</a> methods.</p> 264<p>If an added item is a config object, and <b>not</b> an instantiated Component, then the default properties are 265unconditionally applied. If the added item <b>is</b> an instantiated Component, then the default properties are 266applied conditionally so as not to override existing properties in the item.</p> 267<p>If the defaults option is specified as a function, then the function will be called using this Container as the 268scope (<code>this</code> reference) and passing the added item as the first parameter. Any resulting object 269from that call is then applied to the item as default properties.</p> 270<p>For example, to automatically apply padding to the body of each of a set of 271contained <a href="output/Ext.Panel.html" ext:cls="Ext.Panel">Ext.Panel</a> items, you could pass: <code>defaults: {bodyStyle:<em>'padding:15px'</em>}</code>.</p> 272<p>Usage:</p><pre><code>defaults: { <i>// defaults are applied to items, not the container</i> 273 autoScroll:true 274}, 275items: [ 276 { 277 xtype: <em>'panel'</em>, <i>// defaults <b><b>do</b> not</b> have precedence over</i> 278 id: <em>'panel1'</em>, <i>// options <b>in</b> config objects, so the defaults</i> 279 autoScroll: false <i>// will not be applied here, panel1 will be autoScroll:false</i> 280 }, 281 <b>new</b> Ext.Panel({ <i>// defaults <b><b>do</b></b> have precedence over options</i> 282 id: <em>'panel2'</em>, <i>// options <b>in</b> components, so the defaults</i> 283 autoScroll: false <i>// will be applied here, panel2 will be autoScroll:true.</i> 284 }) 285]</code></pre></div></div></td><td class="msource"><a href="output/Ext.Container.html#defaults" ext:member="#defaults" ext:cls="Ext.Container">Container</a></td></tr><tr class="config-row inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-disabled"></a><b><a href="source/Component.html#cfg-Ext.Component-disabled">disabled</a></b> : Boolean<div class="mdesc">Render this component disabled (default is false).</div></td><td class="msource"><a href="output/Ext.Component.html#disabled" ext:member="#disabled" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-disabledClass"></a><b><a href="source/Component.html#cfg-Ext.Component-disabledClass">disabledClass</a></b> : String<div class="mdesc">CSS class added to the component when it is disabled (defaults to 'x-item-disabled').</div></td><td class="msource"><a href="output/Ext.Component.html#disabledClass" ext:member="#disabledClass" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Toolbar-enableOverflow"></a><b><a href="source/Toolbar.html#cfg-Ext.Toolbar-enableOverflow">enableOverflow</a></b> : Boolean<div class="mdesc"><div class="short">Defaults to false. Configure true to make the toolbar provide a button 286which activates a dropdown Menu to show items ...</div><div class="long">Defaults to false. Configure <code>true<code> to make the toolbar provide a button 287which activates a dropdown Menu to show items which overflow the Toolbar<em>'s width.</div></div></td><td class="msource">Toolbar</td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-fieldLabel"></a><b><a href="source/Component.html#cfg-Ext.Component-fieldLabel">fieldLabel</a></b> : String<div class="mdesc"><div class="short">The label text to display next to this Component (defaults to ''). 288Note: this config is only used when this Component...</div><div class="long"><p>The label text to display next to this Component (defaults to '').</p> 289<br><p><b>Note</b>: this config is only used when this Component is rendered by a Container which 290has been configured to use the <b><a href="output/Ext.layout.FormLayout.html" ext:cls="Ext.layout.FormLayout">FormLayout</a></b> layout manager (e.g. 291<a href="output/Ext.form.FormPanel.html" ext:cls="Ext.form.FormPanel">Ext.form.FormPanel</a> or specifying <tt>layout:'form'</tt>).</p><br> 292<p>Also see <tt><a href="output/Ext.Component.html#Ext.Component-hideLabel" ext:member="hideLabel" ext:cls="Ext.Component">hideLabel</a></tt> and 293<a href="output/Ext.layout.FormLayout.html" ext:cls="Ext.layout.FormLayout">Ext.layout.FormLayout</a>.<a href="output/Ext.layout.FormLayout.html#Ext.layout.FormLayout-fieldTpl" ext:member="fieldTpl" ext:cls="Ext.layout.FormLayout">fieldTpl</a>.</p> 294Example use:<pre><code><b>new</b> Ext.FormPanel({ 295 height: 100, 296 renderTo: Ext.getBody(), 297 items: [{ 298 xtype: <em>'textfield'</em>, 299 fieldLabel: <em>'Name'</em> 300 }] 301});</code></pre></div></div></td><td class="msource"><a href="output/Ext.Component.html#fieldLabel" ext:member="#fieldLabel" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-flex"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-flex">flex</a></b> : Number<div class="mdesc"><div class="short">Note: this config is only used when this Component is rendered 302by a Container which has been configured to use a BoxL...</div><div class="long"><p><b>Note</b>: this config is only used when this Component is rendered 303by a Container which has been configured to use a <b><a href="output/Ext.layout.BoxLayout.html" ext:cls="Ext.layout.BoxLayout">BoxLayout</a>.</b> 304Each child Component with a <code>flex</code> property will be flexed either vertically (by a VBoxLayout) 305or horizontally (by an HBoxLayout) according to the item's <b>relative</b> <code>flex</code> value 306compared to the sum of all Components with <code>flex</flex> value specified. Any child items that have 307either a <code>flex = 0</code> or <code>flex = undefined</code> will not be 'flexed' (the initial size will not be changed).</div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#flex" ext:member="#flex" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Container-forceLayout"></a><b><a href="source/Container.html#cfg-Ext.Container-forceLayout">forceLayout</a></b> : Boolean<div class="mdesc"><div class="short">If true the container will force a layout initially even if hidden or collapsed. This option 308is useful for forcing fo...</div><div class="long">If true the container will force a layout initially even if hidden or collapsed. This option 309is useful for forcing forms to render in collapsed or hidden containers. (defaults to false).</div></div></td><td class="msource"><a href="output/Ext.Container.html#forceLayout" ext:member="#forceLayout" ext:cls="Ext.Container">Container</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.BoxComponent-height"></a><b><a href="source/BoxComponent.html#cfg-Ext.BoxComponent-height">height</a></b> : Number<div class="mdesc"><div class="short">The height of this component in pixels (defaults to auto). 310Note to express this dimension as a percentage or offset s...</div><div class="long">The height of this component in pixels (defaults to auto). 311<b>Note</b> to express this dimension as a percentage or offset see <a href="output/Ext.Component.html#Ext.Component-anchor" ext:member="anchor" ext:cls="Ext.Component">Ext.Component.anchor</a>.</div></div></td><td class="msource"><a href="output/Ext.BoxComponent.html#height" ext:member="#height" ext:cls="Ext.BoxComponent">BoxComponent</a></td></tr><tr class="config-row inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-hidden"></a><b><a href="source/Component.html#cfg-Ext.Component-hidden">hidden</a></b> : Boolean<div class="mdesc">Render this component hidden (default is false). If <tt>true</tt>, the 312<a href="output/Ext.Component.html#Ext.Component-hide" ext:member="hide" ext:cls="Ext.Component">hide</a> method will be called internally.</div></td><td class="msource"><a href="output/Ext.Component.html#hidden" ext:member="#hidden" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Container-hideBorders"></a><b><a href="source/Container.html#cfg-Ext.Container-hideBorders">hideBorders</a></b> : Boolean<div class="mdesc"><div class="short">True to hide the borders of each contained component, false to defer to the component's existing 313border settings (def...</div><div class="long">True to hide the borders of each contained component, false to defer to the component's existing 314border settings (defaults to false).</div></div></td><td class="msource"><a href="output/Ext.Container.html#hideBorders" ext:member="#hideBorders" ext:cls="Ext.Container">Container</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-hideLabel"></a><b><a href="source/Component.html#cfg-Ext.Component-hideLabel">hideLabel</a></b> : Boolean<div class="mdesc"><div class="short">true to completely hide the label element 315(label and separator). Defaults to false. 316By default, even if you do not sp...</div><div class="long"><p><tt>true</tt> to completely hide the label element 317(<a href="output/Ext.Component.html#Ext.Component-fieldLabel" ext:member="fieldLabel" ext:cls="Ext.Component">label</a> and <a href="output/Ext.Component.html#Ext.Component-labelSeparator" ext:member="labelSeparator" ext:cls="Ext.Component">separator</a>). Defaults to <tt>false</tt>. 318By default, even if you do not specify a <tt><a href="output/Ext.Component.html#Ext.Component-fieldLabel" ext:member="fieldLabel" ext:cls="Ext.Component">fieldLabel</a></tt> the space will still be 319reserved so that the field will line up with other fields that do have labels. 320Setting this to <tt>true</tt> will cause the field to not reserve that space.</p> 321<br><p><b>Note</b>: see the note for <tt><a href="output/Ext.Component.html#Ext.Component-clearCls" ext:member="clearCls" ext:cls="Ext.Component">clearCls</a></tt>.</p><br> 322Example use:<pre><code><b>new</b> Ext.FormPanel({ 323 height: 100, 324 renderTo: Ext.getBody(), 325 items: [{ 326 xtype: <em>'textfield'</em> 327 hideLabel: true 328 }] 329});</code></pre></div></div></td><td class="msource"><a href="output/Ext.Component.html#hideLabel" ext:member="#hideLabel" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-hideMode"></a><b><a href="source/Component.html#cfg-Ext.Component-hideMode">hideMode</a></b> : String<div class="mdesc"><div class="short">How this component should be hidden. Supported values are 'visibility' 330(css visibility), 'offsets' (negative offset p...</div><div class="long"><p>How this component should be hidden. Supported values are <tt>'visibility'</tt> 331(css visibility), <tt>'offsets'</tt> (negative offset position) and <tt>'display'</tt> 332(css display).</p> 333<br><p><b>Note</b>: the default of <tt>'display'</tt> is generally preferred 334since items are automatically laid out when they are first shown (no sizing 335is done while hidden).</p></div></div></td><td class="msource"><a href="output/Ext.Component.html#hideMode" ext:member="#hideMode" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-hideParent"></a><b><a href="source/Component.html#cfg-Ext.Component-hideParent">hideParent</a></b> : Boolean<div class="mdesc"><div class="short">True to hide and show the component's container when hide/show is called on the component, false to hide 336and show the...</div><div class="long">True to hide and show the component's container when hide/show is called on the component, false to hide 337and show the component itself (defaults to false). For example, this can be used as a shortcut for a hide 338button on a window by setting hide:true on the button when adding it to its parent container.</div></div></td><td class="msource"><a href="output/Ext.Component.html#hideParent" ext:member="#hideParent" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-html"></a><b><a href="source/Component.html#cfg-Ext.Component-html">html</a></b> : String/Object<div class="mdesc"><div class="short">An HTML fragment, or a DomHelper specification to use as the layout element 339content (defaults to ''). The HTML conten...</div><div class="long">An HTML fragment, or a <a href="output/Ext.DomHelper.html" ext:cls="Ext.DomHelper">DomHelper</a> specification to use as the layout element 340content (defaults to ''). The HTML content is added after the component is rendered, 341so the document will not contain this HTML at the time the <a href="output/Ext.Component.html#Ext.Component-render" ext:member="render" ext:cls="Ext.Component">render</a> event is fired. 342This content is inserted into the body <i>before</i> any configured <a href="output/Ext.Component.html#Ext.Component-contentEl" ext:member="contentEl" ext:cls="Ext.Component">contentEl</a> is appended.</div></div></td><td class="msource"><a href="output/Ext.Component.html#html" ext:member="#html" ext:cls="Ext.Component">Component</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext.Component-id"></a><b><a href="source/Component.html#cfg-Ext.Component-id">id</a></b> : String<div class="mdesc"><div class="short">The unique id of this component (defaults to an auto-assigned id). 343You should assign an id if you need to be able to ...</div><div class="long"><p>The <b>unique</b> id of this component (defaults to an <a href="output/Ext.Component.html#Ext.Component-getId" ext:member="getId" ext:cls="Ext.Component">auto-assigned id</a>). 344You should assign an id if you need to be able to access the component later and you do 345not have an object reference available (e.g., using <a href="output/Ext.html" ext:cls="Ext">Ext</a>.<a href="output/Ext.html#Ext-getCmp" ext:member="getCmp" ext:cls="Ext">getCmp</a>).</p> 346<p>Note that this id will also be used as the element id for the containing HTML element 347that is rendered to the page for this component. This allows you to write id-based CSS 348rules to style the specific instance of this component uniquely, and also to select 349sub-elements using this component's id as the parent.</p> 350<p><b>Note</b>: to avoid complications imposed by a unique <tt>id</tt> also see 351<code><a href="output/Ext.Component.html#Ext.Component-itemId" ext:member="itemId" ext:cls="Ext.Component">itemId</a></code> and <code><a href="output/Ext.Component.html#Ext.Component-ref" ext:member="ref" ext:cls="Ext.Component">ref</a></code>.</p> 352<p><b>Note</b>: to access the container of an item see <code><a href="output/Ext.Component.html#Ext.Component-ownerCt" ext:member="ownerCt" ext:cls="Ext.Component">ownerCt</a></code>.</p></div></div></td><td class="msource"><a href="output…
Large files files are truncated, but you can click here to view the full file