src/cm/media/js/lib/yui/yui3-3.15.0/build/array-invoke/array-invoke-debug.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('array-invoke', 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
@module collection
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     5
@submodule array-invoke
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     6
*/
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     7
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     8
/**
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
     9
Executes a named method on each item in an array of objects. Items in the array
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    10
that do not have a function by that name will be skipped.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    11
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    12
@example
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    13
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    14
    Y.Array.invoke(arrayOfDrags, 'plug', Y.Plugin.DDProxy);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    15
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    16
@method invoke
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    17
@param {Array} items Array of objects supporting the named method.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    18
@param {String} name the name of the method to execute on each item.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    19
@param {Any} [args*] Any number of additional args are passed as parameters to
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    20
  the execution of the named method.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    21
@return {Array} All return values, indexed according to the item index.
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    22
@static
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    23
@for Array
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    24
**/
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    25
Y.Array.invoke = function(items, name) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    26
    var args = Y.Array(arguments, 2, true),
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    27
        isFunction = Y.Lang.isFunction,
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    28
        ret = [];
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    29
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    30
    Y.Array.each(Y.Array(items), function(item, i) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    31
        if (item && isFunction(item[name])) {
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    32
            ret[i] = item[name].apply(item, args);
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    33
        }
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    34
    });
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    35
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    36
    return ret;
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
e16a97fb364a Use YUI 3.15
gibus
parents:
diff changeset
    40
}, '@VERSION@', {"requires": ["yui-base"]});