src/cm/media/js/lib/yui/yui_3.10.3/build/event-base/event-base-debug.js
author Yves-Marie Haussonne <ymh.work+github@gmail.com>
Fri, 09 May 2014 18:35:26 +0200
changeset 656 a84519031134
parent 525 89ef5ed3c48b
permissions -rw-r--r--
add link to "privacy policy" in the header test
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
(function () {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     9
var GLOBAL_ENV = YUI.Env;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    10
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    11
if (!GLOBAL_ENV._ready) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    12
    GLOBAL_ENV._ready = function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    13
        GLOBAL_ENV.DOMReady = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    14
        GLOBAL_ENV.remove(YUI.config.doc, 'DOMContentLoaded', GLOBAL_ENV._ready);
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
    GLOBAL_ENV.add(YUI.config.doc, 'DOMContentLoaded', GLOBAL_ENV._ready);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    18
}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    19
})();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    20
YUI.add('event-base', function (Y, NAME) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    21
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    22
/*
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    23
 * DOM event listener abstraction layer
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    24
 * @module event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    25
 * @submodule event-base
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    26
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    27
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    28
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    29
 * The domready event fires at the moment the browser's DOM is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    30
 * usable. In most cases, this is before images are fully
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    31
 * downloaded, allowing you to provide a more responsive user
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    32
 * interface.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    33
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    34
 * In YUI 3, domready subscribers will be notified immediately if
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    35
 * that moment has already passed when the subscription is created.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    36
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    37
 * One exception is if the yui.js file is dynamically injected into
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    38
 * the page.  If this is done, you must tell the YUI instance that
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    39
 * you did this in order for DOMReady (and window load events) to
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    40
 * fire normally.  That configuration option is 'injected' -- set
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    41
 * it to true if the yui.js script is not included inline.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    42
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    43
 * This method is part of the 'event-ready' module, which is a
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    44
 * submodule of 'event'.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    45
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    46
 * @event domready
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    47
 * @for YUI
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    48
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    49
Y.publish('domready', {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    50
    fireOnce: true,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    51
    async: true
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    52
});
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    53
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    54
if (YUI.Env.DOMReady) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    55
    Y.fire('domready');
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    56
} else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    57
    Y.Do.before(function() { Y.fire('domready'); }, YUI.Env, '_ready');
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    58
}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    59
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    60
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    61
 * Custom event engine, DOM event listener abstraction layer, synthetic DOM
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    62
 * events.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    63
 * @module event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    64
 * @submodule event-base
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    65
 */
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
 * Wraps a DOM event, properties requiring browser abstraction are
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    69
 * fixed here.  Provids a security layer when required.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    70
 * @class DOMEventFacade
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    71
 * @param ev {Event} the DOM event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    72
 * @param currentTarget {HTMLElement} the element the listener was attached to
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    73
 * @param wrapper {Event.Custom} the custom event wrapper for this DOM event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    74
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    75
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    76
    var ua = Y.UA,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    77
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    78
    EMPTY = {},
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    79
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    80
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    81
     * webkit key remapping required for Safari < 3.1
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    82
     * @property webkitKeymap
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    83
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    84
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    85
    webkitKeymap = {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    86
        63232: 38, // up
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    87
        63233: 40, // down
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    88
        63234: 37, // left
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    89
        63235: 39, // right
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    90
        63276: 33, // page up
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    91
        63277: 34, // page down
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    92
        25:     9, // SHIFT-TAB (Safari provides a different key code in
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    93
                   // this case, even though the shiftKey modifier is set)
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    94
        63272: 46, // delete
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    95
        63273: 36, // home
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    96
        63275: 35  // end
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    97
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    98
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    99
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   100
     * Returns a wrapped node.  Intended to be used on event targets,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   101
     * so it will return the node's parent if the target is a text
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   102
     * node.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   103
     *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   104
     * If accessing a property of the node throws an error, this is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   105
     * probably the anonymous div wrapper Gecko adds inside text
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   106
     * nodes.  This likely will only occur when attempting to access
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   107
     * the relatedTarget.  In this case, we now return null because
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   108
     * the anonymous div is completely useless and we do not know
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   109
     * what the related target was because we can't even get to
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   110
     * the element's parent node.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   111
     *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   112
     * @method resolve
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   113
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   114
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   115
    resolve = function(n) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   116
        if (!n) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   117
            return n;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   118
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   119
        try {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   120
            if (n && 3 == n.nodeType) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   121
                n = n.parentNode;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   122
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   123
        } catch(e) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   124
            return null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   125
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   126
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   127
        return Y.one(n);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   128
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   129
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   130
    DOMEventFacade = function(ev, currentTarget, wrapper) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   131
        this._event = ev;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   132
        this._currentTarget = currentTarget;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   133
        this._wrapper = wrapper || EMPTY;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   134
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   135
        // if not lazy init
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   136
        this.init();
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
Y.extend(DOMEventFacade, Object, {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   140
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   141
    init: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   142
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   143
        var e = this._event,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   144
            overrides = this._wrapper.overrides,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   145
            x = e.pageX,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   146
            y = e.pageY,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   147
            c,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   148
            currentTarget = this._currentTarget;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   149
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   150
        this.altKey   = e.altKey;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   151
        this.ctrlKey  = e.ctrlKey;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   152
        this.metaKey  = e.metaKey;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   153
        this.shiftKey = e.shiftKey;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   154
        this.type     = (overrides && overrides.type) || e.type;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   155
        this.clientX  = e.clientX;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   156
        this.clientY  = e.clientY;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   157
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   158
        this.pageX = x;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   159
        this.pageY = y;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   160
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   161
        // charCode is unknown in keyup, keydown. keyCode is unknown in keypress.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   162
        // FF 3.6 - 8+? pass 0 for keyCode in keypress events.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   163
        // Webkit, FF 3.6-8+?, and IE9+? pass 0 for charCode in keydown, keyup.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   164
        // Webkit and IE9+? duplicate charCode in keyCode.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   165
        // Opera never sets charCode, always keyCode (though with the charCode).
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   166
        // IE6-8 don't set charCode or which.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   167
        // All browsers other than IE6-8 set which=keyCode in keydown, keyup, and
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   168
        // which=charCode in keypress.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   169
        //
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   170
        // Moral of the story: (e.which || e.keyCode) will always return the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   171
        // known code for that key event phase. e.keyCode is often different in
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   172
        // keypress from keydown and keyup.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   173
        c = e.keyCode || e.charCode;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   174
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   175
        if (ua.webkit && (c in webkitKeymap)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   176
            c = webkitKeymap[c];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   177
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   178
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   179
        this.keyCode = c;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   180
        this.charCode = c;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   181
        // Fill in e.which for IE - implementers should always use this over
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   182
        // e.keyCode or e.charCode.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   183
        this.which = e.which || e.charCode || c;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   184
        // this.button = e.button;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   185
        this.button = this.which;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   186
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   187
        this.target = resolve(e.target);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   188
        this.currentTarget = resolve(currentTarget);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   189
        this.relatedTarget = resolve(e.relatedTarget);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   190
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   191
        if (e.type == "mousewheel" || e.type == "DOMMouseScroll") {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   192
            this.wheelDelta = (e.detail) ? (e.detail * -1) : Math.round(e.wheelDelta / 80) || ((e.wheelDelta < 0) ? -1 : 1);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   193
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   194
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   195
        if (this._touch) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   196
            this._touch(e, currentTarget, this._wrapper);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   197
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   198
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   199
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   200
    stopPropagation: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   201
        this._event.stopPropagation();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   202
        this._wrapper.stopped = 1;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   203
        this.stopped = 1;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   204
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   205
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   206
    stopImmediatePropagation: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   207
        var e = this._event;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   208
        if (e.stopImmediatePropagation) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   209
            e.stopImmediatePropagation();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   210
        } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   211
            this.stopPropagation();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   212
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   213
        this._wrapper.stopped = 2;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   214
        this.stopped = 2;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   215
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   216
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   217
    preventDefault: function(returnValue) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   218
        var e = this._event;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   219
        e.preventDefault();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   220
        e.returnValue = returnValue || false;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   221
        this._wrapper.prevented = 1;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   222
        this.prevented = 1;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   223
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   224
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   225
    halt: function(immediate) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   226
        if (immediate) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   227
            this.stopImmediatePropagation();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   228
        } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   229
            this.stopPropagation();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   230
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   231
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   232
        this.preventDefault();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   233
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   234
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   235
});
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   236
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   237
DOMEventFacade.resolve = resolve;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   238
Y.DOM2EventFacade = DOMEventFacade;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   239
Y.DOMEventFacade = DOMEventFacade;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   240
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   241
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   242
     * The native event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   243
     * @property _event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   244
     * @type {Native DOM Event}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   245
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   246
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   247
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   248
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   249
    The name of the event (e.g. "click")
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   250
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   251
    @property type
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   252
    @type {String}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   253
    **/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   254
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   255
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   256
    `true` if the "alt" or "option" key is pressed.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   257
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   258
    @property altKey
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   259
    @type {Boolean}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   260
    **/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   261
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   262
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   263
    `true` if the shift key is pressed.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   264
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   265
    @property shiftKey
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   266
    @type {Boolean}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   267
    **/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   268
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   269
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   270
    `true` if the "Windows" key on a Windows keyboard, "command" key on an
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   271
    Apple keyboard, or "meta" key on other keyboards is pressed.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   272
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   273
    @property metaKey
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   274
    @type {Boolean}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   275
    **/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   276
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   277
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   278
    `true` if the "Ctrl" or "control" key is pressed.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   279
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   280
    @property ctrlKey
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   281
    @type {Boolean}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   282
    **/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   283
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   284
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   285
     * The X location of the event on the page (including scroll)
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   286
     * @property pageX
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   287
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   288
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   289
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   290
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   291
     * The Y location of the event on the page (including scroll)
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   292
     * @property pageY
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   293
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   294
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   295
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   296
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   297
     * The X location of the event in the viewport
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   298
     * @property clientX
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   299
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   300
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   301
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   302
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   303
     * The Y location of the event in the viewport
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   304
     * @property clientY
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   305
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   306
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   307
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   308
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   309
     * The keyCode for key events.  Uses charCode if keyCode is not available
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   310
     * @property keyCode
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   311
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   312
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   313
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   314
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   315
     * The charCode for key events.  Same as keyCode
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   316
     * @property charCode
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   317
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   318
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   319
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   320
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   321
     * The button that was pushed. 1 for left click, 2 for middle click, 3 for
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   322
     * right click.  This is only reliably populated on `mouseup` events.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   323
     * @property button
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   324
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   325
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   326
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   327
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   328
     * The button that was pushed.  Same as button.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   329
     * @property which
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   330
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   331
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   332
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   333
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   334
     * Node reference for the targeted element
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   335
     * @property target
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   336
     * @type {Node}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   337
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   338
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   339
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   340
     * Node reference for the element that the listener was attached to.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   341
     * @property currentTarget
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   342
     * @type {Node}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   343
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   344
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   345
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   346
     * Node reference to the relatedTarget
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   347
     * @property relatedTarget
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   348
     * @type {Node}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   349
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   350
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   351
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   352
     * Number representing the direction and velocity of the movement of the mousewheel.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   353
     * Negative is down, the higher the number, the faster.  Applies to the mousewheel event.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   354
     * @property wheelDelta
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   355
     * @type {Number}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   356
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   357
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   358
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   359
     * Stops the propagation to the next bubble target
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   360
     * @method stopPropagation
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   361
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   362
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   363
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   364
     * Stops the propagation to the next bubble target and
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   365
     * prevents any additional listeners from being exectued
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   366
     * on the current target.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   367
     * @method stopImmediatePropagation
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   368
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   369
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   370
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   371
     * Prevents the event's default behavior
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   372
     * @method preventDefault
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   373
     * @param returnValue {string} sets the returnValue of the event to this value
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   374
     * (rather than the default false value).  This can be used to add a customized
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   375
     * confirmation query to the beforeunload event).
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   376
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   377
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   378
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   379
     * Stops the event propagation and prevents the default
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   380
     * event behavior.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   381
     * @method halt
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   382
     * @param immediate {boolean} if true additional listeners
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   383
     * on the current target will not be executed
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   384
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   385
(function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   386
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   387
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   388
 * The event utility provides functions to add and remove event listeners,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   389
 * event cleansing.  It also tries to automatically remove listeners it
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   390
 * registers during the unload event.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   391
 * @module event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   392
 * @main event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   393
 * @submodule event-base
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   394
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   395
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   396
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   397
 * The event utility provides functions to add and remove event listeners,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   398
 * event cleansing.  It also tries to automatically remove listeners it
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   399
 * registers during the unload event.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   400
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   401
 * @class Event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   402
 * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   403
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   404
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   405
Y.Env.evt.dom_wrappers = {};
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   406
Y.Env.evt.dom_map = {};
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   407
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   408
var _eventenv = Y.Env.evt,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   409
    config = Y.config,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   410
    win = config.win,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   411
    add = YUI.Env.add,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   412
    remove = YUI.Env.remove,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   413
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   414
    onLoad = function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   415
        YUI.Env.windowLoaded = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   416
        Y.Event._load();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   417
        remove(win, "load", onLoad);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   418
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   419
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   420
    onUnload = function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   421
        Y.Event._unload();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   422
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   423
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   424
    EVENT_READY = 'domready',
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   425
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   426
    COMPAT_ARG = '~yui|2|compat~',
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   427
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   428
    shouldIterate = function(o) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   429
        try {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   430
            // TODO: See if there's a more performant way to return true early on this, for the common case
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   431
            return (o && typeof o !== "string" && Y.Lang.isNumber(o.length) && !o.tagName && !Y.DOM.isWindow(o));
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   432
        } catch(ex) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   433
            Y.log("collection check failure", "warn", "event");
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   434
            return false;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   435
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   436
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   437
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   438
    // aliases to support DOM event subscription clean up when the last
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   439
    // subscriber is detached. deleteAndClean overrides the DOM event's wrapper
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   440
    // CustomEvent _delete method.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   441
    _ceProtoDelete = Y.CustomEvent.prototype._delete,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   442
    _deleteAndClean = function(s) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   443
        var ret = _ceProtoDelete.apply(this, arguments);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   444
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   445
        if (!this.hasSubs()) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   446
            Y.Event._clean(this);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   447
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   448
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   449
        return ret;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   450
    },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   451
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   452
Event = function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   453
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   454
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   455
     * True after the onload event has fired
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   456
     * @property _loadComplete
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   457
     * @type boolean
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   458
     * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   459
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   460
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   461
    var _loadComplete =  false,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   462
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   463
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   464
     * The number of times to poll after window.onload.  This number is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   465
     * increased if additional late-bound handlers are requested after
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   466
     * the page load.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   467
     * @property _retryCount
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   468
     * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   469
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   470
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   471
    _retryCount = 0,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   472
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   473
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   474
     * onAvailable listeners
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   475
     * @property _avail
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   476
     * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   477
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   478
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   479
    _avail = [],
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   480
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   481
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   482
     * Custom event wrappers for DOM events.  Key is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   483
     * 'event:' + Element uid stamp + event type
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   484
     * @property _wrappers
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   485
     * @type Y.Event.Custom
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   486
     * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   487
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   488
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   489
    _wrappers = _eventenv.dom_wrappers,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   490
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   491
    _windowLoadKey = null,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   492
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   493
    /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   494
     * Custom event wrapper map DOM events.  Key is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   495
     * Element uid stamp.  Each item is a hash of custom event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   496
     * wrappers as provided in the _wrappers collection.  This
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   497
     * provides the infrastructure for getListeners.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   498
     * @property _el_events
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   499
     * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   500
     * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   501
     */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   502
    _el_events = _eventenv.dom_map;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   503
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   504
    return {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   505
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   506
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   507
         * The number of times we should look for elements that are not
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   508
         * in the DOM at the time the event is requested after the document
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   509
         * has been loaded.  The default is 1000@amp;40 ms, so it will poll
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   510
         * for 40 seconds or until all outstanding handlers are bound
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   511
         * (whichever comes first).
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   512
         * @property POLL_RETRYS
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   513
         * @type int
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   514
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   515
         * @final
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   516
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   517
        POLL_RETRYS: 1000,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   518
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   519
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   520
         * The poll interval in milliseconds
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   521
         * @property POLL_INTERVAL
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   522
         * @type int
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   523
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   524
         * @final
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   525
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   526
        POLL_INTERVAL: 40,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   527
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   528
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   529
         * addListener/removeListener can throw errors in unexpected scenarios.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   530
         * These errors are suppressed, the method returns false, and this property
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   531
         * is set
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   532
         * @property lastError
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   533
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   534
         * @type Error
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   535
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   536
        lastError: null,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   537
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   538
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   539
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   540
         * poll handle
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   541
         * @property _interval
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   542
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   543
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   544
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   545
        _interval: null,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   546
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   547
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   548
         * document readystate poll handle
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   549
         * @property _dri
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   550
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   551
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   552
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   553
         _dri: null,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   554
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   555
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   556
         * True when the document is initially usable
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   557
         * @property DOMReady
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   558
         * @type boolean
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   559
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   560
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   561
        DOMReady: false,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   562
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   563
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   564
         * @method startInterval
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   565
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   566
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   567
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   568
        startInterval: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   569
            if (!Event._interval) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   570
Event._interval = setInterval(Event._poll, Event.POLL_INTERVAL);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   571
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   572
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   573
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   574
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   575
         * Executes the supplied callback when the item with the supplied
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   576
         * id is found.  This is meant to be used to execute behavior as
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   577
         * soon as possible as the page loads.  If you use this after the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   578
         * initial page load it will poll for a fixed time for the element.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   579
         * The number of times it will poll and the frequency are
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   580
         * configurable.  By default it will poll for 10 seconds.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   581
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   582
         * <p>The callback is executed with a single parameter:
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   583
         * the custom object parameter, if provided.</p>
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   584
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   585
         * @method onAvailable
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   586
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   587
         * @param {string||string[]}   id the id of the element, or an array
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   588
         * of ids to look for.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   589
         * @param {function} fn what to execute when the element is found.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   590
         * @param {object}   p_obj an optional object to be passed back as
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   591
         *                   a parameter to fn.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   592
         * @param {boolean|object}  p_override If set to true, fn will execute
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   593
         *                   in the context of p_obj, if set to an object it
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   594
         *                   will execute in the context of that object
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   595
         * @param checkContent {boolean} check child node readiness (onContentReady)
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   596
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   597
         * @deprecated Use Y.on("available")
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   598
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   599
        // @TODO fix arguments
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   600
        onAvailable: function(id, fn, p_obj, p_override, checkContent, compat) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   601
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   602
            var a = Y.Array(id), i, availHandle;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   603
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   604
            // Y.log('onAvailable registered for: ' + id);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   605
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   606
            for (i=0; i<a.length; i=i+1) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   607
                _avail.push({
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   608
                    id:         a[i],
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   609
                    fn:         fn,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   610
                    obj:        p_obj,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   611
                    override:   p_override,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   612
                    checkReady: checkContent,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   613
                    compat:     compat
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   614
                });
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   615
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   616
            _retryCount = this.POLL_RETRYS;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   617
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   618
            // We want the first test to be immediate, but async
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   619
            setTimeout(Event._poll, 0);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   620
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   621
            availHandle = new Y.EventHandle({
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   622
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   623
                _delete: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   624
                    // set by the event system for lazy DOM listeners
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   625
                    if (availHandle.handle) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   626
                        availHandle.handle.detach();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   627
                        return;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   628
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   629
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   630
                    var i, j;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   631
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   632
                    // otherwise try to remove the onAvailable listener(s)
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   633
                    for (i = 0; i < a.length; i++) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   634
                        for (j = 0; j < _avail.length; j++) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   635
                            if (a[i] === _avail[j].id) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   636
                                _avail.splice(j, 1);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   637
                            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   638
                        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   639
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   640
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   641
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   642
            });
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   643
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   644
            return availHandle;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   645
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   646
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   647
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   648
         * Works the same way as onAvailable, but additionally checks the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   649
         * state of sibling elements to determine if the content of the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   650
         * available element is safe to modify.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   651
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   652
         * <p>The callback is executed with a single parameter:
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   653
         * the custom object parameter, if provided.</p>
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   654
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   655
         * @method onContentReady
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   656
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   657
         * @param {string}   id the id of the element to look for.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   658
         * @param {function} fn what to execute when the element is ready.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   659
         * @param {object}   obj an optional object to be passed back as
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   660
         *                   a parameter to fn.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   661
         * @param {boolean|object}  override If set to true, fn will execute
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   662
         *                   in the context of p_obj.  If an object, fn will
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   663
         *                   exectute in the context of that object
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   664
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   665
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   666
         * @deprecated Use Y.on("contentready")
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   667
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   668
        // @TODO fix arguments
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   669
        onContentReady: function(id, fn, obj, override, compat) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   670
            return Event.onAvailable(id, fn, obj, override, true, compat);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   671
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   672
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   673
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   674
         * Adds an event listener
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   675
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   676
         * @method attach
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   677
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   678
         * @param {String}   type     The type of event to append
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   679
         * @param {Function} fn        The method the event invokes
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   680
         * @param {String|HTMLElement|Array|NodeList} el An id, an element
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   681
         *  reference, or a collection of ids and/or elements to assign the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   682
         *  listener to.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   683
         * @param {Object}   context optional context object
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   684
         * @param {Boolean|object}  args 0..n arguments to pass to the callback
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   685
         * @return {EventHandle} an object to that can be used to detach the listener
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   686
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   687
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   688
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   689
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   690
        attach: function(type, fn, el, context) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   691
            return Event._attach(Y.Array(arguments, 0, true));
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   692
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   693
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   694
        _createWrapper: function (el, type, capture, compat, facade) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   695
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   696
            var cewrapper,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   697
                ek  = Y.stamp(el),
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   698
                key = 'event:' + ek + type;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   699
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   700
            if (false === facade) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   701
                key += 'native';
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   702
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   703
            if (capture) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   704
                key += 'capture';
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   705
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   706
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   707
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   708
            cewrapper = _wrappers[key];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   709
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   710
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   711
            if (!cewrapper) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   712
                // create CE wrapper
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   713
                cewrapper = Y.publish(key, {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   714
                    silent: true,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   715
                    bubbles: false,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   716
                    emitFacade:false,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   717
                    contextFn: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   718
                        if (compat) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   719
                            return cewrapper.el;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   720
                        } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   721
                            cewrapper.nodeRef = cewrapper.nodeRef || Y.one(cewrapper.el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   722
                            return cewrapper.nodeRef;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   723
                        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   724
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   725
                });
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   726
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   727
                cewrapper.overrides = {};
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   728
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   729
                // for later removeListener calls
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   730
                cewrapper.el = el;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   731
                cewrapper.key = key;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   732
                cewrapper.domkey = ek;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   733
                cewrapper.type = type;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   734
                cewrapper.fn = function(e) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   735
                    cewrapper.fire(Event.getEvent(e, el, (compat || (false === facade))));
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   736
                };
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   737
                cewrapper.capture = capture;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   738
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   739
                if (el == win && type == "load") {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   740
                    // window load happens once
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   741
                    cewrapper.fireOnce = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   742
                    _windowLoadKey = key;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   743
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   744
                cewrapper._delete = _deleteAndClean;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   745
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   746
                _wrappers[key] = cewrapper;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   747
                _el_events[ek] = _el_events[ek] || {};
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   748
                _el_events[ek][key] = cewrapper;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   749
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   750
                add(el, type, cewrapper.fn, capture);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   751
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   752
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   753
            return cewrapper;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   754
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   755
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   756
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   757
        _attach: function(args, conf) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   758
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   759
            var compat,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   760
                handles, oEl, cewrapper, context,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   761
                fireNow = false, ret,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   762
                type = args[0],
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   763
                fn = args[1],
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   764
                el = args[2] || win,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   765
                facade = conf && conf.facade,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   766
                capture = conf && conf.capture,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   767
                overrides = conf && conf.overrides;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   768
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   769
            if (args[args.length-1] === COMPAT_ARG) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   770
                compat = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   771
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   772
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   773
            if (!fn || !fn.call) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   774
// throw new TypeError(type + " attach call failed, callback undefined");
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   775
Y.log(type + " attach call failed, invalid callback", "error", "event");
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   776
                return false;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   777
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   778
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   779
            // The el argument can be an array of elements or element ids.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   780
            if (shouldIterate(el)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   781
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   782
                handles=[];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   783
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   784
                Y.each(el, function(v, k) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   785
                    args[2] = v;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   786
                    handles.push(Event._attach(args.slice(), conf));
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   787
                });
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   788
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   789
                // return (handles.length === 1) ? handles[0] : handles;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   790
                return new Y.EventHandle(handles);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   791
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   792
            // If the el argument is a string, we assume it is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   793
            // actually the id of the element.  If the page is loaded
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   794
            // we convert el to the actual element, otherwise we
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   795
            // defer attaching the event until the element is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   796
            // ready
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   797
            } else if (Y.Lang.isString(el)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   798
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   799
                // oEl = (compat) ? Y.DOM.byId(el) : Y.Selector.query(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   800
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   801
                if (compat) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   802
                    oEl = Y.DOM.byId(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   803
                } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   804
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   805
                    oEl = Y.Selector.query(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   806
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   807
                    switch (oEl.length) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   808
                        case 0:
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   809
                            oEl = null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   810
                            break;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   811
                        case 1:
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   812
                            oEl = oEl[0];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   813
                            break;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   814
                        default:
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   815
                            args[2] = oEl;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   816
                            return Event._attach(args, conf);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   817
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   818
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   819
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   820
                if (oEl) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   821
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   822
                    el = oEl;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   823
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   824
                // Not found = defer adding the event until the element is available
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   825
                } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   826
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   827
                    // Y.log(el + ' not found');
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   828
                    ret = Event.onAvailable(el, function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   829
                        // Y.log('lazy attach: ' + args);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   830
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   831
                        ret.handle = Event._attach(args, conf);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   832
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   833
                    }, Event, true, false, compat);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   834
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   835
                    return ret;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   836
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   837
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   838
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   839
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   840
            // Element should be an html element or node
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   841
            if (!el) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   842
                Y.log("unable to attach event " + type, "warn", "event");
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   843
                return false;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   844
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   845
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   846
            if (Y.Node && Y.instanceOf(el, Y.Node)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   847
                el = Y.Node.getDOMNode(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   848
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   849
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   850
            cewrapper = Event._createWrapper(el, type, capture, compat, facade);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   851
            if (overrides) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   852
                Y.mix(cewrapper.overrides, overrides);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   853
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   854
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   855
            if (el == win && type == "load") {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   856
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   857
                // if the load is complete, fire immediately.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   858
                // all subscribers, including the current one
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   859
                // will be notified.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   860
                if (YUI.Env.windowLoaded) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   861
                    fireNow = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   862
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   863
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   864
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   865
            if (compat) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   866
                args.pop();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   867
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   868
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   869
            context = args[3];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   870
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   871
            // set context to the Node if not specified
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   872
            // ret = cewrapper.on.apply(cewrapper, trimmedArgs);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   873
            ret = cewrapper._on(fn, context, (args.length > 4) ? args.slice(4) : null);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   874
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   875
            if (fireNow) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   876
                cewrapper.fire();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   877
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   878
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   879
            return ret;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   880
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   881
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   882
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   883
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   884
         * Removes an event listener.  Supports the signature the event was bound
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   885
         * with, but the preferred way to remove listeners is using the handle
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   886
         * that is returned when using Y.on
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   887
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   888
         * @method detach
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   889
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   890
         * @param {String} type the type of event to remove.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   891
         * @param {Function} fn the method the event invokes.  If fn is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   892
         * undefined, then all event handlers for the type of event are
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   893
         * removed.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   894
         * @param {String|HTMLElement|Array|NodeList|EventHandle} el An
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   895
         * event handle, an id, an element reference, or a collection
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   896
         * of ids and/or elements to remove the listener from.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   897
         * @return {boolean} true if the unbind was successful, false otherwise.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   898
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   899
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   900
        detach: function(type, fn, el, obj) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   901
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   902
            var args=Y.Array(arguments, 0, true), compat, l, ok, i,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   903
                id, ce;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   904
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   905
            if (args[args.length-1] === COMPAT_ARG) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   906
                compat = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   907
                // args.pop();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   908
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   909
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   910
            if (type && type.detach) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   911
                return type.detach();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   912
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   913
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   914
            // The el argument can be a string
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   915
            if (typeof el == "string") {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   916
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   917
                // el = (compat) ? Y.DOM.byId(el) : Y.all(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   918
                if (compat) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   919
                    el = Y.DOM.byId(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   920
                } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   921
                    el = Y.Selector.query(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   922
                    l = el.length;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   923
                    if (l < 1) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   924
                        el = null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   925
                    } else if (l == 1) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   926
                        el = el[0];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   927
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   928
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   929
                // return Event.detach.apply(Event, args);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   930
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   931
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   932
            if (!el) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   933
                return false;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   934
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   935
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   936
            if (el.detach) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   937
                args.splice(2, 1);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   938
                return el.detach.apply(el, args);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   939
            // The el argument can be an array of elements or element ids.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   940
            } else if (shouldIterate(el)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   941
                ok = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   942
                for (i=0, l=el.length; i<l; ++i) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   943
                    args[2] = el[i];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   944
                    ok = ( Y.Event.detach.apply(Y.Event, args) && ok );
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   945
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   946
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   947
                return ok;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   948
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   949
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   950
            if (!type || !fn || !fn.call) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   951
                return Event.purgeElement(el, false, type);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   952
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   953
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   954
            id = 'event:' + Y.stamp(el) + type;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   955
            ce = _wrappers[id];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   956
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   957
            if (ce) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   958
                return ce.detach(fn);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   959
            } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   960
                return false;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   961
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   962
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   963
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   964
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   965
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   966
         * Finds the event in the window object, the caller's arguments, or
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   967
         * in the arguments of another method in the callstack.  This is
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   968
         * executed automatically for events registered through the event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   969
         * manager, so the implementer should not normally need to execute
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   970
         * this function at all.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   971
         * @method getEvent
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   972
         * @param {Event} e the event parameter from the handler
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   973
         * @param {HTMLElement} el the element the listener was attached to
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   974
         * @return {Event} the event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   975
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   976
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   977
        getEvent: function(e, el, noFacade) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   978
            var ev = e || win.event;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   979
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   980
            return (noFacade) ? ev :
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   981
                new Y.DOMEventFacade(ev, el, _wrappers['event:' + Y.stamp(el) + e.type]);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   982
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   983
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   984
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   985
         * Generates an unique ID for the element if it does not already
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   986
         * have one.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   987
         * @method generateId
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   988
         * @param el the element to create the id for
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   989
         * @return {string} the resulting id of the element
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   990
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   991
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   992
        generateId: function(el) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   993
            return Y.DOM.generateID(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   994
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   995
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   996
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   997
         * We want to be able to use getElementsByTagName as a collection
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   998
         * to attach a group of events to.  Unfortunately, different
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   999
         * browsers return different types of collections.  This function
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1000
         * tests to determine if the object is array-like.  It will also
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1001
         * fail if the object is an array, but is empty.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1002
         * @method _isValidCollection
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1003
         * @param o the object to test
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1004
         * @return {boolean} true if the object is array-like and populated
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1005
         * @deprecated was not meant to be used directly
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1006
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1007
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1008
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1009
        _isValidCollection: shouldIterate,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1010
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1011
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1012
         * hook up any deferred listeners
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1013
         * @method _load
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1014
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1015
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1016
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1017
        _load: function(e) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1018
            if (!_loadComplete) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1019
                // Y.log('Load Complete', 'info', 'event');
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1020
                _loadComplete = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1021
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1022
                // Just in case DOMReady did not go off for some reason
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1023
                // E._ready();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1024
                if (Y.fire) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1025
                    Y.fire(EVENT_READY);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1026
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1027
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1028
                // Available elements may not have been detected before the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1029
                // window load event fires. Try to find them now so that the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1030
                // the user is more likely to get the onAvailable notifications
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1031
                // before the window load notification
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1032
                Event._poll();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1033
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1034
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1035
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1036
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1037
         * Polling function that runs before the onload event fires,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1038
         * attempting to attach to DOM Nodes as soon as they are
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1039
         * available
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1040
         * @method _poll
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1041
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1042
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1043
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1044
        _poll: function() {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1045
            if (Event.locked) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1046
                return;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1047
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1048
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1049
            if (Y.UA.ie && !YUI.Env.DOMReady) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1050
                // Hold off if DOMReady has not fired and check current
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1051
                // readyState to protect against the IE operation aborted
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1052
                // issue.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1053
                Event.startInterval();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1054
                return;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1055
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1056
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1057
            Event.locked = true;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1058
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1059
            // Y.log.debug("poll");
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1060
            // keep trying until after the page is loaded.  We need to
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1061
            // check the page load state prior to trying to bind the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1062
            // elements so that we can be certain all elements have been
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1063
            // tested appropriately
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1064
            var i, len, item, el, notAvail, executeItem,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1065
                tryAgain = !_loadComplete;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1066
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1067
            if (!tryAgain) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1068
                tryAgain = (_retryCount > 0);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1069
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1070
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1071
            // onAvailable
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1072
            notAvail = [];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1073
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1074
            executeItem = function (el, item) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1075
                var context, ov = item.override;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1076
                try {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1077
                    if (item.compat) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1078
                        if (item.override) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1079
                            if (ov === true) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1080
                                context = item.obj;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1081
                            } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1082
                                context = ov;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1083
                            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1084
                        } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1085
                            context = el;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1086
                        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1087
                        item.fn.call(context, item.obj);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1088
                    } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1089
                        context = item.obj || Y.one(el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1090
                        item.fn.apply(context, (Y.Lang.isArray(ov)) ? ov : []);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1091
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1092
                } catch (e) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1093
                    Y.log("Error in available or contentReady callback", 'error', 'event');
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1094
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1095
            };
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1096
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1097
            // onAvailable
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1098
            for (i=0,len=_avail.length; i<len; ++i) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1099
                item = _avail[i];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1100
                if (item && !item.checkReady) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1101
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1102
                    // el = (item.compat) ? Y.DOM.byId(item.id) : Y.one(item.id);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1103
                    el = (item.compat) ? Y.DOM.byId(item.id) : Y.Selector.query(item.id, null, true);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1104
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1105
                    if (el) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1106
                        // Y.log('avail: ' + el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1107
                        executeItem(el, item);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1108
                        _avail[i] = null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1109
                    } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1110
                        // Y.log('NOT avail: ' + el);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1111
                        notAvail.push(item);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1112
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1113
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1114
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1115
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1116
            // onContentReady
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1117
            for (i=0,len=_avail.length; i<len; ++i) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1118
                item = _avail[i];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1119
                if (item && item.checkReady) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1120
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1121
                    // el = (item.compat) ? Y.DOM.byId(item.id) : Y.one(item.id);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1122
                    el = (item.compat) ? Y.DOM.byId(item.id) : Y.Selector.query(item.id, null, true);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1123
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1124
                    if (el) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1125
                        // The element is available, but not necessarily ready
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1126
                        // @todo should we test parentNode.nextSibling?
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1127
                        if (_loadComplete || (el.get && el.get('nextSibling')) || el.nextSibling) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1128
                            executeItem(el, item);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1129
                            _avail[i] = null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1130
                        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1131
                    } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1132
                        notAvail.push(item);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1133
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1134
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1135
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1136
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1137
            _retryCount = (notAvail.length === 0) ? 0 : _retryCount - 1;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1138
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1139
            if (tryAgain) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1140
                // we may need to strip the nulled out items here
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1141
                Event.startInterval();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1142
            } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1143
                clearInterval(Event._interval);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1144
                Event._interval = null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1145
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1146
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1147
            Event.locked = false;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1148
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1149
            return;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1150
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1151
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1152
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1153
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1154
         * Removes all listeners attached to the given element via addListener.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1155
         * Optionally, the node's children can also be purged.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1156
         * Optionally, you can specify a specific type of event to remove.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1157
         * @method purgeElement
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1158
         * @param {HTMLElement} el the element to purge
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1159
         * @param {boolean} recurse recursively purge this element's children
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1160
         * as well.  Use with caution.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1161
         * @param {string} type optional type of listener to purge. If
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1162
         * left out, all listeners will be removed
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1163
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1164
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1165
        purgeElement: function(el, recurse, type) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1166
            // var oEl = (Y.Lang.isString(el)) ? Y.one(el) : el,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1167
            var oEl = (Y.Lang.isString(el)) ?  Y.Selector.query(el, null, true) : el,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1168
                lis = Event.getListeners(oEl, type), i, len, children, child;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1169
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1170
            if (recurse && oEl) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1171
                lis = lis || [];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1172
                children = Y.Selector.query('*', oEl);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1173
                len = children.length;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1174
                for (i = 0; i < len; ++i) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1175
                    child = Event.getListeners(children[i], type);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1176
                    if (child) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1177
                        lis = lis.concat(child);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1178
                    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1179
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1180
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1181
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1182
            if (lis) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1183
                for (i = 0, len = lis.length; i < len; ++i) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1184
                    lis[i].detachAll();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1185
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1186
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1187
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1188
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1189
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1190
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1191
         * Removes all object references and the DOM proxy subscription for
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1192
         * a given event for a DOM node.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1193
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1194
         * @method _clean
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1195
         * @param wrapper {CustomEvent} Custom event proxy for the DOM
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1196
         *                  subscription
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1197
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1198
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1199
         * @since 3.4.0
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1200
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1201
        _clean: function (wrapper) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1202
            var key    = wrapper.key,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1203
                domkey = wrapper.domkey;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1204
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1205
            remove(wrapper.el, wrapper.type, wrapper.fn, wrapper.capture);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1206
            delete _wrappers[key];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1207
            delete Y._yuievt.events[key];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1208
            if (_el_events[domkey]) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1209
                delete _el_events[domkey][key];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1210
                if (!Y.Object.size(_el_events[domkey])) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1211
                    delete _el_events[domkey];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1212
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1213
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1214
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1215
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1216
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1217
         * Returns all listeners attached to the given element via addListener.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1218
         * Optionally, you can specify a specific type of event to return.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1219
         * @method getListeners
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1220
         * @param el {HTMLElement|string} the element or element id to inspect
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1221
         * @param type {string} optional type of listener to return. If
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1222
         * left out, all listeners will be returned
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1223
         * @return {CustomEvent} the custom event wrapper for the DOM event(s)
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1224
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1225
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1226
        getListeners: function(el, type) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1227
            var ek = Y.stamp(el, true), evts = _el_events[ek],
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1228
                results=[] , key = (type) ? 'event:' + ek + type : null,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1229
                adapters = _eventenv.plugins;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1230
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1231
            if (!evts) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1232
                return null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1233
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1234
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1235
            if (key) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1236
                // look for synthetic events
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1237
                if (adapters[type] && adapters[type].eventDef) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1238
                    key += '_synth';
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1239
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1240
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1241
                if (evts[key]) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1242
                    results.push(evts[key]);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1243
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1244
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1245
                // get native events as well
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1246
                key += 'native';
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1247
                if (evts[key]) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1248
                    results.push(evts[key]);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1249
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1250
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1251
            } else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1252
                Y.each(evts, function(v, k) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1253
                    results.push(v);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1254
                });
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1255
            }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1256
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1257
            return (results.length) ? results : null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1258
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1259
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1260
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1261
         * Removes all listeners registered by pe.event.  Called
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1262
         * automatically during the unload event.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1263
         * @method _unload
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1264
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1265
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1266
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1267
        _unload: function(e) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1268
            Y.each(_wrappers, function(v, k) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1269
                if (v.type == 'unload') {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1270
                    v.fire(e);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1271
                }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1272
                v.detachAll();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1273
            });
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1274
            remove(win, "unload", onUnload);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1275
        },
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1276
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1277
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1278
         * Adds a DOM event directly without the caching, cleanup, context adj, etc
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1279
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1280
         * @method nativeAdd
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1281
         * @param {HTMLElement} el      the element to bind the handler to
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1282
         * @param {string}      type   the type of event handler
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1283
         * @param {function}    fn      the callback to invoke
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1284
         * @param {boolen}      capture capture or bubble phase
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1285
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1286
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1287
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1288
        nativeAdd: add,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1289
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1290
        /**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1291
         * Basic remove listener
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1292
         *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1293
         * @method nativeRemove
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1294
         * @param {HTMLElement} el      the element to bind the handler to
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1295
         * @param {string}      type   the type of event handler
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1296
         * @param {function}    fn      the callback to invoke
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1297
         * @param {boolen}      capture capture or bubble phase
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1298
         * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1299
         * @private
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1300
         */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1301
        nativeRemove: remove
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1302
    };
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1303
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1304
}();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1305
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1306
Y.Event = Event;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1307
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1308
if (config.injected || YUI.Env.windowLoaded) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1309
    onLoad();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1310
} else {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1311
    add(win, "load", onLoad);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1312
}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1313
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1314
// Process onAvailable/onContentReady items when when the DOM is ready in IE
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1315
if (Y.UA.ie) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1316
    Y.on(EVENT_READY, Event._poll);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1317
}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1318
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1319
try {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1320
    add(win, "unload", onUnload);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1321
} catch(e) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1322
    /*jshint maxlen:300*/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1323
    Y.log("Registering unload listener failed. This is known to happen in Chrome Packaged Apps and Extensions, which don't support unload, and don't provide a way to test for support", "warn", "event-base");
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1324
}
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1325
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1326
Event.Custom = Y.CustomEvent;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1327
Event.Subscriber = Y.Subscriber;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1328
Event.Target = Y.EventTarget;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1329
Event.Handle = Y.EventHandle;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1330
Event.Facade = Y.EventFacade;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1331
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1332
Event._poll();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1333
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1334
}());
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1335
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1336
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1337
 * DOM event listener abstraction layer
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1338
 * @module event
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1339
 * @submodule event-base
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1340
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1341
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1342
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1343
 * Executes the callback as soon as the specified element
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1344
 * is detected in the DOM.  This function expects a selector
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1345
 * string for the element(s) to detect.  If you already have
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1346
 * an element reference, you don't need this event.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1347
 * @event available
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1348
 * @param type {string} 'available'
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1349
 * @param fn {function} the callback function to execute.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1350
 * @param el {string} an selector for the element(s) to attach
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1351
 * @param context optional argument that specifies what 'this' refers to.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1352
 * @param args* 0..n additional arguments to pass on to the callback function.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1353
 * These arguments will be added after the event object.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1354
 * @return {EventHandle} the detach handle
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1355
 * @for YUI
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1356
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1357
Y.Env.evt.plugins.available = {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1358
    on: function(type, fn, id, o) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1359
        var a = arguments.length > 4 ?  Y.Array(arguments, 4, true) : null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1360
        return Y.Event.onAvailable.call(Y.Event, id, fn, o, a);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1361
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1362
};
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1363
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1364
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1365
 * Executes the callback as soon as the specified element
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1366
 * is detected in the DOM with a nextSibling property
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1367
 * (indicating that the element's children are available).
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1368
 * This function expects a selector
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1369
 * string for the element(s) to detect.  If you already have
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1370
 * an element reference, you don't need this event.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1371
 * @event contentready
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1372
 * @param type {string} 'contentready'
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1373
 * @param fn {function} the callback function to execute.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1374
 * @param el {string} an selector for the element(s) to attach.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1375
 * @param context optional argument that specifies what 'this' refers to.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1376
 * @param args* 0..n additional arguments to pass on to the callback function.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1377
 * These arguments will be added after the event object.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1378
 * @return {EventHandle} the detach handle
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1379
 * @for YUI
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1380
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1381
Y.Env.evt.plugins.contentready = {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1382
    on: function(type, fn, id, o) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1383
        var a = arguments.length > 4 ? Y.Array(arguments, 4, true) : null;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1384
        return Y.Event.onContentReady.call(Y.Event, id, fn, o, a);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1385
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1386
};
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1387
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1388
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
  1389
}, '3.10.3', {"requires": ["event-custom-base"]});