src/cm/media/js/lib/yui/yui_3.10.3/build/button-group/button-group.js
author gibus
Tue, 16 Jul 2013 14:29:46 +0200
changeset 525 89ef5ed3c48b
permissions -rw-r--r--
Upgrades to yui 3.10.3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
525
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     1
/*
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     2
YUI 3.10.3 (build 2fb5187)
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     3
Copyright 2013 Yahoo! Inc. All rights reserved.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     4
Licensed under the BSD License.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     5
http://yuilibrary.com/license/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     6
*/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     7
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     8
YUI.add('button-group', function (Y, NAME) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     9
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    10
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    11
 * A Widget to create groups of buttons
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    12
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    13
 * @module button-group
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    14
 * @since 3.5.0
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    15
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    16
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    17
var CONTENT_BOX = "contentBox",
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    18
    CLICK_EVENT = "click",
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    19
    CLASS_NAMES = Y.ButtonCore.CLASS_NAMES;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    20
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    21
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    22
 * Creates a ButtonGroup
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    23
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    24
 * @class ButtonGroup
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    25
 * @extends Widget
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    26
 * @param config {Object} Configuration object
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    27
 * @constructor
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    28
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    29
function ButtonGroup() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    30
    ButtonGroup.superclass.constructor.apply(this, arguments);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    31
}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    32
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    33
/* ButtonGroup extends Widget */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    34
Y.ButtonGroup = Y.extend(ButtonGroup, Y.Widget, {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    35
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    36
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    37
     * @method renderUI
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    38
     * @description Creates a visual representation of the widget based on existing parameters.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    39
     * @public
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    40
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    41
    renderUI: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    42
        this.getButtons().plug(Y.Plugin.Button);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    43
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    44
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    45
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    46
     * @method bindUI
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    47
     * @description Hooks up events for the widget
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    48
     * @public
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    49
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    50
    bindUI: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    51
        var group = this,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    52
            cb = group.get(CONTENT_BOX);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    53
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    54
        cb.delegate(CLICK_EVENT, group._handleClick, Y.ButtonGroup.BUTTON_SELECTOR, group);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    55
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    56
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    57
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    58
     * @method getButtons
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    59
     * @description Returns all buttons inside this this button group
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    60
     * @public
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    61
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    62
    getButtons: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    63
        var cb = this.get(CONTENT_BOX);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    64
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    65
        return cb.all(Y.ButtonGroup.BUTTON_SELECTOR);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    66
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    67
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    68
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    69
     * @method getSelectedButtons
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    70
     * @description Returns all Y.Buttons instances that are selected
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    71
     * @public
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    72
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    73
    getSelectedButtons: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    74
        var group = this,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    75
            selected = [],
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    76
            buttons = group.getButtons(),
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    77
            selectedClass = ButtonGroup.CLASS_NAMES.SELECTED;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    78
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    79
        buttons.each(function(node){
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    80
            if (node.hasClass(selectedClass)){
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    81
                selected.push(node);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    82
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    83
        });
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    84
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    85
        return selected;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    86
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    87
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    88
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    89
     * @method getSelectedValues
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    90
     * @description Returns the values of all Y.Button instances that are selected
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    91
     * @public
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    92
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    93
    getSelectedValues: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    94
        var selected = this.getSelectedButtons(),
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    95
            values = [],
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    96
            value;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    97
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    98
        Y.Array.each(selected, function(node){
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    99
            value = node.getContent();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   100
            values.push(value);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   101
        });
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   102
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   103
        return values;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   104
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   105
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   106
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   107
     * @method _handleClick
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   108
     * @description A delegated click handler for when any button is clicked in the content box
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   109
     * @param e {Object} An event object
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   110
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   111
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   112
    _handleClick: function(e){
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   113
        var group = this,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   114
            clickedNode = e.target.ancestor('.' + ButtonGroup.CLASS_NAMES.BUTTON, true),
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   115
            type = group.get('type'),
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   116
            selectedClass = ButtonGroup.CLASS_NAMES.SELECTED,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   117
            isSelected = clickedNode.hasClass(selectedClass),
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   118
            buttons;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   119
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   120
        // TODO: Anything for 'push' groups?
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   121
        if (type === 'checkbox') {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   122
            clickedNode.toggleClass(selectedClass, !isSelected);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   123
            /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   124
             * @event selectionChange
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   125
             * @description fires when any button in the group changes its checked status
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   126
             * @param {Event} the event object. It contains an "originEvent" property
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   127
             * linking to the original DOM event that triggered the selection change
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   128
             */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   129
            group.fire('selectionChange', {originEvent: e});
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   130
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   131
        else if (type === 'radio' && !isSelected) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   132
            buttons = group.getButtons(); // Todo: getSelectedButtons()? Need it to return an arraylist then.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   133
            buttons.removeClass(selectedClass);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   134
            clickedNode.addClass(selectedClass);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   135
            group.fire('selectionChange', {originEvent: e});
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   136
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   137
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   138
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   139
}, {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   140
    // Y.ButtonGroup static properties
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   141
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   142
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   143
     * The identity of the widget.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   144
     *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   145
     * @property NAME
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   146
     * @type {String}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   147
     * @default 'buttongroup'
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   148
     * @readOnly
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   149
     * @protected
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   150
     * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   151
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   152
    NAME: 'buttongroup',
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   153
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   154
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   155
     * Static property used to define the default attribute configuration of
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   156
     * the Widget.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   157
     *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   158
     * @property ATTRS
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   159
     * @type {Object}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   160
     * @protected
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   161
     * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   162
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   163
    ATTRS: {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   164
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   165
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   166
         * @attribute type
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   167
         * @type String
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   168
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   169
        type: {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   170
            writeOnce: 'initOnly',
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   171
            value: 'radio'
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   172
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   173
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   174
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   175
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   176
     * List of class names to use for ButtonGroups
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   177
     *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   178
     * @property CLASS_NAMES
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   179
     * @type {Object}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   180
     * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   181
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   182
    CLASS_NAMES: CLASS_NAMES,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   183
    
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   184
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   185
     * Selector used to find buttons inside a ButtonGroup
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   186
     * @property BUTTON_SELECTOR
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   187
     * @type {String}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   188
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   189
    BUTTON_SELECTOR: "button, input[type=button], input[type=reset], input[type=submit], input[type=radio], input[type=checkbox]"
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   190
});
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   191
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   192
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   193
}, '3.10.3', {"requires": ["button-plugin", "cssbutton", "widget"]});