2 Copyright (c) 2009, Yahoo! Inc. All rights reserved.
3 Code licensed under the BSD License:
4 http://developer.yahoo.net/yui/license.txt
10 * The tabview module provides a widget for managing content bound to tabs.
12 * @requires yahoo, dom, event, element
19 document = window.document,
23 ACTIVE_INDEX = 'activeIndex',
24 ACTIVE_TAB = 'activeTab',
25 CONTENT_EL = 'contentEl',
29 * A widget to control tabbed views.
30 * @namespace YAHOO.widget
32 * @extends YAHOO.util.Element
34 * @param {HTMLElement | String | Object} el(optional) The html
35 * element that represents the TabView, or the attribute object to use.
36 * An element will be created if none provided.
37 * @param {Object} attr (optional) A key map of the tabView's
38 * initial attributes. Ignored if first arg is attributes object.
40 TabView = function(el, attr) {
42 if (arguments.length == 1 && !YAHOO.lang.isString(el) && !el.nodeName) {
43 attr = el; // treat first arg as attr object
44 el = attr.element || null;
47 if (!el && !attr.element) { // create if we dont have one
48 el = this._createTabViewElement(attr);
50 TabView.superclass.constructor.call(this, el, attr);
53 YAHOO.extend(TabView, Y.Element, {
55 * The className to add when building from scratch.
59 CLASSNAME: 'yui-navset',
62 * The className of the HTMLElement containing the TabView's tab elements
63 * to look for when building from existing markup, or to add when building
65 * All childNodes of the tab container are treated as Tabs when building
66 * from existing markup.
67 * @property TAB_PARENT_CLASSNAME
70 TAB_PARENT_CLASSNAME: 'yui-nav',
73 * The className of the HTMLElement containing the TabView's label elements
74 * to look for when building from existing markup, or to add when building
76 * All childNodes of the content container are treated as content elements when
77 * building from existing markup.
78 * @property CONTENT_PARENT_CLASSNAME
79 * @default "nav-content"
81 CONTENT_PARENT_CLASSNAME: 'yui-content',
87 * Adds a Tab to the TabView instance.
88 * If no index is specified, the tab is added to the end of the tab list.
90 * @param {YAHOO.widget.Tab} tab A Tab instance to add.
91 * @param {Integer} index The position to add the tab.
94 addTab: function(tab, index) {
95 var tabs = this.get('tabs'),
96 before = this.getTab(index),
97 tabParent = this._tabParent,
98 contentParent = this._contentParent,
99 tabElement = tab.get(ELEMENT),
100 contentEl = tab.get(CONTENT_EL);
102 if (!tabs) { // not ready yet
103 this._queue[this._queue.length] = ['addTab', arguments];
107 index = (index === undefined) ? tabs.length : index;
109 tabs.splice(index, 0, tab);
112 tabParent.insertBefore(tabElement, before.get(ELEMENT));
114 tabParent.appendChild(tabElement);
117 if ( contentEl && !Dom.isAncestor(contentParent, contentEl) ) {
118 contentParent.appendChild(contentEl);
121 if ( !tab.get(ACTIVE) ) {
122 tab.set('contentVisible', false, true); /* hide if not active */
124 this.set(ACTIVE_TAB, tab, true);
125 this.set('activeIndex', index, true);
128 this._initTabEvents(tab);
131 _initTabEvents: function(tab) {
132 tab.addListener( tab.get('activationEvent'), tab._onActivate, this, tab);
133 tab.addListener( tab.get('activationEventChange'), tab._onActivationEventChange, this, tab);
136 _removeTabEvents: function(tab) {
137 tab.removeListener(tab.get('activationEvent'), tab._onActivate, this, tab);
138 tab.removeListener('activationEventChange', tab._onActivationEventChange, this, tab);
142 * Routes childNode events.
143 * @method DOMEventHandler
144 * @param {event} e The Dom event that is being handled.
147 DOMEventHandler: function(e) {
148 var target = Event.getTarget(e),
149 tabParent = this._tabParent,
150 tabs = this.get('tabs'),
156 if (Dom.isAncestor(tabParent, target) ) {
157 for (var i = 0, len = tabs.length; i < len; i++) {
158 tabEl = tabs[i].get(ELEMENT);
159 contentEl = tabs[i].get(CONTENT_EL);
161 if ( target == tabEl || Dom.isAncestor(tabEl, target) ) {
168 tab.fireEvent(e.type, e);
174 * Returns the Tab instance at the specified index.
176 * @param {Integer} index The position of the Tab.
177 * @return YAHOO.widget.Tab
179 getTab: function(index) {
180 return this.get('tabs')[index];
184 * Returns the index of given tab.
185 * @method getTabIndex
186 * @param {YAHOO.widget.Tab} tab The tab whose index will be returned.
189 getTabIndex: function(tab) {
191 tabs = this.get('tabs');
192 for (var i = 0, len = tabs.length; i < len; ++i) {
193 if (tab == tabs[i]) {
203 * Removes the specified Tab from the TabView.
205 * @param {YAHOO.widget.Tab} item The Tab instance to be removed.
208 removeTab: function(tab) {
209 var tabCount = this.get('tabs').length,
210 index = this.getTabIndex(tab);
212 if ( tab === this.get(ACTIVE_TAB) ) {
213 if (tabCount > 1) { // select another tab
214 if (index + 1 === tabCount) { // if last, activate previous
215 this.set(ACTIVE_INDEX, index - 1);
216 } else { // activate next tab
217 this.set(ACTIVE_INDEX, index + 1);
219 } else { // no more tabs
220 this.set(ACTIVE_TAB, null);
224 this._removeTabEvents(tab);
225 this._tabParent.removeChild( tab.get(ELEMENT) );
226 this._contentParent.removeChild( tab.get(CONTENT_EL) );
227 this._configs.tabs.value.splice(index, 1);
229 tab.fireEvent('remove', { type: 'remove', tabview: this });
233 * Provides a readable name for the TabView instance.
237 toString: function() {
238 var name = this.get('id') || this.get('tagName');
239 return "TabView " + name;
243 * The transiton to use when switching between tabs.
244 * @method contentTransition
246 contentTransition: function(newTab, oldTab) {
248 newTab.set('contentVisible', true);
251 oldTab.set('contentVisible', false);
256 * setAttributeConfigs TabView specific properties.
257 * @method initAttributes
258 * @param {Object} attr Hash of initial attributes
260 initAttributes: function(attr) {
261 TabView.superclass.initAttributes.call(this, attr);
263 if (!attr.orientation) {
264 attr.orientation = 'top';
267 var el = this.get(ELEMENT);
269 if (!Dom.hasClass(el, this.CLASSNAME)) {
270 Dom.addClass(el, this.CLASSNAME);
274 * The Tabs belonging to the TabView instance.
278 this.setAttributeConfig('tabs', {
284 * The container of the tabView's label elements.
285 * @property _tabParent
290 this.getElementsByClassName(this.TAB_PARENT_CLASSNAME,
291 'ul' )[0] || this._createTabParent();
294 * The container of the tabView's content elements.
295 * @property _contentParent
299 this._contentParent =
300 this.getElementsByClassName(this.CONTENT_PARENT_CLASSNAME,
301 'div')[0] || this._createContentParent();
304 * How the Tabs should be oriented relative to the TabView.
305 * @attribute orientation
309 this.setAttributeConfig('orientation', {
310 value: attr.orientation,
311 method: function(value) {
312 var current = this.get('orientation');
313 this.addClass('yui-navset-' + value);
315 if (current != value) {
316 this.removeClass('yui-navset-' + current);
319 if (value === 'bottom') {
320 this.appendChild(this._tabParent);
326 * The index of the tab currently active.
327 * @attribute activeIndex
330 this.setAttributeConfig(ACTIVE_INDEX, {
331 value: attr.activeIndex,
332 validator: function(value) {
334 if (value && this.getTab(value).get('disabled')) { // cannot activate if disabled
342 * The tab currently active.
343 * @attribute activeTab
344 * @type YAHOO.widget.Tab
346 this.setAttributeConfig(ACTIVE_TAB, {
347 value: attr.activeTab,
348 method: function(tab) {
349 var activeTab = this.get(ACTIVE_TAB);
352 tab.set(ACTIVE, true);
355 if (activeTab && activeTab !== tab) {
356 activeTab.set(ACTIVE, false);
359 if (activeTab && tab !== activeTab) { // no transition if only 1
360 this.contentTransition(tab, activeTab);
362 tab.set('contentVisible', true);
365 validator: function(value) {
367 if (value && value.get('disabled')) { // cannot activate if disabled
374 this.on('activeTabChange', this._onActiveTabChange);
375 this.on('activeIndexChange', this._onActiveIndexChange);
377 if ( this._tabParent ) {
381 // Due to delegation we add all DOM_EVENTS to the TabView container
382 // but IE will leak when unsupported events are added, so remove these
383 this.DOM_EVENTS.submit = false;
384 this.DOM_EVENTS.focus = false;
385 this.DOM_EVENTS.blur = false;
387 for (var type in this.DOM_EVENTS) {
388 if ( YAHOO.lang.hasOwnProperty(this.DOM_EVENTS, type) ) {
389 this.addListener.call(this, type, this.DOMEventHandler);
395 * Removes selected state from the given tab if it is the activeTab
396 * @method deselectTab
397 * @param {Int} index The tab index to deselect
399 deselectTab: function(index) {
400 if (this.getTab(index) === this.get('activeTab')) {
401 this.set('activeTab', null);
406 * Makes the tab at the given index the active tab
408 * @param {Int} index The tab index to be made active
410 selectTab: function(index) {
411 this.set('activeTab', this.getTab(index));
414 _onActiveTabChange: function(e) {
415 var activeIndex = this.get(ACTIVE_INDEX),
416 newIndex = this.getTabIndex(e.newValue);
418 if (activeIndex !== newIndex) {
419 if (!(this.set(ACTIVE_INDEX, newIndex)) ) { // NOTE: setting
420 // revert if activeIndex update fails (cancelled via beforeChange)
421 this.set(ACTIVE_TAB, e.prevValue);
426 _onActiveIndexChange: function(e) {
427 // no set if called from ActiveTabChange event
428 if (e.newValue !== this.getTabIndex(this.get(ACTIVE_TAB))) {
429 if (!(this.set(ACTIVE_TAB, this.getTab(e.newValue))) ) { // NOTE: setting
430 // revert if activeTab update fails (cancelled via beforeChange)
431 this.set(ACTIVE_INDEX, e.prevValue);
437 * Creates Tab instances from a collection of HTMLElements.
442 _initTabs: function() {
443 var tabs = Dom.getChildren(this._tabParent),
444 contentElements = Dom.getChildren(this._contentParent),
445 activeIndex = this.get(ACTIVE_INDEX),
450 for (var i = 0, len = tabs.length; i < len; ++i) {
453 if (contentElements[i]) {
454 attr.contentEl = contentElements[i];
457 tab = new YAHOO.widget.Tab(tabs[i], attr);
460 if (tab.hasClass(tab.ACTIVE_CLASSNAME) ) {
465 this.set(ACTIVE_TAB, this.getTab(activeIndex));
467 this._configs.activeTab.value = active; // dont invoke method
468 this._configs.activeIndex.value = this.getTabIndex(active);
472 _createTabViewElement: function(attr) {
473 var el = document.createElement('div');
475 if ( this.CLASSNAME ) {
476 el.className = this.CLASSNAME;
482 _createTabParent: function(attr) {
483 var el = document.createElement('ul');
485 if ( this.TAB_PARENT_CLASSNAME ) {
486 el.className = this.TAB_PARENT_CLASSNAME;
489 this.get(ELEMENT).appendChild(el);
494 _createContentParent: function(attr) {
495 var el = document.createElement('div');
497 if ( this.CONTENT_PARENT_CLASSNAME ) {
498 el.className = this.CONTENT_PARENT_CLASSNAME;
501 this.get(ELEMENT).appendChild(el);
508 YAHOO.widget.TabView = TabView;
518 ACTIVE_TAB = 'activeTab',
520 LABEL_EL = 'labelEl',
522 CONTENT_EL = 'contentEl',
524 CACHE_DATA = 'cacheData',
525 DATA_SRC = 'dataSrc',
526 DATA_LOADED = 'dataLoaded',
527 DATA_TIMEOUT = 'dataTimeout',
528 LOAD_METHOD = 'loadMethod',
529 POST_DATA = 'postData',
530 DISABLED = 'disabled',
533 * A representation of a Tab's label and content.
534 * @namespace YAHOO.widget
536 * @extends YAHOO.util.Element
538 * @param element {HTMLElement | String} (optional) The html element that
539 * represents the Tab. An element will be created if none provided.
540 * @param {Object} properties A key map of initial properties
542 Tab = function(el, attr) {
544 if (arguments.length == 1 && !Lang.isString(el) && !el.nodeName) {
549 if (!el && !attr.element) {
550 el = this._createTabElement(attr);
554 success: function(o) {
555 this.set(CONTENT, o.responseText);
557 failure: function(o) {
561 Tab.superclass.constructor.call(this, el, attr);
563 this.DOM_EVENTS = {}; // delegating to tabView
566 YAHOO.extend(Tab, YAHOO.util.Element, {
568 * The default tag name for a Tab's inner element.
569 * @property LABEL_INNER_TAGNAME
576 * The class name applied to active tabs.
577 * @property ACTIVE_CLASSNAME
579 * @default "selected"
581 ACTIVE_CLASSNAME: 'selected',
584 * The class name applied to active tabs.
585 * @property HIDDEN_CLASSNAME
587 * @default "yui-hidden"
589 HIDDEN_CLASSNAME: 'yui-hidden',
592 * The title applied to active tabs.
593 * @property ACTIVE_TITLE
597 ACTIVE_TITLE: 'active',
600 * The class name applied to disabled tabs.
601 * @property DISABLED_CLASSNAME
603 * @default "disabled"
605 DISABLED_CLASSNAME: DISABLED,
608 * The class name applied to dynamic tabs while loading.
609 * @property LOADING_CLASSNAME
611 * @default "disabled"
613 LOADING_CLASSNAME: 'loading',
616 * Provides a reference to the connection request object when data is
617 * loaded dynamically.
618 * @property dataConnection
621 dataConnection: null,
624 * Object containing success and failure callbacks for loading data.
625 * @property loadHandler
633 * Provides a readable name for the tab.
637 toString: function() {
638 var el = this.get(ELEMENT),
639 id = el.id || el.tagName;
644 * setAttributeConfigs Tab specific properties.
645 * @method initAttributes
646 * @param {Object} attr Hash of initial attributes
648 initAttributes: function(attr) {
650 Tab.superclass.initAttributes.call(this, attr);
653 * The event that triggers the tab's activation.
654 * @attribute activationEvent
657 this.setAttributeConfig('activationEvent', {
658 value: attr.activationEvent || 'click'
662 * The element that contains the tab's label.
666 this.setAttributeConfig(LABEL_EL, {
667 value: attr[LABEL_EL] || this._getLabelEl(),
668 method: function(value) {
669 value = Dom.get(value);
670 var current = this.get(LABEL_EL);
673 if (current == value) {
674 return false; // already set
677 current.parentNode.replaceChild(value, current);
678 this.set(LABEL, value.innerHTML);
684 * The tab's label text (or innerHTML).
688 this.setAttributeConfig(LABEL, {
689 value: attr.label || this._getLabel(),
690 method: function(value) {
691 var labelEl = this.get(LABEL_EL);
692 if (!labelEl) { // create if needed
693 this.set(LABEL_EL, this._createLabelEl());
696 labelEl.innerHTML = value;
701 * The HTMLElement that contains the tab's content.
702 * @attribute contentEl
705 this.setAttributeConfig(CONTENT_EL, {
706 value: attr[CONTENT_EL] || document.createElement('div'),
707 method: function(value) {
708 value = Dom.get(value);
709 var current = this.get(CONTENT_EL);
712 if (current === value) {
713 return false; // already set
715 if (!this.get('selected')) {
716 Dom.addClass(value, this.HIDDEN_CLASSNAME);
718 current.parentNode.replaceChild(value, current);
719 this.set(CONTENT, value.innerHTML);
729 this.setAttributeConfig(CONTENT, {
730 value: attr[CONTENT],
731 method: function(value) {
732 this.get(CONTENT_EL).innerHTML = value;
737 * The tab's data source, used for loading content dynamically.
741 this.setAttributeConfig(DATA_SRC, {
746 * Whether or not content should be reloaded for every view.
747 * @attribute cacheData
751 this.setAttributeConfig(CACHE_DATA, {
752 value: attr.cacheData || false,
753 validator: Lang.isBoolean
757 * The method to use for the data request.
758 * @attribute loadMethod
762 this.setAttributeConfig(LOAD_METHOD, {
763 value: attr.loadMethod || 'GET',
764 validator: Lang.isString
768 * Whether or not any data has been loaded from the server.
769 * @attribute dataLoaded
772 this.setAttributeConfig(DATA_LOADED, {
774 validator: Lang.isBoolean,
779 * Number if milliseconds before aborting and calling failure handler.
780 * @attribute dataTimeout
784 this.setAttributeConfig(DATA_TIMEOUT, {
785 value: attr.dataTimeout || null,
786 validator: Lang.isNumber
790 * Arguments to pass when POST method is used
791 * @attribute postData
794 this.setAttributeConfig(POST_DATA, {
795 value: attr.postData || null
799 * Whether or not the tab is currently active.
800 * If a dataSrc is set for the tab, the content will be loaded from
805 this.setAttributeConfig('active', {
806 value: attr.active || this.hasClass(this.ACTIVE_CLASSNAME),
807 method: function(value) {
808 if (value === true) {
809 this.addClass(this.ACTIVE_CLASSNAME);
810 this.set('title', this.ACTIVE_TITLE);
812 this.removeClass(this.ACTIVE_CLASSNAME);
813 this.set('title', '');
816 validator: function(value) {
817 return Lang.isBoolean(value) && !this.get(DISABLED) ;
822 * Whether or not the tab is disabled.
823 * @attribute disabled
826 this.setAttributeConfig(DISABLED, {
827 value: attr.disabled || this.hasClass(this.DISABLED_CLASSNAME),
828 method: function(value) {
829 if (value === true) {
830 Dom.addClass(this.get(ELEMENT), this.DISABLED_CLASSNAME);
832 Dom.removeClass(this.get(ELEMENT), this.DISABLED_CLASSNAME);
835 validator: Lang.isBoolean
839 * The href of the tab's anchor element.
844 this.setAttributeConfig('href', {
846 this.getElementsByTagName('a')[0].getAttribute('href', 2) || '#',
847 method: function(value) {
848 this.getElementsByTagName('a')[0].href = value;
850 validator: Lang.isString
854 * The Whether or not the tab's content is visible.
855 * @attribute contentVisible
859 this.setAttributeConfig('contentVisible', {
860 value: attr.contentVisible,
861 method: function(value) {
863 Dom.removeClass(this.get(CONTENT_EL), this.HIDDEN_CLASSNAME);
865 if ( this.get(DATA_SRC) ) {
866 // load dynamic content unless already loading or loaded and caching
867 if ( !this._loading && !(this.get(DATA_LOADED) && this.get(CACHE_DATA)) ) {
872 Dom.addClass(this.get(CONTENT_EL), this.HIDDEN_CLASSNAME);
875 validator: Lang.isBoolean
879 _dataConnect: function() {
884 Dom.addClass(this.get(CONTENT_EL).parentNode, this.LOADING_CLASSNAME);
885 this._loading = true;
886 this.dataConnection = Y.Connect.asyncRequest(
887 this.get(LOAD_METHOD),
890 success: function(o) {
891 this.loadHandler.success.call(this, o);
892 this.set(DATA_LOADED, true);
893 this.dataConnection = null;
894 Dom.removeClass(this.get(CONTENT_EL).parentNode,
895 this.LOADING_CLASSNAME);
896 this._loading = false;
898 failure: function(o) {
899 this.loadHandler.failure.call(this, o);
900 this.dataConnection = null;
901 Dom.removeClass(this.get(CONTENT_EL).parentNode,
902 this.LOADING_CLASSNAME);
903 this._loading = false;
906 timeout: this.get(DATA_TIMEOUT)
912 _createTabElement: function(attr) {
913 var el = document.createElement('li'),
914 a = document.createElement('a'),
915 label = attr.label || null,
916 labelEl = attr.labelEl || null;
918 a.href = attr.href || '#'; // TODO: Use Dom.setAttribute?
921 if (labelEl) { // user supplied labelEl
922 if (!label) { // user supplied label
923 label = this._getLabel();
926 labelEl = this._createLabelEl();
929 a.appendChild(labelEl);
934 _getLabelEl: function() {
935 return this.getElementsByTagName(this.LABEL_TAGNAME)[0];
938 _createLabelEl: function() {
939 var el = document.createElement(this.LABEL_TAGNAME);
944 _getLabel: function() {
945 var el = this.get(LABEL_EL);
954 _onActivate: function(e, tabview) {
958 Y.Event.preventDefault(e);
959 if (tab === tabview.get(ACTIVE_TAB)) {
960 silent = true; // dont fire activeTabChange if already active
962 tabview.set(ACTIVE_TAB, tab, silent);
965 _onActivationEventChange: function(e) {
968 if (e.prevValue != e.newValue) {
969 tab.removeListener(e.prevValue, tab._onActivate);
970 tab.addListener(e.newValue, tab._onActivate, this, tab);
977 * Fires when a tab is removed from the tabview
980 * @param {Event} An event object with fields for "type" ("remove")
981 * and "tabview" (the tabview instance it was removed from)
984 YAHOO.widget.Tab = Tab;
987 YAHOO.register("tabview", YAHOO.widget.TabView, {version: "2.8.0r4", build: "2449"});