X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/6746dc89c47ed01b165cc1152533605f97eb8e8d..f562e4c6e5fac7bcb445985b99acbea4d706e6f0:/docs/source/Bar.html diff --git a/docs/source/Bar.html b/docs/source/Bar.html index 7927cf10..8538cbd9 100644 --- a/docs/source/Bar.html +++ b/docs/source/Bar.html @@ -3,8 +3,8 @@
/** * @author Ed Spencer - * @class Ext.tab.Bar - * @extends Ext.panel.Header - * <p>TabBar is used internally by a {@link Ext.tab.Panel TabPanel} and wouldn't usually need to be created manually.</p> + * TabBar is used internally by a {@link Ext.tab.Panel TabPanel} and typically should not need to be created manually. + * The tab bar automatically removes the default title provided by {@link Ext.panel.Header} */ Ext.define('Ext.tab.Bar', { extend: 'Ext.panel.Header', @@ -31,30 +30,42 @@ Ext.define('Ext.tab.Bar', { 'Ext.FocusManager' ], + isTabBar: true, + + /** + * @cfg {String} title @hide + */ + + /** + * @cfg {String} iconCls @hide + */ + // @private defaultType: 'tab', - /** - * @cfg Boolean plain + /** + * @cfg {Boolean} plain * True to not show the full background on the tabbar */ plain: false, // @private renderTpl: [ - '<div class="{baseCls}-body<tpl if="ui"> {baseCls}-body-{ui}<tpl for="uiCls"> {parent.baseCls}-body-{parent.ui}-{.}</tpl></tpl>"<tpl if="bodyStyle"> style="{bodyStyle}"</tpl>></div>', - '<div class="{baseCls}-strip<tpl if="ui"> {baseCls}-strip-{ui}<tpl for="uiCls"> {parent.baseCls}-strip-{parent.ui}-{.}</tpl></tpl>"></div>' + '<div id="{id}-body" class="{baseCls}-body <tpl if="bodyCls"> {bodyCls}</tpl> <tpl if="ui"> {baseCls}-body-{ui}<tpl for="uiCls"> {parent.baseCls}-body-{parent.ui}-{.}</tpl></tpl>"<tpl if="bodyStyle"> style="{bodyStyle}"</tpl>></div>', + '<div id="{id}-strip" class="{baseCls}-strip<tpl if="ui"> {baseCls}-strip-{ui}<tpl for="uiCls"> {parent.baseCls}-strip-{parent.ui}-{.}</tpl></tpl>"></div>' ], /** - * @cfg {Number} minTabWidth The minimum width for each tab. Defaults to <tt>30</tt>. + * @cfg {Number} minTabWidth + * The minimum width for a tab in this tab Bar. Defaults to the tab Panel's {@link Ext.tab.Panel#minTabWidth minTabWidth} value. + * @deprecated This config is deprecated. It is much easier to use the {@link Ext.tab.Panel#minTabWidth minTabWidth} config on the TabPanel. */ - minTabWidth: 30, /** - * @cfg {Number} maxTabWidth The maximum width for each tab. Defaults to <tt>undefined</tt>. + * @cfg {Number} maxTabWidth + * The maximum width for a tab in this tab Bar. Defaults to the tab Panel's {@link Ext.tab.Panel#maxTabWidth maxTabWidth} value. + * @deprecated This config is deprecated. It is much easier to use the {@link Ext.tab.Panel#maxTabWidth maxTabWidth} config on the TabPanel. */ - maxTabWidth: undefined, // @private initComponent: function() { @@ -64,7 +75,7 @@ Ext.define('Ext.tab.Bar', { if (me.plain) { me.setUI(me.ui + '-plain'); } - + me.addClsWithUI(me.dock); me.addEvents( @@ -72,46 +83,49 @@ Ext.define('Ext.tab.Bar', { * @event change * Fired when the currently-active tab has changed * @param {Ext.tab.Bar} tabBar The TabBar - * @param {Ext.Tab} tab The new Tab + * @param {Ext.tab.Tab} tab The new Tab * @param {Ext.Component} card The card that was just shown in the TabPanel */ 'change' ); - Ext.applyIf(me.renderSelectors, { - body : '.' + me.baseCls + '-body', - strip: '.' + me.baseCls + '-strip' - }); + me.addChildEls('body', 'strip'); me.callParent(arguments); // TabBar must override the Header's align setting. me.layout.align = (me.orientation == 'vertical') ? 'left' : 'top'; me.layout.overflowHandler = Ext.create('Ext.layout.container.boxOverflow.Scroller', me.layout); - me.items.removeAt(me.items.getCount() - 1); - me.items.removeAt(me.items.getCount() - 1); - + + me.remove(me.titleCmp); + delete me.titleCmp; + // Subscribe to Ext.FocusManager for key navigation keys = me.orientation == 'vertical' ? ['up', 'down'] : ['left', 'right']; Ext.FocusManager.subscribe(me, { keys: keys }); + + Ext.apply(me.renderData, { + bodyCls: me.bodyCls + }); }, // @private onAdd: function(tab) { - var me = this, - tabPanel = me.tabPanel, - hasOwner = !!tabPanel; - - me.callParent(arguments); - tab.position = me.dock; - if (hasOwner) { - tab.minWidth = tabPanel.minTabWidth; + tab.position = this.dock; + this.callParent(arguments); + }, + + onRemove: function(tab) { + var me = this; + + if (tab === me.previousTab) { + me.previousTab = null; } - else { - tab.minWidth = me.minTabWidth + (tab.iconCls ? 25 : 0); + if (me.items.getCount() === 0) { + me.activeTab = null; } - tab.maxWidth = me.maxTabWidth || (hasOwner ? tabPanel.maxTabWidth : undefined); + me.callParent(arguments); }, // @private @@ -124,12 +138,12 @@ Ext.define('Ext.tab.Bar', { delegate: '.' + Ext.baseCSSPrefix + 'tab' }); me.callParent(arguments); - + }, afterComponentLayout : function() { var me = this; - + me.callParent(arguments); me.strip.setWidth(me.el.getWidth()); }, @@ -138,8 +152,7 @@ Ext.define('Ext.tab.Bar', { onClick: function(e, target) { // The target might not be a valid tab el. var tab = Ext.getCmp(target.id), - tabPanel = this.tabPanel, - allowActive = true; + tabPanel = this.tabPanel; target = e.getTarget(); @@ -161,20 +174,20 @@ Ext.define('Ext.tab.Bar', { /** * @private * Closes the given tab by removing it from the TabBar and removing the corresponding card from the TabPanel - * @param {Ext.Tab} tab The tab to close + * @param {Ext.tab.Tab} tab The tab to close */ closeTab: function(tab) { var me = this, card = tab.card, tabPanel = me.tabPanel, nextTab; - + if (card && card.fireEvent('beforeclose', card) === false) { return false; } if (tab.active && me.items.getCount() > 1) { - nextTab = tab.next('tab') || me.items.items[0]; + nextTab = me.previousTab || tab.next('tab') || me.items.first(); me.setActiveTab(nextTab); if (tabPanel) { tabPanel.setActiveTab(nextTab.card); @@ -192,7 +205,7 @@ Ext.define('Ext.tab.Bar', { card.fireEvent('close', card); tabPanel.remove(card); } - + if (nextTab) { nextTab.focus(); } @@ -201,7 +214,7 @@ Ext.define('Ext.tab.Bar', { /** * @private * Marks the given tab as active - * @param {Ext.Tab} tab The tab to mark active + * @param {Ext.tab.Tab} tab The tab to mark active */ setActiveTab: function(tab) { if (tab.disabled) { @@ -209,17 +222,19 @@ Ext.define('Ext.tab.Bar', { } var me = this; if (me.activeTab) { + me.previousTab = me.activeTab; me.activeTab.deactivate(); } tab.activate(); - + if (me.rendered) { me.layout.layout(); - tab.el.scrollIntoView(me.layout.getRenderTarget()); + tab.el && tab.el.scrollIntoView(me.layout.getRenderTarget()); } me.activeTab = tab; me.fireEvent('change', me, tab, tab.card); } -});+}); +