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