# Yahoo! UI Library

### tabview 3.1.1

Yahoo! UI Library > tabview > tab.js (source view)
Search:
Filters Show Private Show Protected Show Deprecated

    var Lang = Y.Lang,
        _queries = Y.TabviewBase._queries,
        _classNames = Y.TabviewBase._classNames,
        getClassName = Y.ClassNameManager.getClassName;

    /**
     * Provides Tab instances for use with TabView
     * @param config {Object} Object literal specifying tabview configuration properties.
     *
     * @class Tab
     * @constructor
     * @extends Widget
     * @uses WidgetChild
     */
    Y.Tab = Y.Base.create('tab', Y.Widget, [Y.WidgetChild], {
        BOUNDING_TEMPLATE: '<li class="' + _classNames.tab + '"></li>',
        CONTENT_TEMPLATE: '<a class="' + _classNames.tabLabel + '"></a>',
        PANEL_TEMPLATE: '<div class="' + _classNames.tabPanel + '"></div>',

        _uiSetSelectedPanel: function(selected) {
            this.get('panelNode').toggleClass(_classNames.selectedPanel, selected);
        },

        _afterTabSelectedChange: function(event) {
           this._uiSetSelectedPanel(event.newVal);
        },

        _afterParentChange: function(e) {
            if (!e.newVal) {
                this._remove();
            } else {
                this._add();
            }
        },

        _initAria: function() {
            var anchor = this.get('contentBox'),
                id = anchor.get('id'),
                panel = this.get('panelNode');

            if (!id) {
                id = Y.guid();
                anchor.set('id', id);
            }
            //  Apply the ARIA roles, states and properties to each tab
            anchor.set('role', 'tab');
            anchor.get('parentNode').set('role', 'presentation');

            //  Apply the ARIA roles, states and properties to each panel
            panel.setAttrs({
                role: 'tabpanel',
                'aria-labelledby': id
            });
        },

        syncUI: function() {
            this.set('label', this.get('label'));
            this.set('content', this.get('content'));
            this._uiSetSelectedPanel(this.get('selected'));
        },

        bindUI: function() {
           this.after('selectedChange', this._afterTabSelectedChange);
           this.after('parentChange', this._afterParentChange);
        },

        renderUI: function() {
            this._renderPanel();
            this._initAria();
        },

        _renderPanel: function() {
            this.get('parent').get('contentBox')
                .one(_queries.tabviewPanel).appendChild(this.get('panelNode'));
        },

        _add: function() {
            var parentNode = this.get('parent').get('contentBox'),
                list = parentNode.one(_queries.tabviewList),
                tabviewPanel = parentNode.one(_queries.tabviewPanel);
            if (list) {
                list.appendChild(this.get('boundingBox'));
            }

            if (tabviewPanel) {
                tabviewPanel.appendChild(this.get('panelNode'));
            }
        },

        _remove: function() {
            this.get('boundingBox').remove();
            this.get('panelNode').remove();
        },

        _onActivate: function(e) {
             if (e.target === this) {
                 //  Prevent the browser from navigating to the URL specified by the
                 //  anchor's href attribute.
                 e.domEvent.preventDefault();
                 e.target.set('selected', 1);
             }
        },

        initializer: function() {
           this.publish(this.get('triggerEvent'), {
               defaultFn: this._onActivate
           });
        },

        _defLabelSetter: function(label) {
            this.get('contentBox').setContent(label);
            return label;
        },

        _defContentSetter: function(content) {
            this.get('panelNode').setContent(content);
            return content;
        },

        _defPanelNodeValueFn: function() {
            var id,
                href = this.get('contentBox').get('href') || '',
                panel;

            if (href.charAt(0) === '#') {
                id = href.substr(1);
                panel = Y.one(href);
            } else {
                id = Y.guid();
            }

            if (!panel) {
                panel = Y.Node.create(this.PANEL_TEMPLATE);
                panel.set('id', id);
            }
            return panel;
        }
    }, {
        ATTRS: {
            /**
             * @attribute triggerEvent
             * @default "click"
             * @type String
             */
            triggerEvent: {
                value: 'click'
            },

            /**
             * @attribute label
             * @type String
             */
            label: {
                setter: '_defLabelSetter',
                validator: Lang.isString
            },

            /**
             * @attribute content
             * @type String
             */
            content: {
                setter: '_defContentSetter',
                validator: Lang.isString
            },

            /**
             * @attribute panelNode
             * @type Y.Node
             */
            panelNode: {
                valueFn: '_defPanelNodeValueFn'
            },

            tabIndex: {
                value: null,
                validator: '_validTabIndex'
            }

        },

        HTML_PARSER: {
            selected: function(contentBox) {
                return this.get('boundingBox').hasClass(_classNames.selectedTab);
            }
        }

    });

Copyright © 2010 Yahoo! Inc. All rights reserved.