← Back to branch summary

~michael.nelson/ubuntu-webcatalog/1267731-import-sca-apps-error

« back to all changes in this revision

Viewing changes to src/webcatalog/static/yui/3.10.3/build/node-event-delegate/node-event-delegate.js

  • Committer: Tarmac
  • Author(s): Stephen Stewart
  • Date: 2013-06-26 09:19:32 UTC
  • mfrom: (184.1.4 ubuntu-global-nav)
  • Revision ID: tarmac-20130626091932-8urtuli368k8p7ds
[r=beuno,jonas-drange] add ubuntu global nav to apps.ubuntu.com

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/webcatalog/static/yui/3.10.3/build/node-event-delegate/node-event-delegate.js
 
1
/*
 
2
YUI 3.10.3 (build 2fb5187)
 
3
Copyright 2013 Yahoo! Inc. All rights reserved.
 
4
Licensed under the BSD License.
 
5
http://yuilibrary.com/license/
 
6
*/
 
7
 
 
8
YUI.add('node-event-delegate', function (Y, NAME) {
 
9
 
 
10
/**
 
11
 * Functionality to make the node a delegated event container
 
12
 * @module node
 
13
 * @submodule node-event-delegate
 
14
 */
 
15
 
 
16
/**
 
17
 * <p>Sets up a delegation listener for an event occurring inside the Node.
 
18
 * The delegated event will be verified against a supplied selector or
 
19
 * filtering function to test if the event references at least one node that
 
20
 * should trigger the subscription callback.</p>
 
21
 *
 
22
 * <p>Selector string filters will trigger the callback if the event originated
 
23
 * from a node that matches it or is contained in a node that matches it.
 
24
 * Function filters are called for each Node up the parent axis to the
 
25
 * subscribing container node, and receive at each level the Node and the event
 
26
 * object.  The function should return true (or a truthy value) if that Node
 
27
 * should trigger the subscription callback.  Note, it is possible for filters
 
28
 * to match multiple Nodes for a single event.  In this case, the delegate
 
29
 * callback will be executed for each matching Node.</p>
 
30
 *
 
31
 * <p>For each matching Node, the callback will be executed with its 'this'
 
32
 * object set to the Node matched by the filter (unless a specific context was
 
33
 * provided during subscription), and the provided event's
 
34
 * <code>currentTarget</code> will also be set to the matching Node.  The
 
35
 * containing Node from which the subscription was originally made can be
 
36
 * referenced as <code>e.container</code>.
 
37
 *
 
38
 * @method delegate
 
39
 * @param type {String} the event type to delegate
 
40
 * @param fn {Function} the callback function to execute.  This function
 
41
 *              will be provided the event object for the delegated event.
 
42
 * @param spec {String|Function} a selector that must match the target of the
 
43
 *              event or a function to test target and its parents for a match
 
44
 * @param context {Object} optional argument that specifies what 'this' refers to.
 
45
 * @param args* {any} 0..n additional arguments to pass on to the callback function.
 
46
 *              These arguments will be added after the event object.
 
47
 * @return {EventHandle} the detach handle
 
48
 * @for Node
 
49
 */
 
50
Y.Node.prototype.delegate = function(type) {
 
51
 
 
52
    var args = Y.Array(arguments, 0, true),
 
53
        index = (Y.Lang.isObject(type) && !Y.Lang.isArray(type)) ? 1 : 2;
 
54
 
 
55
    args.splice(index, 0, this._node);
 
56
 
 
57
    return Y.delegate.apply(Y, args);
 
58
};
 
59
 
 
60
 
 
61
}, '3.10.3', {"requires": ["node-base", "event-delegate"]});