Automatic installer.php lang files by installer_builder (20070726)
[moodle-linuxchix.git] / lib / yui / tabview / tabview-debug.js
blob4dd2b0323f4e88413e6b825d0f74e18521bb49df
1 /*
2 Copyright (c) 2006, Yahoo! Inc. All rights reserved.
3 Code licensed under the BSD License:
4 http://developer.yahoo.net/yui/license.txt
5 version: 0.12.2
6 */
7 YAHOO.util.Lang = {
8     isArray: function(val) { // frames lose type, so test constructor string
9         if (val.constructor && val.constructor.toString().indexOf('Array') > -1) {
10             return true;
11         } else {
12             return YAHOO.util.Lang.isObject(val) && val.constructor == Array;
13         }
14     },
15         
16     isBoolean: function(val) {
17         return typeof val == 'boolean';
18     },
19     
20     isFunction: function(val) {
21         return typeof val == 'function';
22     },
23         
24     isNull: function(val) {
25         return val === null;
26     },
27         
28     isNumber: function(val) {
29         return !isNaN(val);
30     },
31         
32     isObject: function(val) {
33         return typeof val == 'object' || YAHOO.util.Lang.isFunction(val);
34     },
35         
36     isString: function(val) {
37         return typeof val == 'string';
38     },
39         
40     isUndefined: function(val) {
41         return typeof val == 'undefined';
42     }
45 /**
46  * Provides Attribute configurations.
47  * @namespace YAHOO.util
48  * @class Attribute
49  * @constructor
50  * @param hash {Object} The intial Attribute.
51  * @param {YAHOO.util.AttributeProvider} The owner of the Attribute instance.
52  */
54 YAHOO.util.Attribute = function(hash, owner) {
55     if (owner) { 
56         this.owner = owner;
57         this.configure(hash, true);
58     }
61 YAHOO.util.Attribute.prototype = {
62         /**
63      * The name of the attribute.
64          * @property name
65          * @type String
66          */
67     name: undefined,
68     
69         /**
70      * The value of the attribute.
71          * @property value
72          * @type String
73          */
74     value: null,
75     
76         /**
77      * The owner of the attribute.
78          * @property owner
79          * @type YAHOO.util.AttributeProvider
80          */
81     owner: null,
82     
83         /**
84      * Whether or not the attribute is read only.
85          * @property readOnly
86          * @type Boolean
87          */
88     readOnly: false,
89     
90         /**
91      * Whether or not the attribute can only be written once.
92          * @property writeOnce
93          * @type Boolean
94          */
95     writeOnce: false,
97         /**
98      * The attribute's initial configuration.
99      * @private
100          * @property _initialConfig
101          * @type Object
102          */
103     _initialConfig: null,
104     
105         /**
106      * Whether or not the attribute's value has been set.
107      * @private
108          * @property _written
109          * @type Boolean
110          */
111     _written: false,
112     
113         /**
114      * The method to use when setting the attribute's value.
115      * The method recieves the new value as the only argument.
116          * @property method
117          * @type Function
118          */
119     method: null,
120     
121         /**
122      * The validator to use when setting the attribute's value.
123          * @property validator
124          * @type Function
125      * @return Boolean
126          */
127     validator: null,
128     
129     /**
130      * Retrieves the current value of the attribute.
131      * @method getValue
132      * @return {any} The current value of the attribute.
133      */
134     getValue: function() {
135         return this.value;
136     },
137     
138     /**
139      * Sets the value of the attribute and fires beforeChange and change events.
140      * @method setValue
141      * @param {Any} value The value to apply to the attribute.
142      * @param {Boolean} silent If true the change events will not be fired.
143      * @return {Boolean} Whether or not the value was set.
144      */
145     setValue: function(value, silent) {
146         var beforeRetVal;
147         var owner = this.owner;
148         var name = this.name;
149         
150         var event = {
151             type: name, 
152             prevValue: this.getValue(),
153             newValue: value
154         };
155         
156         if (this.readOnly || ( this.writeOnce && this._written) ) {
157             return false; // write not allowed
158         }
159         
160         if (this.validator && !this.validator.call(owner, value) ) {
161             return false; // invalid value
162         }
164         if (!silent) {
165             beforeRetVal = owner.fireBeforeChangeEvent(event);
166             if (beforeRetVal === false) {
167                 YAHOO.log('setValue ' + name + 
168                         'cancelled by beforeChange event', 'info', 'Attribute');
169                 return false;
170             }
171         }
173         if (this.method) {
174             this.method.call(owner, value);
175         }
176         
177         this.value = value;
178         this._written = true;
179         
180         event.type = name;
181         
182         if (!silent) {
183             this.owner.fireChangeEvent(event);
184         }
185         
186         return true;
187     },
188     
189     /**
190      * Allows for configuring the Attribute's properties.
191      * @method configure
192      * @param {Object} map A key-value map of Attribute properties.
193      * @param {Boolean} init Whether or not this should become the initial config.
194      */
195     configure: function(map, init) {
196         map = map || {};
197         this._written = false; // reset writeOnce
198         this._initialConfig = this._initialConfig || {};
199         
200         for (var key in map) {
201             if ( key && map.hasOwnProperty(key) ) {
202                 this[key] = map[key];
203                 if (init) {
204                     this._initialConfig[key] = map[key];
205                 }
206             }
207         }
208     },
209     
210     /**
211      * Resets the value to the initial config value.
212      * @method resetValue
213      * @return {Boolean} Whether or not the value was set.
214      */
215     resetValue: function() {
216         return this.setValue(this._initialConfig.value);
217     },
218     
219     /**
220      * Resets the attribute config to the initial config state.
221      * @method resetConfig
222      */
223     resetConfig: function() {
224         this.configure(this._initialConfig);
225     },
226     
227     /**
228      * Resets the value to the current value.
229      * Useful when values may have gotten out of sync with actual properties.
230      * @method refresh
231      * @return {Boolean} Whether or not the value was set.
232      */
233     refresh: function(silent) {
234         this.setValue(this.value, silent);
235     }
238 (function() {
239     var Lang = YAHOO.util.Lang;
241     /*
242     Copyright (c) 2006, Yahoo! Inc. All rights reserved.
243     Code licensed under the BSD License:
244     http://developer.yahoo.net/yui/license.txt
245     */
246     
247     /**
248      * Provides and manages YAHOO.util.Attribute instances
249      * @namespace YAHOO.util
250      * @class AttributeProvider
251      * @uses YAHOO.util.EventProvider
252      */
253     YAHOO.util.AttributeProvider = function() {};
254     
255     YAHOO.util.AttributeProvider.prototype = {
256         
257         /**
258          * A key-value map of Attribute configurations
259          * @property _configs
260          * @protected (may be used by subclasses and augmentors)
261          * @private
262          * @type {Object}
263          */
264         _configs: null,
265         /**
266          * Returns the current value of the attribute.
267          * @method get
268          * @param {String} key The attribute whose value will be returned.
269          */
270         get: function(key){
271             var configs = this._configs || {};
272             var config = configs[key];
273             
274             if (!config) {
275                 YAHOO.log(key + ' not found', 'error', 'AttributeProvider');
276                 return undefined;
277             }
278             
279             return config.value;
280         },
281         
282         /**
283          * Sets the value of a config.
284          * @method set
285          * @param {String} key The name of the attribute
286          * @param {Any} value The value to apply to the attribute
287          * @param {Boolean} silent Whether or not to suppress change events
288          * @return {Boolean} Whether or not the value was set.
289          */
290         set: function(key, value, silent){
291             var configs = this._configs || {};
292             var config = configs[key];
293             
294             if (!config) {
295                 YAHOO.log('set failed: ' + key + ' not found',
296                         'error', 'AttributeProvider');
297                 return false;
298             }
299             
300             return config.setValue(value, silent);
301         },
302     
303         /**
304          * Returns an array of attribute names.
305          * @method getAttributeKeys
306          * @return {Array} An array of attribute names.
307          */
308         getAttributeKeys: function(){
309             var configs = this._configs;
310             var keys = [];
311             var config;
312             for (var key in configs) {
313                 config = configs[key];
314                 if ( configs.hasOwnProperty(key) && 
315                         !Lang.isUndefined(config) ) {
316                     keys[keys.length] = key;
317                 }
318             }
319             
320             return keys;
321         },
322         
323         /**
324          * Sets multiple attribute values.
325          * @method setAttributes
326          * @param {Object} map  A key-value map of attributes
327          * @param {Boolean} silent Whether or not to suppress change events
328          */
329         setAttributes: function(map, silent){
330             for (var key in map) {
331                 if ( map.hasOwnProperty(key) ) {
332                     this.set(key, map[key], silent);
333                 }
334             }
335         },
336     
337         /**
338          * Resets the specified attribute's value to its initial value.
339          * @method resetValue
340          * @param {String} key The name of the attribute
341          * @param {Boolean} silent Whether or not to suppress change events
342          * @return {Boolean} Whether or not the value was set
343          */
344         resetValue: function(key, silent){
345             var configs = this._configs || {};
346             if (configs[key]) {
347                 this.set(key, configs[key]._initialConfig.value, silent);
348                 return true;
349             }
350             return false;
351         },
352     
353         /**
354          * Sets the attribute's value to its current value.
355          * @method refresh
356          * @param {String | Array} key The attribute(s) to refresh
357          * @param {Boolean} silent Whether or not to suppress change events
358          */
359         refresh: function(key, silent){
360             var configs = this._configs;
361             
362             key = ( ( Lang.isString(key) ) ? [key] : key ) || 
363                     this.getAttributeKeys();
364             
365             for (var i = 0, len = key.length; i < len; ++i) { 
366                 if ( // only set if there is a value and not null
367                     configs[key[i]] && 
368                     ! Lang.isUndefined(configs[key[i]].value) &&
369                     ! Lang.isNull(configs[key[i]].value) ) {
370                     configs[key[i]].refresh(silent);
371                 }
372             }
373         },
374     
375         /**
376          * Adds an Attribute to the AttributeProvider instance. 
377          * @method register
378          * @param {String} key The attribute's name
379          * @param {Object} map A key-value map containing the
380          * attribute's properties.
381          */
382         register: function(key, map) {
383             this._configs = this._configs || {};
384             
385             if (this._configs[key]) { // dont override
386                 return false;
387             }
388             
389             map.name = key;
390             this._configs[key] = new YAHOO.util.Attribute(map, this);
391             return true;
392         },
393         
394         /**
395          * Returns the attribute's properties.
396          * @method getAttributeConfig
397          * @param {String} key The attribute's name
398          * @private
399          * @return {object} A key-value map containing all of the
400          * attribute's properties.
401          */
402         getAttributeConfig: function(key) {
403             var configs = this._configs || {};
404             var config = configs[key] || {};
405             var map = {}; // returning a copy to prevent overrides
406             
407             for (key in config) {
408                 if ( config.hasOwnProperty(key) ) {
409                     map[key] = config[key];
410                 }
411             }
412     
413             return map;
414         },
415         
416         /**
417          * Sets or updates an Attribute instance's properties. 
418          * @method configureAttribute
419          * @param {String} key The attribute's name.
420          * @param {Object} map A key-value map of attribute properties
421          * @param {Boolean} init Whether or not this should become the intial config.
422          */
423         configureAttribute: function(key, map, init) {
424             var configs = this._configs || {};
425             
426             if (!configs[key]) {
427                 YAHOO.log('unable to configure, ' + key + ' not found',
428                         'error', 'AttributeProvider');
429                 return false;
430             }
431             
432             configs[key].configure(map, init);
433         },
434         
435         /**
436          * Resets an attribute to its intial configuration. 
437          * @method resetAttributeConfig
438          * @param {String} key The attribute's name.
439          * @private
440          */
441         resetAttributeConfig: function(key){
442             var configs = this._configs || {};
443             configs[key].resetConfig();
444         },
445         
446         /**
447          * Fires the attribute's beforeChange event. 
448          * @method fireBeforeChangeEvent
449          * @param {String} key The attribute's name.
450          * @param {Obj} e The event object to pass to handlers.
451          */
452         fireBeforeChangeEvent: function(e) {
453             var type = 'before';
454             type += e.type.charAt(0).toUpperCase() + e.type.substr(1) + 'Change';
455             e.type = type;
456             return this.fireEvent(e.type, e);
457         },
458         
459         /**
460          * Fires the attribute's change event. 
461          * @method fireChangeEvent
462          * @param {String} key The attribute's name.
463          * @param {Obj} e The event object to pass to the handlers.
464          */
465         fireChangeEvent: function(e) {
466             e.type += 'Change';
467             return this.fireEvent(e.type, e);
468         }
469     };
470     
471     YAHOO.augment(YAHOO.util.AttributeProvider, YAHOO.util.EventProvider);
472 })();
474 (function() {
475 // internal shorthand
476 var Dom = YAHOO.util.Dom,
477     Lang = YAHOO.util.Lang,
478     EventPublisher = YAHOO.util.EventPublisher,
479     AttributeProvider = YAHOO.util.AttributeProvider;
482  * Element provides an interface to an HTMLElement's attributes and common
483  * methods.  Other commonly used attributes are added as well.
484  * @namespace YAHOO.util
485  * @class Element
486  * @uses YAHOO.util.AttributeProvider
487  * @constructor
488  * @param el {HTMLElement | String} The html element that 
489  * represents the Element.
490  * @param {Object} map A key-value map of initial config names and values
491  */
492 YAHOO.util.Element = function(el, map) {
493     if (arguments.length) {
494         this.init(el, map);
495     }
498 YAHOO.util.Element.prototype = {
499         /**
500      * Dom events supported by the Element instance.
501          * @property DOM_EVENTS
502          * @type Object
503          */
504     DOM_EVENTS: null,
506         /**
507      * Wrapper for HTMLElement method.
508          * @method appendChild
509          * @param {Boolean} deep Whether or not to do a deep clone
510          */
511     appendChild: function(child) {
512         child = child.get ? child.get('element') : child;
513         this.get('element').appendChild(child);
514     },
515     
516         /**
517      * Wrapper for HTMLElement method.
518          * @method getElementsByTagName
519          * @param {String} tag The tagName to collect
520          */
521     getElementsByTagName: function(tag) {
522         return this.get('element').getElementsByTagName(tag);
523     },
524     
525         /**
526      * Wrapper for HTMLElement method.
527          * @method hasChildNodes
528          * @return {Boolean} Whether or not the element has childNodes
529          */
530     hasChildNodes: function() {
531         return this.get('element').hasChildNodes();
532     },
533     
534         /**
535      * Wrapper for HTMLElement method.
536          * @method insertBefore
537          * @param {HTMLElement} element The HTMLElement to insert
538          * @param {HTMLElement} before The HTMLElement to insert
539      * the element before.
540          */
541     insertBefore: function(element, before) {
542         element = element.get ? element.get('element') : element;
543         before = (before && before.get) ? before.get('element') : before;
544         
545         this.get('element').insertBefore(element, before);
546     },
547     
548         /**
549      * Wrapper for HTMLElement method.
550          * @method removeChild
551          * @param {HTMLElement} child The HTMLElement to remove
552          */
553     removeChild: function(child) {
554         child = child.get ? child.get('element') : child;
555         this.get('element').removeChild(child);
556         return true;
557     },
558     
559         /**
560      * Wrapper for HTMLElement method.
561          * @method replaceChild
562          * @param {HTMLElement} newNode The HTMLElement to insert
563          * @param {HTMLElement} oldNode The HTMLElement to replace
564          */
565     replaceChild: function(newNode, oldNode) {
566         newNode = newNode.get ? newNode.get('element') : newNode;
567         oldNode = oldNode.get ? oldNode.get('element') : oldNode;
568         return this.get('element').replaceChild(newNode, oldNode);
569     },
571     
572     /**
573      * Registers Element specific attributes.
574      * @method initAttributes
575      * @param {Object} map A key-value map of initial attribute configs
576      */
577     initAttributes: function(map) {
578         map = map || {}; 
579         var element = Dom.get(map.element) || null;
580         
581         /**
582          * The HTMLElement the Element instance refers to.
583          * @config element
584          * @type HTMLElement
585          */
586         this.register('element', {
587             value: element,
588             readOnly: true
589          });
590     },
592     /**
593      * Adds a listener for the given event.  These may be DOM or 
594      * customEvent listeners.  Any event that is fired via fireEvent
595      * can be listened for.  All handlers receive an event object. 
596      * @method addListener
597      * @param {String} type The name of the event to listen for
598      * @param {Function} fn The handler to call when the event fires
599      * @param {Any} obj A variable to pass to the handler
600      * @param {Object} scope The object to use for the scope of the handler 
601      */
602     addListener: function(type, fn, obj, scope) {
603         var el = this.get('element');
604         var scope = scope || this;
605         
606         el = this.get('id') || el;
607         
608         if (!this._events[type]) { // create on the fly
609             if ( this.DOM_EVENTS[type] ) {
610                 YAHOO.util.Event.addListener(el, type, function(e) {
611                     if (e.srcElement && !e.target) { // supplement IE with target
612                         e.target = e.srcElement;
613                     }
614                     this.fireEvent(type, e);
615                 }, obj, scope);
616             }
617             
618             this.createEvent(type, this);
619             this._events[type] = true;
620         }
621         
622         this.subscribe.apply(this, arguments); // notify via customEvent
623     },
624     
625     
626     /**
627      * Alias for addListener
628      * @method on
629      * @param {String} type The name of the event to listen for
630      * @param {Function} fn The function call when the event fires
631      * @param {Any} obj A variable to pass to the handler
632      * @param {Object} scope The object to use for the scope of the handler 
633      */
634     on: function() { this.addListener.apply(this, arguments); },
635     
636     
637     /**
638      * Remove an event listener
639      * @method removeListener
640      * @param {String} type The name of the event to listen for
641      * @param {Function} fn The function call when the event fires
642      */
643     removeListener: function(type, fn) {
644         this.unsubscribe.apply(this, arguments);
645     },
646     
647         /**
648      * Wrapper for Dom method.
649          * @method addClass
650          * @param {String} className The className to add
651          */
652     addClass: function(className) {
653         Dom.addClass(this.get('element'), className);
654     },
655     
656         /**
657      * Wrapper for Dom method.
658          * @method getElementsByClassName
659          * @param {String} className The className to collect
660          * @param {String} tag (optional) The tag to use in
661      * conjunction with class name
662      * @return {Array} Array of HTMLElements
663          */
664     getElementsByClassName: function(className, tag) {
665         return Dom.getElementsByClassName(className, tag,
666                 this.get('element') );
667     },
668     
669         /**
670      * Wrapper for Dom method.
671          * @method hasClass
672          * @param {String} className The className to add
673      * @return {Boolean} Whether or not the element has the class name
674          */
675     hasClass: function(className) {
676         return Dom.hasClass(this.get('element'), className); 
677     },
678     
679         /**
680      * Wrapper for Dom method.
681          * @method removeClass
682          * @param {String} className The className to remove
683          */
684     removeClass: function(className) {
685         return Dom.removeClass(this.get('element'), className);
686     },
687     
688         /**
689      * Wrapper for Dom method.
690          * @method replaceClass
691          * @param {String} oldClassName The className to replace
692          * @param {String} newClassName The className to add
693          */
694     replaceClass: function(oldClassName, newClassName) {
695         return Dom.replaceClass(this.get('element'), 
696                 oldClassName, newClassName);
697     },
698     
699         /**
700      * Wrapper for Dom method.
701          * @method setStyle
702          * @param {String} property The style property to set
703          * @param {String} value The value to apply to the style property
704          */
705     setStyle: function(property, value) {
706         return Dom.setStyle(this.get('element'),  property, value);
707     },
708     
709         /**
710      * Wrapper for Dom method.
711          * @method getStyle
712          * @param {String} property The style property to retrieve
713          * @return {String} The current value of the property
714          */
715     getStyle: function(property) {
716         return Dom.getStyle(this.get('element'),  property);
717     },
718     
719         /**
720      * Apply any queued set calls.
721          * @method fireQueue
722          */
723     fireQueue: function() {
724         var queue = this._queue;
725         for (var i = 0, len = queue.length; i < len; ++i) {
726             this[queue[i][0]].apply(this, queue[i][1]);
727         }
728     },
729     
730         /**
731      * Appends the HTMLElement into either the supplied parentNode.
732          * @method appendTo
733          * @param {HTMLElement | Element} parentNode The node to append to
734          * @param {HTMLElement | Element} before An optional node to insert before
735          */
736     appendTo: function(parent, before) {
737         parent = (parent.get) ?  parent.get('element') : Dom.get(parent);
738         
739         before = (before && before.get) ? 
740                 before.get('element') : Dom.get(before);
741         var element = this.get('element');
742         
743         var newAddition =  !Dom.inDocument(element);
744         
745         if (!element) {
746             YAHOO.log('appendTo failed: element not available',
747                     'error', 'Element');
748             return false;
749         }
750         
751         if (!parent) {
752             YAHOO.log('appendTo failed: parent not available',
753                     'error', 'Element');
754             return false;
755         }
756         
757         if (element.parent != parent) {
758             if (before) {
759                 parent.insertBefore(element, before);
760             } else {
761                 parent.appendChild(element);
762             }
763         }
764         
765         YAHOO.log(element + 'appended to ' + parent);
766         
767         if (!newAddition) {
768             return false; // note return; no refresh if in document
769         }
770         
771         // if a new addition, refresh HTMLElement any applied attributes
772         var keys = this.getAttributeKeys();
773         
774         for (var key in keys) { // only refresh HTMLElement attributes
775             if ( !Lang.isUndefined(element[key]) ) {
776                 this.refresh(key);
777             }
778         }
779     },
780     
781     get: function(key) {
782         var configs = this._configs || {};
783         var el = configs.element; // avoid loop due to 'element'
784         if (el && !configs[key] && !Lang.isUndefined(el.value[key]) ) {
785             return el.value[key];
786         }
788         return AttributeProvider.prototype.get.call(this, key);
789     },
791     set: function(key, value, silent) {
792         var el = this.get('element');
793         if (!el) {
794             this._queue[this._queue.length] = ['set', arguments];
795             return false;
796         }
797         
798         // set it on the element if not a property
799         if ( !this._configs[key] && !Lang.isUndefined(el[key]) ) {
800             _registerHTMLAttr.call(this, key);
801         }
803         return AttributeProvider.prototype.set.apply(this, arguments);
804     },
805     
806     register: function(key) { // protect html attributes
807         var configs = this._configs || {};
808         var element = this.get('element') || null;
809         
810         if ( element && !Lang.isUndefined(element[key]) ) {
811             YAHOO.log(key + ' is reserved for ' + element, 
812                     'error', 'Element');
813             return false;
814         }
815         
816         return AttributeProvider.prototype.register.apply(this, arguments);
817     },
818     
819     configureAttribute: function(property, map, init) { // protect html attributes
820         var el = this.get('element');
821         if (!el) {
822             this._queue[this._queue.length] = ['configureAttribute', arguments];
823             return;
824         }
825         
826         if (!this._configs[property] && !Lang.isUndefined(el[property]) ) {
827             _registerHTMLAttr.call(this, property, map);
828         }
829         
830         return AttributeProvider.prototype.configureAttribute.apply(this, arguments);
831     },
832     
833     getAttributeKeys: function() {
834         var el = this.get('element');
835         var keys = AttributeProvider.prototype.getAttributeKeys.call(this);
836         
837         //add any unconfigured element keys
838         for (var key in el) {
839             if (!this._configs[key]) {
840                 keys[key] = keys[key] || el[key];
841             }
842         }
843         
844         return keys;
845     },
846     
847     init: function(el, attr) {
848         this._queue = this._queue || [];
849         this._events = this._events || {};
850         this._configs = this._configs || {};
851         attr = attr || {};
852         attr.element = attr.element || el || null;
854         this.DOM_EVENTS = {
855             'click': true,
856             'keydown': true,
857             'keypress': true,
858             'keyup': true,
859             'mousedown': true,
860             'mousemove': true,
861             'mouseout': true, 
862             'mouseover': true, 
863             'mouseup': true
864         };
865         
866         var readyHandler = function() {
867             this.initAttributes(attr);
869             this.setAttributes(attr, true);
870             this.fireQueue();
871             this.fireEvent('contentReady', {
872                 type: 'contentReady',
873                 target: attr.element
874             });
875         };
877         if ( Lang.isString(el) ) {
878             _registerHTMLAttr.call(this, 'id', { value: el });
879             YAHOO.util.Event.onAvailable(el, function() {
880                 attr.element = Dom.get(el);
881                 this.fireEvent('available', {
882                     type: 'available',
883                     target: attr.element
884                 }); 
885             }, this, true);
886             
887             YAHOO.util.Event.onContentReady(el, function() {
888                 readyHandler.call(this);
889             }, this, true);
890         } else {
891             readyHandler.call(this);
892         }        
893     }
897  * Sets the value of the property and fires beforeChange and change events.
898  * @private
899  * @method _registerHTMLAttr
900  * @param {YAHOO.util.Element} element The Element instance to
901  * register the config to.
902  * @param {String} key The name of the config to register
903  * @param {Object} map A key-value map of the config's params
904  */
905 var _registerHTMLAttr = function(key, map) {
906     var el = this.get('element');
907     map = map || {};
908     map.name = key;
909     map.method = map.method || function(value) {
910         el[key] = value;
911     };
912     map.value = map.value || el[key];
913     this._configs[key] = new YAHOO.util.Attribute(map, this);
917  * Fires when the Element's HTMLElement can be retrieved by Id.
918  * <p>See: <a href="#addListener">Element.addListener</a></p>
919  * <p><strong>Event fields:</strong><br>
920  * <code>&lt;String&gt; type</code> available<br>
921  * <code>&lt;HTMLElement&gt;
922  * target</code> the HTMLElement bound to this Element instance<br>
923  * <p><strong>Usage:</strong><br>
924  * <code>var handler = function(e) {var target = e.target};<br>
925  * myTabs.addListener('available', handler);</code></p>
926  * @event available
927  */
930  * Fires when the Element's HTMLElement subtree is rendered.
931  * <p>See: <a href="#addListener">Element.addListener</a></p>
932  * <p><strong>Event fields:</strong><br>
933  * <code>&lt;String&gt; type</code> contentReady<br>
934  * <code>&lt;HTMLElement&gt;
935  * target</code> the HTMLElement bound to this Element instance<br>
936  * <p><strong>Usage:</strong><br>
937  * <code>var handler = function(e) {var target = e.target};<br>
938  * myTabs.addListener('contentReady', handler);</code></p>
939  * @event contentReady
940  */
943 YAHOO.augment(YAHOO.util.Element, AttributeProvider);
944 })();
946 (function() {
947     var Dom = YAHOO.util.Dom,
948         Event = YAHOO.util.Event,
949         Lang = YAHOO.util.Lang;
950     
951     /**
952      * A representation of a Tab's label and content.
953      * @namespace YAHOO.widget
954      * @class Tab
955      * @extends YAHOO.util.Element
956      * @constructor
957      * @param element {HTMLElement | String} (optional) The html element that 
958      * represents the TabView. An element will be created if none provided.
959      * @param {Object} properties A key map of initial properties
960      */
961     var Tab = function(el, attr) {
962         attr = attr || {};
963         if (arguments.length == 1 && !Lang.isString(el) && !el.nodeName) {
964             attr = el;
965             el = attr.element;
966         }
968         if (!el && !attr.element) {
969             el = _createTabElement.call(this, attr);
970         }
972         this.loadHandler =  {
973             success: function(o) {
974                 this.set('content', o.responseText);
975             },
976             failure: function(o) {
977                 YAHOO.log('loading failed: ' + o.statusText,
978                         'error', 'Tab');
979             }
980         };
981         
982         Tab.superclass.constructor.call(this, el, attr);
983         
984         this.DOM_EVENTS = {}; // delegating to tabView
985     };
987     YAHOO.extend(Tab, YAHOO.util.Element);
988     var proto = Tab.prototype;
989     
990     /**
991      * The default tag name for a Tab's inner element.
992      * @property LABEL_INNER_TAGNAME
993      * @type String
994      * @default "em"
995      */
996     proto.LABEL_TAGNAME = 'em';
997     
998     /**
999      * The class name applied to active tabs.
1000      * @property ACTIVE_CLASSNAME
1001      * @type String
1002      * @default "on"
1003      */
1004     proto.ACTIVE_CLASSNAME = 'selected';
1005     
1006     /**
1007      * The class name applied to disabled tabs.
1008      * @property DISABLED_CLASSNAME
1009      * @type String
1010      * @default "disabled"
1011      */
1012     proto.DISABLED_CLASSNAME = 'disabled';
1013     
1014     /**
1015      * The class name applied to dynamic tabs while loading.
1016      * @property LOADING_CLASSNAME
1017      * @type String
1018      * @default "disabled"
1019      */
1020     proto.LOADING_CLASSNAME = 'loading';
1022     /**
1023      * Provides a reference to the connection request object when data is
1024      * loaded dynamically.
1025      * @property dataConnection
1026      * @type Object
1027      */
1028     proto.dataConnection = null;
1029     
1030     /**
1031      * Object containing success and failure callbacks for loading data.
1032      * @property loadHandler
1033      * @type object
1034      */
1035     proto.loadHandler = null;
1036     
1037     /**
1038      * Provides a readable name for the tab.
1039      * @method toString
1040      * @return String
1041      */
1042     proto.toString = function() {
1043         var el = this.get('element');
1044         var id = el.id || el.tagName;
1045         return "Tab " + id; 
1046     };
1047     
1048     /**
1049      * Registers TabView specific properties.
1050      * @method initAttributes
1051      * @param {Object} attr Hash of initial attributes
1052      */
1053     proto.initAttributes = function(attr) {
1054         attr = attr || {};
1055         Tab.superclass.initAttributes.call(this, attr);
1056         
1057         var el = this.get('element');
1058         
1059         /**
1060          * The event that triggers the tab's activation.
1061          * @config activationEvent
1062          * @type String
1063          */
1064         this.register('activationEvent', {
1065             value: attr.activationEvent || 'click'
1066         });        
1068         /**
1069          * The element that contains the tab's label.
1070          * @config labelEl
1071          * @type HTMLElement
1072          */
1073         this.register('labelEl', {
1074             value: attr.labelEl || _getlabelEl.call(this),
1075             method: function(value) {
1076                 var current = this.get('labelEl');
1078                 if (current) {
1079                     if (current == value) {
1080                         return false; // already set
1081                     }
1082                     
1083                     this.replaceChild(value, current);
1084                 } else if (el.firstChild) { // ensure label is firstChild by default
1085                     this.insertBefore(value, el.firstChild);
1086                 } else {
1087                     this.appendChild(value);
1088                 }  
1089             } 
1090         });
1092         /**
1093          * The tab's label text (or innerHTML).
1094          * @config label
1095          * @type String
1096          */
1097         this.register('label', {
1098             value: attr.label || _getLabel.call(this),
1099             method: function(value) {
1100                 var labelEl = this.get('labelEl');
1101                 if (!labelEl) { // create if needed
1102                     this.set('labelEl', _createlabelEl.call(this));
1103                 }
1104                 
1105                 _setLabel.call(this, value);
1106             }
1107         });
1108         
1109         /**
1110          * The HTMLElement that contains the tab's content.
1111          * @config contentEl
1112          * @type HTMLElement
1113          */
1114         this.register('contentEl', { // TODO: apply className?
1115             value: attr.contentEl || document.createElement('div'),
1116             method: function(value) {
1117                 var current = this.get('contentEl');
1119                 if (current) {
1120                     if (current == value) {
1121                         return false; // already set
1122                     }
1123                     this.replaceChild(value, current);
1124                 }
1125             }
1126         });
1127         
1128         /**
1129          * The tab's content.
1130          * @config content
1131          * @type String
1132          */
1133         this.register('content', {
1134             value: attr.content, // TODO: what about existing?
1135             method: function(value) {
1136                 this.get('contentEl').innerHTML = value;
1137             }
1138         });
1140         var _dataLoaded = false;
1141         
1142         /**
1143          * The tab's data source, used for loading content dynamically.
1144          * @config dataSrc
1145          * @type String
1146          */
1147         this.register('dataSrc', {
1148             value: attr.dataSrc
1149         });
1150         
1151         /**
1152          * Whether or not content should be reloaded for every view.
1153          * @config cacheData
1154          * @type Boolean
1155          * @default false
1156          */
1157         this.register('cacheData', {
1158             value: attr.cacheData || false,
1159             validator: Lang.isBoolean
1160         });
1161         
1162         /**
1163          * The method to use for the data request.
1164          * @config loadMethod
1165          * @type String
1166          * @default "GET"
1167          */
1168         this.register('loadMethod', {
1169             value: attr.loadMethod || 'GET',
1170             validator: Lang.isString
1171         });
1173         /**
1174          * Whether or not any data has been loaded from the server.
1175          * @config dataLoaded
1176          * @type Boolean
1177          */        
1178         this.register('dataLoaded', {
1179             value: false,
1180             validator: Lang.isBoolean,
1181             writeOnce: true
1182         });
1183         
1184         /**
1185          * Number if milliseconds before aborting and calling failure handler.
1186          * @config dataTimeout
1187          * @type Number
1188          * @default null
1189          */
1190         this.register('dataTimeout', {
1191             value: attr.dataTimeout || null,
1192             validator: Lang.isNumber
1193         });
1194         
1195         /**
1196          * Whether or not the tab is currently active.
1197          * If a dataSrc is set for the tab, the content will be loaded from
1198          * the given source.
1199          * @config active
1200          * @type Boolean
1201          */
1202         this.register('active', {
1203             value: attr.active || this.hasClass(this.ACTIVE_CLASSNAME),
1204             method: function(value) {
1205                 if (value === true) {
1206                     this.addClass(this.ACTIVE_CLASSNAME);
1207                     this.set('title', 'active');
1208                 } else {
1209                     this.removeClass(this.ACTIVE_CLASSNAME);
1210                     this.set('title', '');
1211                 }
1212             },
1213             validator: function(value) {
1214                 return Lang.isBoolean(value) && !this.get('disabled') ;
1215             }
1216         });
1217         
1218         /**
1219          * Whether or not the tab is disabled.
1220          * @config disabled
1221          * @type Boolean
1222          */
1223         this.register('disabled', {
1224             value: attr.disabled || this.hasClass(this.DISABLED_CLASSNAME),
1225             method: function(value) {
1226                 if (value === true) {
1227                     Dom.addClass(this.get('element'), this.DISABLED_CLASSNAME);
1228                 } else {
1229                     Dom.removeClass(this.get('element'), this.DISABLED_CLASSNAME);
1230                 }
1231             },
1232             validator: Lang.isBoolean
1233         });
1234         
1235         /**
1236          * The href of the tab's anchor element.
1237          * @config href
1238          * @type String
1239          * @default '#'
1240          */
1241         this.register('href', {
1242             value: attr.href || '#',
1243             method: function(value) {
1244                 this.getElementsByTagName('a')[0].href = value;
1245             },
1246             validator: Lang.isString
1247         });
1248         
1249         /**
1250          * The Whether or not the tab's content is visible.
1251          * @config contentVisible
1252          * @type Boolean
1253          * @default false
1254          */
1255         this.register('contentVisible', {
1256             value: attr.contentVisible,
1257             method: function(value) {
1258                 if (value == true) {
1259                     this.get('contentEl').style.display = 'block';
1260                     
1261                     if ( this.get('dataSrc') ) {
1262                      // load dynamic content unless already loaded and caching
1263                         if ( !this.get('dataLoaded') || !this.get('cacheData') ) {
1264                             _dataConnect.call(this);
1265                         }
1266                     }
1267                 } else {
1268                     this.get('contentEl').style.display = 'none';
1269                 }
1270             },
1271             validator: Lang.isBoolean
1272         });
1273     };
1274     
1275     var _createTabElement = function(attr) {
1276         var el = document.createElement('li');
1277         var a = document.createElement('a');
1278         
1279         a.href = attr.href || '#';
1280         
1281         el.appendChild(a);
1282         
1283         var label = attr.label || null;
1284         var labelEl = attr.labelEl || null;
1285         
1286         if (labelEl) { // user supplied labelEl
1287             if (!label) { // user supplied label
1288                 label = _getLabel.call(this, labelEl);
1289             }
1290         } else {
1291             labelEl = _createlabelEl.call(this);
1292         }
1293         
1294         a.appendChild(labelEl);
1295         
1296         return el;
1297     };
1298     
1299     var _getlabelEl = function() {
1300         return this.getElementsByTagName(this.LABEL_TAGNAME)[0];
1301     };
1302     
1303     var _createlabelEl = function() {
1304         var el = document.createElement(this.LABEL_TAGNAME);
1305         return el;
1306     };
1307     
1308     var _setLabel = function(label) {
1309         var el = this.get('labelEl');
1310         el.innerHTML = label;
1311     };
1312     
1313     var _getLabel = function() {
1314         var label,
1315             el = this.get('labelEl');
1316             
1317             if (!el) {
1318                 return undefined;
1319             }
1320         
1321         return el.innerHTML;
1322     };
1323     
1324     var _dataConnect = function() {
1325         if (!YAHOO.util.Connect) {
1326             YAHOO.log('YAHOO.util.Connect dependency not met',
1327                     'error', 'Tab');
1328             return false;
1329         }
1331         Dom.addClass(this.get('contentEl').parentNode, this.LOADING_CLASSNAME);
1332         
1333         this.dataConnection = YAHOO.util.Connect.asyncRequest(
1334             this.get('loadMethod'),
1335             this.get('dataSrc'), 
1336             {
1337                 success: function(o) {
1338                     this.loadHandler.success.call(this, o);
1339                     this.set('dataLoaded', true);
1340                     this.dataConnection = null;
1341                     Dom.removeClass(this.get('contentEl').parentNode,
1342                             this.LOADING_CLASSNAME);
1343                 },
1344                 failure: function(o) {
1345                     this.loadHandler.failure.call(this, o);
1346                     this.dataConnection = null;
1347                     Dom.removeClass(this.get('contentEl').parentNode,
1348                             this.LOADING_CLASSNAME);
1349                 },
1350                 scope: this,
1351                 timeout: this.get('dataTimeout')
1352             }
1353         );
1354     };
1355     
1356     YAHOO.widget.Tab = Tab;
1357     
1358     /**
1359      * Fires before the active state is changed.
1360      * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1361      * <p>If handler returns false, the change will be cancelled, and the value will not
1362      * be set.</p>
1363      * <p><strong>Event fields:</strong><br>
1364      * <code>&lt;String&gt; type</code> beforeActiveChange<br>
1365      * <code>&lt;Boolean&gt;
1366      * prevValue</code> the current value<br>
1367      * <code>&lt;Boolean&gt;
1368      * newValue</code> the new value</p>
1369      * <p><strong>Usage:</strong><br>
1370      * <code>var handler = function(e) {var previous = e.prevValue};<br>
1371      * myTabs.addListener('beforeActiveChange', handler);</code></p>
1372      * @event beforeActiveChange
1373      */
1374         
1375     /**
1376      * Fires after the active state is changed.
1377      * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1378      * <p><strong>Event fields:</strong><br>
1379      * <code>&lt;String&gt; type</code> activeChange<br>
1380      * <code>&lt;Boolean&gt;
1381      * prevValue</code> the previous value<br>
1382      * <code>&lt;Boolean&gt;
1383      * newValue</code> the updated value</p>
1384      * <p><strong>Usage:</strong><br>
1385      * <code>var handler = function(e) {var previous = e.prevValue};<br>
1386      * myTabs.addListener('activeChange', handler);</code></p>
1387      * @event activeChange
1388      */
1389      
1390     /**
1391      * Fires before the tab label is changed.
1392      * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1393      * <p>If handler returns false, the change will be cancelled, and the value will not
1394      * be set.</p>
1395      * <p><strong>Event fields:</strong><br>
1396      * <code>&lt;String&gt; type</code> beforeLabelChange<br>
1397      * <code>&lt;String&gt;
1398      * prevValue</code> the current value<br>
1399      * <code>&lt;String&gt;
1400      * newValue</code> the new value</p>
1401      * <p><strong>Usage:</strong><br>
1402      * <code>var handler = function(e) {var previous = e.prevValue};<br>
1403      * myTabs.addListener('beforeLabelChange', handler);</code></p>
1404      * @event beforeLabelChange
1405      */
1406         
1407     /**
1408      * Fires after the tab label is changed.
1409      * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1410      * <p><strong>Event fields:</strong><br>
1411      * <code>&lt;String&gt; type</code> labelChange<br>
1412      * <code>&lt;String&gt;
1413      * prevValue</code> the previous value<br>
1414      * <code>&lt;String&gt;
1415      * newValue</code> the updated value</p>
1416      * <p><strong>Usage:</strong><br>
1417      * <code>var handler = function(e) {var previous = e.prevValue};<br>
1418      * myTabs.addListener('labelChange', handler);</code></p>
1419      * @event labelChange
1420      */
1421      
1422     /**
1423      * Fires before the tab content is changed.
1424      * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1425      * <p>If handler returns false, the change will be cancelled, and the value will not
1426      * be set.</p>
1427      * <p><strong>Event fields:</strong><br>
1428      * <code>&lt;String&gt; type</code> beforeContentChange<br>
1429      * <code>&lt;String&gt;
1430      * prevValue</code> the current value<br>
1431      * <code>&lt;String&gt;
1432      * newValue</code> the new value</p>
1433      * <p><strong>Usage:</strong><br>
1434      * <code>var handler = function(e) {var previous = e.prevValue};<br>
1435      * myTabs.addListener('beforeContentChange', handler);</code></p>
1436      * @event beforeContentChange
1437      */
1438         
1439     /**
1440      * Fires after the tab content is changed.
1441      * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1442      * <p><strong>Event fields:</strong><br>
1443      * <code>&lt;String&gt; type</code> contentChange<br>
1444      * <code>&lt;String&gt;
1445      * prevValue</code> the previous value<br>
1446      * <code>&lt;Boolean&gt;
1447      * newValue</code> the updated value</p>
1448      * <p><strong>Usage:</strong><br>
1449      * <code>var handler = function(e) {var previous = e.prevValue};<br>
1450      * myTabs.addListener('contentChange', handler);</code></p>
1451      * @event contentChange
1452      */
1453 })();
1455 (function() {
1457     /**
1458      * The tabview module provides a widget for managing content bound to tabs.
1459      * @module tabview
1460      * @requires yahoo, dom, event
1461      *
1462      */
1463     /**
1464      * A widget to control tabbed views.
1465      * @namespace YAHOO.widget
1466      * @class TabView
1467      * @extends YAHOO.util.Element
1468      * @constructor
1469      * @param {HTMLElement | String | Object} el(optional) The html 
1470      * element that represents the TabView, or the attribute object to use. 
1471      * An element will be created if none provided.
1472      * @param {Object} attr (optional) A key map of the tabView's 
1473      * initial attributes.  Ignored if first arg is attributes object.
1474      */
1475     YAHOO.widget.TabView = function(el, attr) {
1476         attr = attr || {};
1477         if (arguments.length == 1 && !Lang.isString(el) && !el.nodeName) {
1478             attr = el; // treat first arg as attr object
1479             el = attr.element || null;
1480         }
1481         
1482         if (!el && !attr.element) { // create if we dont have one
1483             el = _createTabViewElement.call(this, attr);
1484         }
1485         YAHOO.widget.TabView.superclass.constructor.call(this, el, attr); 
1486     };
1488     YAHOO.extend(YAHOO.widget.TabView, YAHOO.util.Element);
1489     
1490     var proto = YAHOO.widget.TabView.prototype;
1491     var Dom = YAHOO.util.Dom;
1492     var Lang = YAHOO.util.Lang;
1493     var Event = YAHOO.util.Event;
1494     var Tab = YAHOO.widget.Tab;
1495     
1496     
1497     /**
1498      * The className to add when building from scratch. 
1499      * @property CLASSNAME
1500      * @default "navset"
1501      */
1502     proto.CLASSNAME = 'yui-navset';
1503     
1504     /**
1505      * The className of the HTMLElement containing the TabView's tab elements
1506      * to look for when building from existing markup, or to add when building
1507      * from scratch. 
1508      * All childNodes of the tab container are treated as Tabs when building
1509      * from existing markup.
1510      * @property TAB_PARENT_CLASSNAME
1511      * @default "nav"
1512      */
1513     proto.TAB_PARENT_CLASSNAME = 'yui-nav';
1514     
1515     /**
1516      * The className of the HTMLElement containing the TabView's label elements
1517      * to look for when building from existing markup, or to add when building
1518      * from scratch. 
1519      * All childNodes of the content container are treated as content elements when
1520      * building from existing markup.
1521      * @property CONTENT_PARENT_CLASSNAME
1522      * @default "nav-content"
1523      */
1524     proto.CONTENT_PARENT_CLASSNAME = 'yui-content';
1525     
1526     proto._tabParent = null;
1527     proto._contentParent = null; 
1528     
1529     /**
1530      * Adds a Tab to the TabView instance.  
1531      * If no index is specified, the tab is added to the end of the tab list.
1532      * @method addTab
1533      * @param {YAHOO.widget.Tab} tab A Tab instance to add.
1534      * @param {Integer} index The position to add the tab. 
1535      * @return void
1536      */
1537     proto.addTab = function(tab, index) {
1538         var tabs = this.get('tabs');
1539         if (!tabs) { // not ready yet
1540             this._queue[this._queue.length] = ['addTab', arguments];
1541             return false;
1542         }
1543         
1544         index = (index === undefined) ? tabs.length : index;
1545         
1546         var before = this.getTab(index);
1547         
1548         var self = this;
1549         var el = this.get('element');
1550         var tabParent = this._tabParent;
1551         var contentParent = this._contentParent;
1553         var tabElement = tab.get('element');
1554         var contentEl = tab.get('contentEl');
1556         if ( before ) {
1557             tabParent.insertBefore(tabElement, before.get('element'));
1558         } else {
1559             tabParent.appendChild(tabElement);
1560         }
1562         if ( contentEl && !Dom.isAncestor(contentParent, contentEl) ) {
1563             contentParent.appendChild(contentEl);
1564         }
1565         
1566         if ( !tab.get('active') ) {
1567             tab.set('contentVisible', false, true); /* hide if not active */
1568         } else {
1569             this.set('activeTab', tab, true);
1570             
1571         }
1573         var activate = function(e) {
1574             YAHOO.util.Event.preventDefault(e);
1575             self.set('activeTab', this);
1576         };
1577         
1578         tab.addListener( tab.get('activationEvent'), activate);
1579         
1580         tab.addListener('activationEventChange', function(e) {
1581             if (e.prevValue != e.newValue) {
1582                 tab.removeListener(e.prevValue, activate);
1583                 tab.addListener(e.newValue, activate);
1584             }
1585         });
1586         
1587         tabs.splice(index, 0, tab);
1588     };
1590     /**
1591      * Routes childNode events.
1592      * @method DOMEventHandler
1593      * @param {event} e The Dom event that is being handled.
1594      * @return void
1595      */
1596     proto.DOMEventHandler = function(e) {
1597         var el = this.get('element');
1598         var target = YAHOO.util.Event.getTarget(e);
1599         var tabParent = this._tabParent;
1600         
1601         if (Dom.isAncestor(tabParent, target) ) {
1602             var tabEl;
1603             var tab = null;
1604             var contentEl;
1605             var tabs = this.get('tabs');
1607             for (var i = 0, len = tabs.length; i < len; i++) {
1608                 tabEl = tabs[i].get('element');
1609                 contentEl = tabs[i].get('contentEl');
1611                 if ( target == tabEl || Dom.isAncestor(tabEl, target) ) {
1612                     tab = tabs[i];
1613                     break; // note break
1614                 }
1615             } 
1616             
1617             if (tab) {
1618                 tab.fireEvent(e.type, e);
1619             }
1620         }
1621     };
1622     
1623     /**
1624      * Returns the Tab instance at the specified index.
1625      * @method getTab
1626      * @param {Integer} index The position of the Tab.
1627      * @return YAHOO.widget.Tab
1628      */
1629     proto.getTab = function(index) {
1630         return this.get('tabs')[index];
1631     };
1632     
1633     /**
1634      * Returns the index of given tab.
1635      * @method getTabIndex
1636      * @param {YAHOO.widget.Tab} tab The tab whose index will be returned.
1637      * @return int
1638      */
1639     proto.getTabIndex = function(tab) {
1640         var index = null;
1641         var tabs = this.get('tabs');
1642         for (var i = 0, len = tabs.length; i < len; ++i) {
1643             if (tab == tabs[i]) {
1644                 index = i;
1645                 break;
1646             }
1647         }
1648         
1649         return index;
1650     };
1651     
1652     /**
1653      * Removes the specified Tab from the TabView.
1654      * @method removeTab
1655      * @param {YAHOO.widget.Tab} item The Tab instance to be removed.
1656      * @return void
1657      */
1658     proto.removeTab = function(tab) {
1659         var tabCount = this.get('tabs').length;
1661         var index = this.getTabIndex(tab);
1662         var nextIndex = index + 1;
1663         if ( tab == this.get('activeTab') ) { // select next tab
1664             if (tabCount > 1) {
1665                 if (index + 1 == tabCount) {
1666                     this.set('activeIndex', index - 1);
1667                 } else {
1668                     this.set('activeIndex', index + 1);
1669                 }
1670             }
1671         }
1672         
1673         this._tabParent.removeChild( tab.get('element') );
1674         this._contentParent.removeChild( tab.get('contentEl') );
1675         this._configs.tabs.value.splice(index, 1);
1676         
1677     };
1678     
1679     /**
1680      * Provides a readable name for the TabView instance.
1681      * @method toString
1682      * @return String
1683      */
1684     proto.toString = function() {
1685         var name = this.get('id') || this.get('tagName');
1686         return "TabView " + name; 
1687     };
1688     
1689     /**
1690      * The transiton to use when switching between tabs.
1691      * @method contentTransition
1692      */
1693     proto.contentTransition = function(newTab, oldTab) {
1694         newTab.set('contentVisible', true);
1695         oldTab.set('contentVisible', false);
1696     };
1697     
1698     /**
1699      * Registers TabView specific properties.
1700      * @method initAttributes
1701      * @param {Object} attr Hash of initial attributes
1702      */
1703     proto.initAttributes = function(attr) {
1704         YAHOO.widget.TabView.superclass.initAttributes.call(this, attr);
1705         
1706         if (!attr.orientation) {
1707             attr.orientation = 'top';
1708         }
1709         
1710         var el = this.get('element');
1711         
1712         /**
1713          * The Tabs belonging to the TabView instance.
1714          * @config tabs
1715          * @type Array
1716          */
1717         this.register('tabs', {
1718             value: [],
1719             readOnly: true
1720         });
1722         /**
1723          * The container of the tabView's label elements.
1724          * @property _tabParent
1725          * @private
1726          * @type HTMLElement
1727          */
1728         this._tabParent = 
1729                 this.getElementsByClassName(this.TAB_PARENT_CLASSNAME,
1730                         'ul' )[0] || _createTabParent.call(this);
1731             
1732         /**
1733          * The container of the tabView's content elements.
1734          * @property _contentParent
1735          * @type HTMLElement
1736          * @private
1737          */
1738         this._contentParent = 
1739                 this.getElementsByClassName(this.CONTENT_PARENT_CLASSNAME,
1740                         'div')[0] ||  _createContentParent.call(this);
1741         
1742         /**
1743          * How the Tabs should be oriented relative to the TabView.
1744          * @config orientation
1745          * @type String
1746          * @default "top"
1747          */
1748         this.register('orientation', {
1749             value: attr.orientation,
1750             method: function(value) {
1751                 var current = this.get('orientation');
1752                 this.addClass('yui-navset-' + value);
1753                 
1754                 if (current != value) {
1755                     this.removeClass('yui-navset-' + current);
1756                 }
1757                 
1758                 switch(value) {
1759                     case 'bottom':
1760                     this.appendChild(this._tabParent);
1761                     break;
1762                 }
1763             }
1764         });
1765         
1766         /**
1767          * The index of the tab currently active.
1768          * @config activeIndex
1769          * @type Int
1770          */
1771         this.register('activeIndex', {
1772             value: attr.activeIndex,
1773             method: function(value) {
1774                 this.set('activeTab', this.getTab(value));
1775             },
1776             validator: function(value) {
1777                 return !this.getTab(value).get('disabled'); // cannot activate if disabled
1778             }
1779         });
1780         
1781         /**
1782          * The tab currently active.
1783          * @config activeTab
1784          * @type YAHOO.widget.Tab
1785          */
1786         this.register('activeTab', {
1787             value: attr.activeTab,
1788             method: function(tab) {
1789                 var activeTab = this.get('activeTab');
1790                 
1791                 if (tab) {  
1792                     tab.set('active', true);
1793                 }
1794                 
1795                 if (activeTab && activeTab != tab) {
1796                     activeTab.set('active', false);
1797                 }
1798                 
1799                 if (activeTab && tab != activeTab) { // no transition if only 1
1800                     this.contentTransition(tab, activeTab);
1801                 } else if (tab) {
1802                     tab.set('contentVisible', true);
1803                 }
1804             },
1805             validator: function(value) {
1806                 return !value.get('disabled'); // cannot activate if disabled
1807             }
1808         });
1810         if ( this._tabParent ) {
1811             _initTabs.call(this);
1812         }
1813         
1814         for (var type in this.DOM_EVENTS) {
1815             if ( this.DOM_EVENTS.hasOwnProperty(type) ) {
1816                 this.addListener.call(this, type, this.DOMEventHandler);
1817             }
1818         }
1819     };
1820     
1821     /**
1822      * Creates Tab instances from a collection of HTMLElements.
1823      * @method createTabs
1824      * @private
1825      * @param {Array|HTMLCollection} elements The elements to use for Tabs.
1826      * @return void
1827      */
1828     var _initTabs = function() {
1829         var tab,
1830             attr,
1831             contentEl;
1832             
1833         var el = this.get('element');   
1834         var tabs = _getChildNodes(this._tabParent);
1835         var contentElements = _getChildNodes(this._contentParent);
1837         for (var i = 0, len = tabs.length; i < len; ++i) {
1838             attr = {};
1839             
1840             if (contentElements[i]) {
1841                 attr.contentEl = contentElements[i];
1842             }
1844             tab = new YAHOO.widget.Tab(tabs[i], attr);
1845             this.addTab(tab);
1846             
1847             if (tab.hasClass(tab.ACTIVE_CLASSNAME) ) {
1848                 this._configs.activeTab.value = tab; // dont invoke method
1849             }
1850         }
1851     };
1852     
1853     var _createTabViewElement = function(attr) {
1854         var el = document.createElement('div');
1856         if ( this.CLASSNAME ) {
1857             el.className = this.CLASSNAME;
1858         }
1859         
1860         return el;
1861     };
1862     
1863     var _createTabParent = function(attr) {
1864         var el = document.createElement('ul');
1866         if ( this.TAB_PARENT_CLASSNAME ) {
1867             el.className = this.TAB_PARENT_CLASSNAME;
1868         }
1869         
1870         this.get('element').appendChild(el);
1871         
1872         return el;
1873     };
1874     
1875     var _createContentParent = function(attr) {
1876         var el = document.createElement('div');
1878         if ( this.CONTENT_PARENT_CLASSNAME ) {
1879             el.className = this.CONTENT_PARENT_CLASSNAME;
1880         }
1881         
1882         this.get('element').appendChild(el);
1883         
1884         return el;
1885     };
1886     
1887     var _getChildNodes = function(el) {
1888         var nodes = [];
1889         var childNodes = el.childNodes;
1890         
1891         for (var i = 0, len = childNodes.length; i < len; ++i) {
1892             if (childNodes[i].nodeType == 1) {
1893                 nodes[nodes.length] = childNodes[i];
1894             }
1895         }
1896         
1897         return nodes;
1898     };
1901  * Fires before the activeTab is changed.
1902  * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1903  * <p>If handler returns false, the change will be cancelled, and the value will not
1904  * be set.</p>
1905  * <p><strong>Event fields:</strong><br>
1906  * <code>&lt;String&gt; type</code> beforeActiveTabChange<br>
1907  * <code>&lt;<a href="YAHOO.widget.Tab.html">YAHOO.widget.Tab</a>&gt;
1908  * prevValue</code> the currently active tab<br>
1909  * <code>&lt;<a href="YAHOO.widget.Tab.html">YAHOO.widget.Tab</a>&gt;
1910  * newValue</code> the tab to be made active</p>
1911  * <p><strong>Usage:</strong><br>
1912  * <code>var handler = function(e) {var previous = e.prevValue};<br>
1913  * myTabs.addListener('beforeActiveTabChange', handler);</code></p>
1914  * @event beforeActiveTabChange
1915  */
1916     
1918  * Fires after the activeTab is changed.
1919  * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1920  * <p><strong>Event fields:</strong><br>
1921  * <code>&lt;String&gt; type</code> activeTabChange<br>
1922  * <code>&lt;<a href="YAHOO.widget.Tab.html">YAHOO.widget.Tab</a>&gt;
1923  * prevValue</code> the formerly active tab<br>
1924  * <code>&lt;<a href="YAHOO.widget.Tab.html">YAHOO.widget.Tab</a>&gt;
1925  * newValue</code> the new active tab</p>
1926  * <p><strong>Usage:</strong><br>
1927  * <code>var handler = function(e) {var previous = e.prevValue};<br>
1928  * myTabs.addListener('activeTabChange', handler);</code></p>
1929  * @event activeTabChange
1930  */
1933  * Fires before the orientation is changed.
1934  * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1935  * <p>If handler returns false, the change will be cancelled, and the value will not
1936  * be set.</p>
1937  * <p><strong>Event fields:</strong><br>
1938  * <code>&lt;String&gt; type</code> beforeOrientationChange<br>
1939  * <code>&lt;String&gt;
1940  * prevValue</code> the current orientation<br>
1941  * <code>&lt;String&gt;
1942  * newValue</code> the new orientation to be applied</p>
1943  * <p><strong>Usage:</strong><br>
1944  * <code>var handler = function(e) {var previous = e.prevValue};<br>
1945  * myTabs.addListener('beforeOrientationChange', handler);</code></p>
1946  * @event beforeOrientationChange
1947  */
1948     
1950  * Fires after the orientation is changed.
1951  * <p>See: <a href="YAHOO.util.Element.html#addListener">Element.addListener</a></p>
1952  * <p><strong>Event fields:</strong><br>
1953  * <code>&lt;String&gt; type</code> orientationChange<br>
1954  * <code>&lt;String&gt;
1955  * prevValue</code> the former orientation<br>
1956  * <code>&lt;String&gt;
1957  * newValue</code> the new orientation</p>
1958  * <p><strong>Usage:</strong><br>
1959  * <code>var handler = function(e) {var previous = e.prevValue};<br>
1960  * myTabs.addListener('orientationChange', handler);</code></p>
1961  * @event orientationChange
1962  */
1963 })();