src/cm/media/js/lib/yui/yui3.0.0/build/event-custom/event-custom-base.js
author raph
Mon, 23 Nov 2009 15:14:29 +0100
changeset 0 40c8f766c9b8
permissions -rw-r--r--
import from internal svn r 4007
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     1
/*
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     2
Copyright (c) 2009, Yahoo! Inc. All rights reserved.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     3
Code licensed under the BSD License:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     4
http://developer.yahoo.net/yui/license.txt
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     5
version: 3.0.0
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     6
build: 1549
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     7
*/
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     8
YUI.add('event-custom-base', function(Y) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     9
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    10
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    11
 * Custom event engine, DOM event listener abstraction layer, synthetic DOM
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    12
 * events.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    13
 * @module event-custom
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    14
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    15
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    16
Y.Env.evt = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    17
    handles: {},
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    18
    plugins: {}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    19
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    20
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    21
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    22
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    23
 * Custom event engine, DOM event listener abstraction layer, synthetic DOM 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    24
 * events.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    25
 * @module event-custom
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    26
 * @submodule event-custom-base
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    27
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    28
(function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    29
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    30
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    31
 * Allows for the insertion of methods that are executed before or after
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    32
 * a specified method
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    33
 * @class Do
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    34
 * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    35
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    36
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    37
var BEFORE = 0,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    38
    AFTER = 1;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    39
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    40
Y.Do = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    41
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    42
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    43
     * Cache of objects touched by the utility
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    44
     * @property objs
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    45
     * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    46
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    47
    objs: {},
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    48
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    49
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    50
     * Execute the supplied method before the specified function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    51
     * @method before
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    52
     * @param fn {Function} the function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    53
     * @param obj the object hosting the method to displace
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    54
     * @param sFn {string} the name of the method to displace
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    55
     * @param c The execution context for fn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    56
     * @return {string} handle for the subscription
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    57
     * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    58
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    59
    before: function(fn, obj, sFn, c) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    60
        var f = fn, a;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    61
        if (c) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    62
            a = [fn, c].concat(Y.Array(arguments, 4, true));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    63
            f = Y.rbind.apply(Y, a);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    64
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    65
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    66
        return this._inject(BEFORE, f, obj, sFn);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    67
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    68
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    69
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    70
     * Execute the supplied method after the specified function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    71
     * @method after
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    72
     * @param fn {Function} the function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    73
     * @param obj the object hosting the method to displace
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    74
     * @param sFn {string} the name of the method to displace
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    75
     * @param c The execution context for fn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    76
     * @return {string} handle for the subscription
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    77
     * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    78
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    79
    after: function(fn, obj, sFn, c) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    80
        var f = fn, a;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    81
        if (c) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    82
            a = [fn, c].concat(Y.Array(arguments, 4, true));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    83
            f = Y.rbind.apply(Y, a);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    84
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    85
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    86
        return this._inject(AFTER, f, obj, sFn);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    87
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    88
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    89
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    90
     * Execute the supplied method after the specified function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    91
     * @method _inject
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    92
     * @param when {string} before or after
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    93
     * @param fn {Function} the function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    94
     * @param obj the object hosting the method to displace
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    95
     * @param sFn {string} the name of the method to displace
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    96
     * @param c The execution context for fn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    97
     * @return {string} handle for the subscription
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    98
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    99
     * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   100
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   101
    _inject: function(when, fn, obj, sFn) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   102
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   103
        // object id
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   104
        var id = Y.stamp(obj), o, sid;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   105
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   106
        if (! this.objs[id]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   107
            // create a map entry for the obj if it doesn't exist
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   108
            this.objs[id] = {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   109
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   110
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   111
        o = this.objs[id];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   112
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   113
        if (! o[sFn]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   114
            // create a map entry for the method if it doesn't exist
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   115
            o[sFn] = new Y.Do.Method(obj, sFn);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   116
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   117
            // re-route the method to our wrapper
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   118
            obj[sFn] = 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   119
                function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   120
                    return o[sFn].exec.apply(o[sFn], arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   121
                };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   122
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   123
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   124
        // subscriber id
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   125
        sid = id + Y.stamp(fn) + sFn;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   126
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   127
        // register the callback
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   128
        o[sFn].register(sid, fn, when);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   129
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   130
        return new Y.EventHandle(o[sFn], sid);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   131
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   132
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   133
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   134
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   135
     * Detach a before or after subscription
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   136
     * @method detach
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   137
     * @param handle {string} the subscription handle
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   138
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   139
    detach: function(handle) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   140
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   141
        if (handle.detach) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   142
            handle.detach();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   143
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   144
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   145
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   146
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   147
    _unload: function(e, me) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   148
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   149
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   150
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   151
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   152
//////////////////////////////////////////////////////////////////////////
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   153
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   154
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   155
 * Wrapper for a displaced method with aop enabled
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   156
 * @class Do.Method
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   157
 * @constructor
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   158
 * @param obj The object to operate on
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   159
 * @param sFn The name of the method to displace
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   160
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   161
Y.Do.Method = function(obj, sFn) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   162
    this.obj = obj;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   163
    this.methodName = sFn;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   164
    this.method = obj[sFn];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   165
    this.before = {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   166
    this.after = {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   167
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   168
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   169
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   170
 * Register a aop subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   171
 * @method register
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   172
 * @param sid {string} the subscriber id
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   173
 * @param fn {Function} the function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   174
 * @param when {string} when to execute the function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   175
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   176
Y.Do.Method.prototype.register = function (sid, fn, when) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   177
    if (when) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   178
        this.after[sid] = fn;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   179
    } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   180
        this.before[sid] = fn;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   181
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   182
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   183
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   184
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   185
 * Unregister a aop subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   186
 * @method delete
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   187
 * @param sid {string} the subscriber id
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   188
 * @param fn {Function} the function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   189
 * @param when {string} when to execute the function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   190
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   191
Y.Do.Method.prototype._delete = function (sid) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   192
    delete this.before[sid];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   193
    delete this.after[sid];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   194
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   195
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   196
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   197
 * Execute the wrapped method
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   198
 * @method exec
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   199
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   200
Y.Do.Method.prototype.exec = function () {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   201
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   202
    var args = Y.Array(arguments, 0, true), 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   203
        i, ret, newRet, 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   204
        bf = this.before,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   205
        af = this.after,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   206
        prevented = false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   207
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   208
    // execute before
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   209
    for (i in bf) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   210
        if (bf.hasOwnProperty(i)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   211
            ret = bf[i].apply(this.obj, args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   212
            if (ret) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   213
                switch (ret.constructor) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   214
                    case Y.Do.Halt:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   215
                        return ret.retVal;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   216
                    case Y.Do.AlterArgs:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   217
                        args = ret.newArgs;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   218
                        break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   219
                    case Y.Do.Prevent:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   220
                        prevented = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   221
                        break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   222
                    default:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   223
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   224
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   225
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   226
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   227
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   228
    // execute method
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   229
    if (!prevented) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   230
        ret = this.method.apply(this.obj, args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   231
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   232
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   233
    // execute after methods.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   234
    for (i in af) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   235
        if (af.hasOwnProperty(i)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   236
            newRet = af[i].apply(this.obj, args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   237
            // Stop processing if a Halt object is returned
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   238
            if (newRet && newRet.constructor == Y.Do.Halt) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   239
                return newRet.retVal;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   240
            // Check for a new return value
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   241
            } else if (newRet && newRet.constructor == Y.Do.AlterReturn) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   242
                ret = newRet.newRetVal;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   243
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   244
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   245
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   246
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   247
    return ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   248
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   249
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   250
//////////////////////////////////////////////////////////////////////////
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   251
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   252
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   253
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   254
 * Return an AlterArgs object when you want to change the arguments that
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   255
 * were passed into the function.  An example would be a service that scrubs
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   256
 * out illegal characters prior to executing the core business logic.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   257
 * @class Do.AlterArgs
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   258
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   259
Y.Do.AlterArgs = function(msg, newArgs) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   260
    this.msg = msg;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   261
    this.newArgs = newArgs;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   262
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   263
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   264
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   265
 * Return an AlterReturn object when you want to change the result returned
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   266
 * from the core method to the caller
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   267
 * @class Do.AlterReturn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   268
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   269
Y.Do.AlterReturn = function(msg, newRetVal) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   270
    this.msg = msg;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   271
    this.newRetVal = newRetVal;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   272
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   273
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   274
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   275
 * Return a Halt object when you want to terminate the execution
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   276
 * of all subsequent subscribers as well as the wrapped method
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   277
 * if it has not exectued yet.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   278
 * @class Do.Halt
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   279
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   280
Y.Do.Halt = function(msg, retVal) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   281
    this.msg = msg;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   282
    this.retVal = retVal;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   283
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   284
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   285
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   286
 * Return a Prevent object when you want to prevent the wrapped function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   287
 * from executing, but want the remaining listeners to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   288
 * @class Do.Prevent
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   289
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   290
Y.Do.Prevent = function(msg) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   291
    this.msg = msg;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   292
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   293
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   294
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   295
 * Return an Error object when you want to terminate the execution
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   296
 * of all subsequent method calls.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   297
 * @class Do.Error
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   298
 * @deprecated use Y.Do.Halt or Y.Do.Prevent
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   299
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   300
Y.Do.Error = Y.Do.Halt;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   301
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   302
//////////////////////////////////////////////////////////////////////////
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   303
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   304
// Y["Event"] && Y.Event.addListener(window, "unload", Y.Do._unload, Y.Do);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   305
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   306
})();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   307
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   308
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   309
 * Custom event engine, DOM event listener abstraction layer, synthetic DOM 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   310
 * events.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   311
 * @module event-custom
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   312
 * @submodule event-custom-base
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   313
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   314
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   315
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   316
 * Return value from all subscribe operations
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   317
 * @class EventHandle
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   318
 * @constructor
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   319
 * @param evt {CustomEvent} the custom event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   320
 * @param sub {Subscriber} the subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   321
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   322
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   323
// var onsubscribeType = "_event:onsub",
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   324
var AFTER = 'after', 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   325
    CONFIGS = [
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   326
        'broadcast',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   327
        'bubbles',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   328
        'context',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   329
        'contextFn',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   330
        'currentTarget',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   331
        'defaultFn',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   332
        'details',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   333
        'emitFacade',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   334
        'fireOnce',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   335
        'host',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   336
        'preventable',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   337
        'preventedFn',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   338
        'queuable',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   339
        'silent',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   340
        'stoppedFn',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   341
        'target',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   342
        'type'
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   343
    ],
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   344
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   345
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   346
    YUI3_SIGNATURE = 9,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   347
    YUI_LOG = 'yui:log';
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   348
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   349
Y.EventHandle = function(evt, sub) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   350
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   351
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   352
     * The custom event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   353
     * @type CustomEvent
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   354
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   355
    this.evt = evt;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   356
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   357
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   358
     * The subscriber object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   359
     * @type Subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   360
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   361
    this.sub = sub;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   362
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   363
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   364
Y.EventHandle.prototype = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   365
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   366
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   367
     * Detaches this subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   368
     * @method detach
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   369
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   370
    detach: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   371
        var evt = this.evt, i;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   372
        if (evt) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   373
            if (Y.Lang.isArray(evt)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   374
                for (i=0; i<evt.length; i++) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   375
                    evt[i].detach();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   376
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   377
            } else { 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   378
                evt._delete(this.sub);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   379
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   380
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   381
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   382
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   383
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   384
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   385
 * The CustomEvent class lets you define events for your application
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   386
 * that can be subscribed to by one or more independent component.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   387
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   388
 * @param {String}  type The type of event, which is passed to the callback
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   389
 *                  when the event fires
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   390
 * @param o configuration object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   391
 * @class CustomEvent
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   392
 * @constructor
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   393
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   394
Y.CustomEvent = function(type, o) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   395
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   396
    // if (arguments.length > 2) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   397
// this.log('CustomEvent context and silent are now in the config', 'warn', 'Event');
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   398
    // }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   399
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   400
    o = o || {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   401
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   402
    this.id = Y.stamp(this);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   403
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   404
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   405
     * The type of event, returned to subscribers when the event fires
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   406
     * @property type
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   407
     * @type string
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   408
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   409
    this.type = type;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   410
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   411
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   412
     * The context the the event will fire from by default.  Defaults to the YUI
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   413
     * instance.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   414
     * @property context
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   415
     * @type object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   416
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   417
    this.context = Y;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   418
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   419
    this.logSystem = (type == YUI_LOG);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   420
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   421
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   422
     * If 0, this event does not broadcast.  If 1, the YUI instance is notified
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   423
     * every time this event fires.  If 2, the YUI instance and the YUI global
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   424
     * (if event is enabled on the global) are notified every time this event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   425
     * fires.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   426
     * @property broadcast
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   427
     * @type int
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   428
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   429
    // this.broadcast = 0;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   430
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   431
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   432
     * By default all custom events are logged in the debug build, set silent
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   433
     * to true to disable debug outpu for this event.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   434
     * @property silent
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   435
     * @type boolean
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   436
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   437
    this.silent = this.logSystem;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   438
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   439
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   440
     * Specifies whether this event should be queued when the host is actively
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   441
     * processing an event.  This will effect exectution order of the callbacks
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   442
     * for the various events.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   443
     * @property queuable
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   444
     * @type boolean
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   445
     * @default false
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   446
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   447
    // this.queuable = false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   448
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   449
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   450
     * The subscribers to this event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   451
     * @property subscribers
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   452
     * @type Subscriber{}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   453
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   454
    this.subscribers = {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   455
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   456
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   457
     * 'After' subscribers
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   458
     * @property afters
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   459
     * @type Subscriber{}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   460
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   461
    this.afters = {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   462
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   463
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   464
     * This event has fired if true
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   465
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   466
     * @property fired
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   467
     * @type boolean
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   468
     * @default false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   469
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   470
    // this.fired = false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   471
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   472
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   473
     * An array containing the arguments the custom event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   474
     * was last fired with.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   475
     * @property firedWith
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   476
     * @type Array
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   477
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   478
    // this.firedWith;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   479
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   480
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   481
     * This event should only fire one time if true, and if
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   482
     * it has fired, any new subscribers should be notified
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   483
     * immediately.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   484
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   485
     * @property fireOnce
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   486
     * @type boolean
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   487
     * @default false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   488
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   489
    // this.fireOnce = false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   490
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   491
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   492
     * Flag for stopPropagation that is modified during fire()
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   493
     * 1 means to stop propagation to bubble targets.  2 means
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   494
     * to also stop additional subscribers on this target.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   495
     * @property stopped
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   496
     * @type int
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   497
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   498
    // this.stopped = 0;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   499
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   500
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   501
     * Flag for preventDefault that is modified during fire().
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   502
     * if it is not 0, the default behavior for this event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   503
     * @property prevented
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   504
     * @type int
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   505
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   506
    // this.prevented = 0;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   507
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   508
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   509
     * Specifies the host for this custom event.  This is used
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   510
     * to enable event bubbling
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   511
     * @property host
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   512
     * @type EventTarget
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   513
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   514
    // this.host = null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   515
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   516
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   517
     * The default function to execute after event listeners
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   518
     * have fire, but only if the default action was not
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   519
     * prevented.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   520
     * @property defaultFn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   521
     * @type Function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   522
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   523
    // this.defaultFn = null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   524
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   525
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   526
     * The function to execute if a subscriber calls
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   527
     * stopPropagation or stopImmediatePropagation
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   528
     * @property stoppedFn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   529
     * @type Function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   530
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   531
    // this.stoppedFn = null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   532
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   533
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   534
     * The function to execute if a subscriber calls
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   535
     * preventDefault
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   536
     * @property preventedFn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   537
     * @type Function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   538
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   539
    // this.preventedFn = null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   540
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   541
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   542
     * Specifies whether or not this event's default function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   543
     * can be cancelled by a subscriber by executing preventDefault() 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   544
     * on the event facade 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   545
     * @property preventable 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   546
     * @type boolean 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   547
     * @default true
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   548
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   549
    this.preventable = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   550
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   551
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   552
     * Specifies whether or not a subscriber can stop the event propagation
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   553
     * via stopPropagation(), stopImmediatePropagation(), or halt()
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   554
     * @property bubbles
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   555
     * @type boolean
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   556
     * @default true
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   557
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   558
    this.bubbles = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   559
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   560
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   561
     * Supports multiple options for listener signatures in order to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   562
     * port YUI 2 apps.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   563
     * @property signature
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   564
     * @type int
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   565
     * @default 9
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   566
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   567
    this.signature = YUI3_SIGNATURE;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   568
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   569
    // this.hasSubscribers = false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   570
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   571
    // this.hasAfters = false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   572
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   573
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   574
     * If set to true, the custom event will deliver an EventFacade object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   575
     * that is similar to a DOM event object.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   576
     * @property emitFacade
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   577
     * @type boolean
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   578
     * @default false
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   579
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   580
    // this.emitFacade = false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   581
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   582
    this.applyConfig(o, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   583
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   584
    // this.log("Creating " + this.type);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   585
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   586
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   587
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   588
Y.CustomEvent.prototype = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   589
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   590
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   591
     * Apply configuration properties.  Only applies the CONFIG whitelist
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   592
     * @method applyConfig
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   593
     * @param o hash of properties to apply
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   594
     * @param force {boolean} if true, properties that exist on the event 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   595
     * will be overwritten.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   596
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   597
    applyConfig: function(o, force) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   598
        if (o) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   599
            Y.mix(this, o, force, CONFIGS);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   600
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   601
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   602
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   603
    _on: function(fn, context, args, when) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   604
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   605
        if (!fn) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   606
            this.log("Invalid callback for CE: " + this.type);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   607
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   608
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   609
        var s = new Y.Subscriber(fn, context, args, when);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   610
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   611
        if (this.fireOnce && this.fired) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   612
            Y.later(0, this, Y.bind(this._notify, this, s, this.firedWith));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   613
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   614
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   615
        if (when == AFTER) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   616
            this.afters[s.id] = s;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   617
            this.hasAfters = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   618
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   619
            this.subscribers[s.id] = s;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   620
            this.hasSubscribers = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   621
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   622
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   623
        return new Y.EventHandle(this, s);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   624
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   625
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   626
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   627
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   628
     * Listen for this event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   629
     * @method subscribe
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   630
     * @param {Function} fn        The function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   631
     * @return {EventHandle|EventTarget} unsubscribe handle or a
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   632
     * chainable event target depending on the 'chain' config.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   633
     * @deprecated use on
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   634
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   635
    subscribe: function(fn, context) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   636
        var a = (arguments.length > 2) ? Y.Array(arguments, 2, true): null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   637
        return this._on(fn, context, a, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   638
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   639
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   640
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   641
     * Listen for this event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   642
     * @method on
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   643
     * @param {Function} fn        The function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   644
     * @return {EventHandle|EventTarget} unsubscribe handle or a
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   645
     * chainable event target depending on the 'chain' config.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   646
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   647
    on: function(fn, context) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   648
        var a = (arguments.length > 2) ? Y.Array(arguments, 2, true): null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   649
        return this._on(fn, context, a, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   650
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   651
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   652
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   653
     * Listen for this event after the normal subscribers have been notified and
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   654
     * the default behavior has been applied.  If a normal subscriber prevents the 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   655
     * default behavior, it also prevents after listeners from firing.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   656
     * @method after
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   657
     * @param {Function} fn        The function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   658
     * @return {EventHandle|EventTarget} unsubscribe handle or a
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   659
     * chainable event target depending on the 'chain' config.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   660
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   661
    after: function(fn, context) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   662
        var a = (arguments.length > 2) ? Y.Array(arguments, 2, true): null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   663
        return this._on(fn, context, a, AFTER);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   664
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   665
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   666
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   667
     * Detach listeners.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   668
     * @method detach 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   669
     * @param {Function} fn  The subscribed function to remove, if not supplied
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   670
     *                       all will be removed
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   671
     * @param {Object}   context The context object passed to subscribe.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   672
     * @return {int|EventTarget} returns a chainable event target
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   673
     * or the number of subscribers unsubscribed.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   674
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   675
    detach: function(fn, context) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   676
        // unsubscribe handle
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   677
        if (fn && fn.detach) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   678
            return fn.detach();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   679
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   680
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   681
        var found = 0, subs = this.subscribers, i, s;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   682
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   683
        for (i in subs) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   684
            if (subs.hasOwnProperty(i)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   685
                s = subs[i];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   686
                if (s && (!fn || fn === s.fn)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   687
                    this._delete(s);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   688
                    found++;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   689
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   690
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   691
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   692
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   693
        return found;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   694
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   695
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   696
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   697
     * Detach listeners.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   698
     * @method unsubscribe
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   699
     * @param {Function} fn  The subscribed function to remove, if not supplied
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   700
     *                       all will be removed
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   701
     * @param {Object}   context The context object passed to subscribe.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   702
     * @return {boolean|EventTarget} returns a chainable event target
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   703
     * or a boolean for legacy detach support.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   704
     * @deprecated use detach
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   705
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   706
    unsubscribe: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   707
        return this.detach.apply(this, arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   708
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   709
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   710
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   711
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   712
     * Notify a single subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   713
     * @method _notify
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   714
     * @param s {Subscriber} the subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   715
     * @param args {Array} the arguments array to apply to the listener
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   716
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   717
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   718
    _notify: function(s, args, ef) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   719
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   720
        this.log(this.type + "->" + "sub: " +  s.id);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   721
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   722
        var ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   723
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   724
        ret = s.notify(args, this);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   725
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   726
        if (false === ret || this.stopped > 1) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   727
            this.log(this.type + " cancelled by subscriber");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   728
            return false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   729
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   730
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   731
        return true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   732
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   733
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   734
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   735
     * Logger abstraction to centralize the application of the silent flag
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   736
     * @method log
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   737
     * @param msg {string} message to log
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   738
     * @param cat {string} log category
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   739
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   740
    log: function(msg, cat) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   741
        if (!this.silent) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   742
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   743
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   744
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   745
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   746
     * Notifies the subscribers.  The callback functions will be executed
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   747
     * from the context specified when the event was created, and with the 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   748
     * following parameters:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   749
     *   <ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   750
     *   <li>The type of event</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   751
     *   <li>All of the arguments fire() was executed with as an array</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   752
     *   <li>The custom object (if any) that was passed into the subscribe() 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   753
     *       method</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   754
     *   </ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   755
     * @method fire 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   756
     * @param {Object*} arguments an arbitrary set of parameters to pass to 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   757
     *                            the handler.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   758
     * @return {boolean} false if one of the subscribers returned false, 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   759
     *                   true otherwise
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   760
     * 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   761
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   762
    fire: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   763
        if (this.fireOnce && this.fired) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   764
            this.log('fireOnce event: ' + this.type + ' already fired');
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   765
            return true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   766
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   767
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   768
            var args = Y.Array(arguments, 0, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   769
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   770
            this.fired = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   771
            this.firedWith = args;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   772
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   773
            if (this.emitFacade) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   774
                return this.fireComplex(args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   775
            } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   776
                return this.fireSimple(args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   777
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   778
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   779
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   780
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   781
    fireSimple: function(args) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   782
        if (this.hasSubscribers || this.hasAfters) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   783
            this._procSubs(Y.merge(this.subscribers, this.afters), args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   784
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   785
        this._broadcast(args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   786
        return this.stopped ? false : true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   787
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   788
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   789
    // Requires the event-custom-complex module for full funcitonality.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   790
    fireComplex: function(args) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   791
        args[0] = args[0] || {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   792
        return this.fireSimple(args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   793
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   794
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   795
    _procSubs: function(subs, args, ef) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   796
        var s, i;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   797
        for (i in subs) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   798
            if (subs.hasOwnProperty(i)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   799
                s = subs[i];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   800
                if (s && s.fn) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   801
                    if (false === this._notify(s, args, ef)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   802
                        this.stopped = 2;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   803
                    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   804
                    if (this.stopped == 2) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   805
                        return false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   806
                    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   807
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   808
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   809
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   810
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   811
        return true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   812
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   813
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   814
    _broadcast: function(args) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   815
        if (!this.stopped && this.broadcast) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   816
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   817
            var a = Y.Array(args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   818
            a.unshift(this.type);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   819
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   820
            if (this.host !== Y) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   821
                Y.fire.apply(Y, a);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   822
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   823
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   824
            if (this.broadcast == 2) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   825
                Y.Global.fire.apply(Y.Global, a);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   826
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   827
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   828
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   829
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   830
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   831
     * Removes all listeners
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   832
     * @method unsubscribeAll
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   833
     * @return {int} The number of listeners unsubscribed
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   834
     * @deprecated use detachAll
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   835
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   836
    unsubscribeAll: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   837
        return this.detachAll.apply(this, arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   838
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   839
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   840
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   841
     * Removes all listeners
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   842
     * @method detachAll
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   843
     * @return {int} The number of listeners unsubscribed
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   844
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   845
    detachAll: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   846
        return this.detach();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   847
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   848
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   849
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   850
     * @method _delete
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   851
     * @param subscriber object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   852
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   853
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   854
    _delete: function(s) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   855
        if (s) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   856
            delete s.fn;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   857
            delete s.context;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   858
            delete this.subscribers[s.id];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   859
            delete this.afters[s.id];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   860
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   861
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   862
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   863
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   864
/////////////////////////////////////////////////////////////////////
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   865
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   866
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   867
 * Stores the subscriber information to be used when the event fires.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   868
 * @param {Function} fn       The wrapped function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   869
 * @param {Object}   context  The value of the keyword 'this' in the listener
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   870
 * @param {Array} args*       0..n additional arguments to supply the listener
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   871
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   872
 * @class Subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   873
 * @constructor
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   874
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   875
Y.Subscriber = function(fn, context, args) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   876
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   877
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   878
     * The callback that will be execute when the event fires
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   879
     * This is wrapped by Y.rbind if obj was supplied.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   880
     * @property fn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   881
     * @type Function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   882
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   883
    this.fn = fn;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   884
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   885
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   886
     * Optional 'this' keyword for the listener
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   887
     * @property context
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   888
     * @type Object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   889
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   890
    this.context = context;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   891
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   892
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   893
     * Unique subscriber id
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   894
     * @property id
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   895
     * @type String
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   896
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   897
    this.id = Y.stamp(this);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   898
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   899
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   900
     * Additional arguments to propagate to the subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   901
     * @property args
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   902
     * @type Array
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   903
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   904
    this.args = args;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   905
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   906
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   907
     * Custom events for a given fire transaction.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   908
     * @property events
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   909
     * @type {EventTarget}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   910
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   911
    this.events = null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   912
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   913
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   914
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   915
Y.Subscriber.prototype = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   916
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   917
    _notify: function(c, args, ce) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   918
        var a = this.args, ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   919
        switch (ce.signature) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   920
            case 0:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   921
                ret = this.fn.call(c, ce.type, args, c);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   922
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   923
            case 1:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   924
                ret = this.fn.call(c, args[0] || null, c);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   925
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   926
            default:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   927
                if (a || args) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   928
                    args = args || [];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   929
                    a = (a) ? args.concat(a) : args;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   930
                    ret = this.fn.apply(c, a);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   931
                } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   932
                    ret = this.fn.call(c);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   933
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   934
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   935
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   936
        return ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   937
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   938
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   939
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   940
     * Executes the subscriber.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   941
     * @method notify
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   942
     * @param args {Array} Arguments array for the subscriber
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   943
     * @param ce {CustomEvent} The custom event that sent the notification
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   944
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   945
    notify: function(args, ce) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   946
        var c = this.context,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   947
            ret = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   948
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   949
        if (!c) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   950
            c = (ce.contextFn) ? ce.contextFn() : ce.context;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   951
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   952
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   953
        // only catch errors if we will not re-throw them.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   954
        if (Y.config.throwFail) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   955
            ret = this._notify(c, args, ce);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   956
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   957
            try {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   958
                ret = this._notify(c, args, ce);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   959
            } catch(e) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   960
                Y.error(this + ' failed: ' + e.message, e);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   961
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   962
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   963
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   964
        return ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   965
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   966
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   967
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   968
     * Returns true if the fn and obj match this objects properties.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   969
     * Used by the unsubscribe method to match the right subscriber.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   970
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   971
     * @method contains
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   972
     * @param {Function} fn the function to execute
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   973
     * @param {Object} context optional 'this' keyword for the listener
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   974
     * @return {boolean} true if the supplied arguments match this 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   975
     *                   subscriber's signature.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   976
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   977
    contains: function(fn, context) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   978
        if (context) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   979
            return ((this.fn == fn) && this.context == context);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   980
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   981
            return (this.fn == fn);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   982
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   983
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   984
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   985
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   986
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   987
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   988
 * Custom event engine, DOM event listener abstraction layer, synthetic DOM 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   989
 * events.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   990
 * @module event-custom
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   991
 * @submodule event-custom-base
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   992
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   993
(function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   994
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   995
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   996
 * EventTarget provides the implementation for any object to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   997
 * publish, subscribe and fire to custom events, and also
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   998
 * alows other EventTargets to target the object with events
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   999
 * sourced from the other object.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1000
 * EventTarget is designed to be used with Y.augment to wrap 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1001
 * EventCustom in an interface that allows events to be listened to 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1002
 * and fired by name.  This makes it possible for implementing code to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1003
 * subscribe to an event that either has not been created yet, or will
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1004
 * not be created at all.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1005
 * @class EventTarget
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1006
 * @param opts a configuration object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1007
 * @config emitFacade {boolean} if true, all events will emit event 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1008
 * facade payloads by default (default false)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1009
 * @config prefix {string} the prefix to apply to non-prefixed event names 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1010
 * @config chain {boolean} if true, on/after/detach return the host to allow 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1011
 * chaining, otherwise they return an EventHandle (default false)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1012
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1013
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1014
var L = Y.Lang,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1015
    PREFIX_DELIMITER = ':',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1016
    CATEGORY_DELIMITER = '|',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1017
    AFTER_PREFIX = '~AFTER~',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1018
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1019
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1020
     * If the instance has a prefix attribute and the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1021
     * event type is not prefixed, the instance prefix is
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1022
     * applied to the supplied type.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1023
     * @method _getType
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1024
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1025
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1026
    _getType = Y.cached(function(type, pre) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1027
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1028
        if (!pre || !L.isString(type) || type.indexOf(PREFIX_DELIMITER) > -1) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1029
            return type;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1030
        } 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1031
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1032
        return pre + PREFIX_DELIMITER + type;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1033
    }),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1034
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1035
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1036
     * Returns an array with the detach key (if provided),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1037
     * and the prefixed event name from _getType
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1038
     * Y.on('detachcategory, menu:click', fn)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1039
     * @method _parseType
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1040
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1041
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1042
    _parseType = Y.cached(function(type, pre) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1043
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1044
        var t = type, detachcategory, after, i;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1045
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1046
        if (!L.isString(t)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1047
            return t;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1048
        } 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1049
        
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1050
        i = t.indexOf(AFTER_PREFIX);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1051
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1052
        if (i > -1) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1053
            after = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1054
            t = t.substr(AFTER_PREFIX.length);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1055
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1056
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1057
        i = t.indexOf(CATEGORY_DELIMITER);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1058
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1059
        if (i > -1) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1060
            detachcategory = t.substr(0, (i));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1061
            t = t.substr(i+1);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1062
            if (t == '*') {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1063
                t = null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1064
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1065
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1066
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1067
        // detach category, full type with instance prefix, is this an after listener, short type
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1068
        return [detachcategory, (pre) ? _getType(t, pre) : t, after, t];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1069
    }),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1070
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1071
    ET = function(opts) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1072
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1073
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1074
        var o = (L.isObject(opts)) ? opts : {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1075
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1076
        this._yuievt = this._yuievt || {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1077
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1078
            id: Y.guid(),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1079
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1080
            events: {},
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1081
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1082
            targets: {},
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1083
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1084
            config: o,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1085
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1086
            chain: ('chain' in o) ? o.chain : Y.config.chain,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1087
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1088
            defaults: {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1089
                context: o.context || this, 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1090
                host: this,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1091
                emitFacade: o.emitFacade,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1092
                fireOnce: o.fireOnce,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1093
                queuable: o.queuable,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1094
                broadcast: o.broadcast,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1095
                bubbles: ('bubbles' in o) ? o.bubbles : true
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1096
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1097
        };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1098
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1099
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1100
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1101
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1102
ET.prototype = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1103
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1104
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1105
     * Subscribe to a custom event hosted by this object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1106
     * @method on 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1107
     * @param type    {string}   The type of the event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1108
     * @param fn {Function} The callback
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1109
     * @return the event target or a detach handle per 'chain' config
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1110
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1111
    on: function(type, fn, context, x) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1112
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1113
        var parts = _parseType(type, this._yuievt.config.prefix), f, c, args, ret, ce,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1114
            detachcategory, handle, store = Y.Env.evt.handles, after, adapt, shorttype,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1115
            Node = Y.Node, n, domevent;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1116
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1117
        if (L.isObject(type)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1118
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1119
            if (L.isFunction(type)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1120
                return Y.Do.before.apply(Y.Do, arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1121
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1122
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1123
            f = fn; 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1124
            c = context; 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1125
            args = Y.Array(arguments, 0, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1126
            ret = {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1127
            after = type._after;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1128
            delete type._after;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1129
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1130
            Y.each(type, function(v, k) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1131
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1132
                if (v) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1133
                    f = v.fn || ((Y.Lang.isFunction(v)) ? v : f);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1134
                    c = v.context || c;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1135
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1136
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1137
                args[0] = (after) ? AFTER_PREFIX + k : k;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1138
                args[1] = f;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1139
                args[2] = c;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1140
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1141
                ret[k] = this.on.apply(this, args); 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1142
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1143
            }, this);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1144
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1145
            return (this._yuievt.chain) ? this : new Y.EventHandle(ret);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1146
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1147
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1148
        
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1149
        detachcategory = parts[0];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1150
        after = parts[2];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1151
        shorttype = parts[3];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1152
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1153
        // extra redirection so we catch adaptor events too.  take a look at this.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1154
        if (Node && (this instanceof Node) && (shorttype in Node.DOM_EVENTS)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1155
            args = Y.Array(arguments, 0, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1156
            args.splice(2, 0, Node.getDOMNode(this));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1157
            return Y.on.apply(Y, args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1158
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1159
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1160
        type = parts[1];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1161
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1162
        if (this instanceof YUI) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1163
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1164
            adapt = Y.Env.evt.plugins[type];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1165
            args  = Y.Array(arguments, 0, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1166
            args[0] = shorttype;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1167
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1168
            if (Node) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1169
                n = args[2];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1170
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1171
                if (n instanceof Y.NodeList) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1172
                    n = Y.NodeList.getDOMNodes(n);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1173
                } else if (n instanceof Node) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1174
                    n = Node.getDOMNode(n);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1175
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1176
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1177
                domevent = (shorttype in Node.DOM_EVENTS);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1178
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1179
                // Captures both DOM events and event plugins.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1180
                if (domevent) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1181
                    args[2] = n;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1182
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1183
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1184
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1185
            // check for the existance of an event adaptor
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1186
            if (adapt) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1187
                handle = adapt.on.apply(Y, args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1188
            } else if ((!type) || domevent) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1189
                handle = Y.Event._attach(args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1190
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1191
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1192
        } 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1193
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1194
        if (!handle) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1195
            ce = this._yuievt.events[type] || this.publish(type);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1196
            handle = ce._on(fn, context, (arguments.length > 3) ? Y.Array(arguments, 3, true) : null, (after) ? 'after' : true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1197
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1198
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1199
        if (detachcategory) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1200
            store[detachcategory] = store[detachcategory] || {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1201
            store[detachcategory][type] = store[detachcategory][type] || [];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1202
            store[detachcategory][type].push(handle);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1203
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1204
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1205
        return (this._yuievt.chain) ? this : handle;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1206
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1207
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1208
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1209
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1210
     * subscribe to an event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1211
     * @method subscribe
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1212
     * @deprecated use on
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1213
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1214
    subscribe: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1215
        return this.on.apply(this, arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1216
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1217
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1218
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1219
     * Detach one or more listeners the from the specified event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1220
     * @method detach 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1221
     * @param type {string|Object}   Either the handle to the subscriber or the 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1222
     *                        type of event.  If the type
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1223
     *                        is not specified, it will attempt to remove
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1224
     *                        the listener from all hosted events.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1225
     * @param fn   {Function} The subscribed function to unsubscribe, if not
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1226
     *                          supplied, all subscribers will be removed.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1227
     * @param context  {Object}   The custom object passed to subscribe.  This is
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1228
     *                        optional, but if supplied will be used to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1229
     *                        disambiguate multiple listeners that are the same
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1230
     *                        (e.g., you subscribe many object using a function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1231
     *                        that lives on the prototype)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1232
     * @return {EventTarget} the host
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1233
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1234
    detach: function(type, fn, context) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1235
        var evts = this._yuievt.events, i, ret,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1236
            Node = Y.Node, isNode = (this instanceof Node);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1237
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1238
        // detachAll disabled on the Y instance.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1239
        if (!type && (this !== Y)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1240
            for (i in evts) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1241
                if (evts.hasOwnProperty(i)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1242
                    ret = evts[i].detach(fn, context);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1243
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1244
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1245
            if (isNode) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1246
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1247
                Y.Event.purgeElement(Node.getDOMNode(this));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1248
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1249
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1250
            return ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1251
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1252
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1253
        var parts = _parseType(type, this._yuievt.config.prefix), 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1254
        detachcategory = L.isArray(parts) ? parts[0] : null,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1255
        shorttype = (parts) ? parts[3] : null,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1256
        handle, adapt, store = Y.Env.evt.handles, cat, args,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1257
        ce,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1258
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1259
        keyDetacher = function(lcat, ltype) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1260
            var handles = lcat[ltype];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1261
            if (handles) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1262
                while (handles.length) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1263
                    handle = handles.pop();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1264
                    handle.detach();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1265
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1266
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1267
        };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1268
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1269
        if (detachcategory) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1270
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1271
            cat = store[detachcategory];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1272
            type = parts[1];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1273
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1274
            if (cat) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1275
                if (type) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1276
                    keyDetacher(cat, type);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1277
                } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1278
                    for (i in cat) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1279
                        if (cat.hasOwnProperty(i)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1280
                            keyDetacher(cat, i);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1281
                        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1282
                    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1283
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1284
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1285
                return (this._yuievt.chain) ? this : true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1286
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1287
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1288
        // If this is an event handle, use it to detach
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1289
        } else if (L.isObject(type) && type.detach) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1290
            ret = type.detach();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1291
            return (this._yuievt.chain) ? this : ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1292
        // extra redirection so we catch adaptor events too.  take a look at this.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1293
        } else if (isNode && ((!shorttype) || (shorttype in Node.DOM_EVENTS))) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1294
            args = Y.Array(arguments, 0, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1295
            args[2] = Node.getDOMNode(this);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1296
            return Y.detach.apply(Y, args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1297
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1298
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1299
        adapt = Y.Env.evt.plugins[shorttype];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1300
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1301
        // The YUI instance handles DOM events and adaptors
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1302
        if (this instanceof YUI) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1303
            args = Y.Array(arguments, 0, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1304
            // use the adaptor specific detach code if
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1305
            if (adapt && adapt.detach) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1306
                return adapt.detach.apply(Y, args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1307
            // DOM event fork
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1308
            } else if (!type || (!adapt && Node && (type in Node.DOM_EVENTS))) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1309
                args[0] = type;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1310
                return Y.Event.detach.apply(Y.Event, args);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1311
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1312
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1313
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1314
        ce = evts[type];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1315
        if (ce) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1316
            ret = ce.detach(fn, context);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1317
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1318
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1319
        return (this._yuievt.chain) ? this : ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1320
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1321
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1322
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1323
     * detach a listener
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1324
     * @method unsubscribe
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1325
     * @deprecated use detach
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1326
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1327
    unsubscribe: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1328
        return this.detach.apply(this, arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1329
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1330
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1331
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1332
     * Removes all listeners from the specified event.  If the event type
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1333
     * is not specified, all listeners from all hosted custom events will
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1334
     * be removed.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1335
     * @method detachAll
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1336
     * @param type {string}   The type, or name of the event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1337
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1338
    detachAll: function(type) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1339
        return this.detach(type);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1340
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1341
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1342
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1343
     * Removes all listeners from the specified event.  If the event type
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1344
     * is not specified, all listeners from all hosted custom events will
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1345
     * be removed.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1346
     * @method unsubscribeAll
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1347
     * @param type {string}   The type, or name of the event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1348
     * @deprecated use detachAll
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1349
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1350
    unsubscribeAll: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1351
        return this.detachAll.apply(this, arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1352
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1353
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1354
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1355
     * Creates a new custom event of the specified type.  If a custom event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1356
     * by that name already exists, it will not be re-created.  In either
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1357
     * case the custom event is returned. 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1358
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1359
     * @method publish
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1360
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1361
     * @param type {string} the type, or name of the event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1362
     * @param opts {object} optional config params.  Valid properties are:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1363
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1364
     *  <ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1365
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1366
     *   'broadcast': whether or not the YUI instance and YUI global are notified when the event is fired (false)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1367
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1368
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1369
     *   'bubbles': whether or not this event bubbles (true)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1370
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1371
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1372
     *   'context': the default execution context for the listeners (this)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1373
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1374
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1375
     *   'defaultFn': the default function to execute when this event fires if preventDefault was not called
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1376
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1377
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1378
     *   'emitFacade': whether or not this event emits a facade (false)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1379
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1380
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1381
     *   'prefix': the prefix for this targets events, e.g., 'menu' in 'menu:click' 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1382
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1383
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1384
     *   'fireOnce': if an event is configured to fire once, new subscribers after
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1385
     *   the fire will be notified immediately.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1386
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1387
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1388
     *   'preventable': whether or not preventDefault() has an effect (true)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1389
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1390
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1391
     *   'preventedFn': a function that is executed when preventDefault is called
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1392
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1393
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1394
     *   'queuable': whether or not this event can be queued during bubbling (false)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1395
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1396
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1397
     *   'silent': if silent is true, debug messages are not provided for this event.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1398
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1399
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1400
     *   'stoppedFn': a function that is executed when stopPropagation is called
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1401
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1402
     *    <li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1403
     *   'type': the event type (valid option if not provided as the first parameter to publish)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1404
     *    </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1405
     *  </ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1406
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1407
     *  @return {Event.Custom} the custom event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1408
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1409
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1410
    publish: function(type, opts) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1411
        var events, ce, ret, pre = this._yuievt.config.prefix;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1412
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1413
        type = (pre) ? _getType(type, pre) : type;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1414
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1415
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1416
        if (L.isObject(type)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1417
            ret = {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1418
            Y.each(type, function(v, k) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1419
                ret[k] = this.publish(k, v || opts); 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1420
            }, this);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1421
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1422
            return ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1423
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1424
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1425
        events = this._yuievt.events; 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1426
        ce = events[type];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1427
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1428
        if (ce) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1429
// ce.log("publish applying new config to published event: '"+type+"' exists", 'info', 'event');
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1430
            if (opts) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1431
                ce.applyConfig(opts, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1432
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1433
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1434
            // apply defaults
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1435
            ce = new Y.CustomEvent(type, (opts) ? Y.mix(opts, this._yuievt.defaults) : this._yuievt.defaults);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1436
            events[type] = ce;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1437
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1438
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1439
        // make sure we turn the broadcast flag off if this
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1440
        // event was published as a result of bubbling
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1441
        // if (opts instanceof Y.CustomEvent) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1442
          //   events[type].broadcast = false;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1443
        // }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1444
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1445
        return events[type];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1446
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1447
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1448
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1449
     * Registers another EventTarget as a bubble target.  Bubble order
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1450
     * is determined by the order registered.  Multiple targets can
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1451
     * be specified.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1452
     * @method addTarget
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1453
     * @param o {EventTarget} the target to add
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1454
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1455
    addTarget: function(o) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1456
        this._yuievt.targets[Y.stamp(o)] = o;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1457
        this._yuievt.hasTargets = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1458
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1459
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1460
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1461
     * Removes a bubble target
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1462
     * @method removeTarget
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1463
     * @param o {EventTarget} the target to remove
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1464
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1465
    removeTarget: function(o) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1466
        delete this._yuievt.targets[Y.stamp(o)];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1467
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1468
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1469
   /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1470
     * Fire a custom event by name.  The callback functions will be executed
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1471
     * from the context specified when the event was created, and with the 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1472
     * following parameters.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1473
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1474
     * If the custom event object hasn't been created, then the event hasn't 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1475
     * been published and it has no subscribers.  For performance sake, we 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1476
     * immediate exit in this case.  This means the event won't bubble, so 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1477
     * if the intention is that a bubble target be notified, the event must 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1478
     * be published on this object first.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1479
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1480
     * The first argument is the event type, and any additional arguments are
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1481
     * passed to the listeners as parameters.  If the first of these is an
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1482
     * object literal, and the event is configured to emit an event facade,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1483
     * that object is mixed into the event facade and the facade is provided 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1484
     * in place of the original object.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1485
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1486
     * @method fire
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1487
     * @param type {String|Object} The type of the event, or an object that contains
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1488
     * a 'type' property.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1489
     * @param arguments {Object*} an arbitrary set of parameters to pass to 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1490
     * the handler.  If the first of these is an object literal and the event is
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1491
     * configured to emit an event facade, the event facade will replace that
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1492
     * parameter after the properties the object literal contains are copied to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1493
     * the event facade.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1494
     * @return {Event.Target} the event host
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1495
     *                   
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1496
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1497
    fire: function(type) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1498
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1499
        var typeIncluded = L.isString(type),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1500
            t = (typeIncluded) ? type : (type && type.type),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1501
            ce, a, ret, pre=this._yuievt.config.prefix;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1502
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1503
        t = (pre) ? _getType(t, pre) : t;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1504
        ce = this.getEvent(t, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1505
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1506
        // this event has not been published or subscribed to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1507
        if (!ce) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1508
            
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1509
            if (this._yuievt.hasTargets) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1510
                a = (typeIncluded) ? arguments : Y.Array(arguments, 0, true).unshift(t);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1511
                return this.bubble(null, a, this);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1512
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1513
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1514
            // otherwise there is nothing to be done
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1515
            ret = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1516
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1517
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1518
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1519
            a = Y.Array(arguments, (typeIncluded) ? 1 : 0, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1520
            ret = ce.fire.apply(ce, a);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1521
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1522
            // clear target for next fire()
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1523
            ce.target = null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1524
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1525
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1526
        return (this._yuievt.chain) ? this : ret;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1527
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1528
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1529
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1530
     * Returns the custom event of the provided type has been created, a
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1531
     * falsy value otherwise
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1532
     * @method getEvent
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1533
     * @param type {string} the type, or name of the event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1534
     * @param prefixed {string} if true, the type is prefixed already
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1535
     * @return {Event.Custom} the custom event or null
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1536
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1537
    getEvent: function(type, prefixed) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1538
        var pre, e;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1539
        if (!prefixed) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1540
            pre = this._yuievt.config.prefix;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1541
            type = (pre) ? _getType(type, pre) : type;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1542
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1543
        e = this._yuievt.events;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1544
        return (e && type in e) ? e[type] : null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1545
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1546
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1547
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1548
     * Subscribe to a custom event hosted by this object.  The
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1549
     * supplied callback will execute after any listeners add
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1550
     * via the subscribe method, and after the default function,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1551
     * if configured for the event, has executed.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1552
     * @method after
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1553
     * @param type    {string}   The type of the event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1554
     * @param fn {Function} The callback
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1555
     * @return the event target or a detach handle per 'chain' config
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1556
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1557
    after: function(type, fn) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1558
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1559
        var a = Y.Array(arguments, 0, true);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1560
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1561
        switch (L.type(type)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1562
            case 'function':
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1563
                return Y.Do.after.apply(Y.Do, arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1564
            case 'object':
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1565
                a[0]._after = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1566
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1567
            default:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1568
                a[0] = AFTER_PREFIX + type;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1569
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1570
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1571
        return this.on.apply(this, a);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1572
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1573
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1574
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1575
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1576
     * Executes the callback before a DOM event, custom event
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1577
     * or method.  If the first argument is a function, it
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1578
     * is assumed the target is a method.  For DOM and custom
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1579
     * events, this is an alias for Y.on.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1580
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1581
     * For DOM and custom events:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1582
     * type, callback, context, 0-n arguments
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1583
     *  
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1584
     * For methods:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1585
     * callback, object (method host), methodName, context, 0-n arguments
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1586
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1587
     * @method before
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1588
     * @return detach handle
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1589
     * @deprecated use the on method
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1590
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1591
    before: function() { 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1592
        return this.on.apply(this, arguments);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1593
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1594
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1595
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1596
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1597
Y.EventTarget = ET;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1598
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1599
// make Y an event target
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1600
Y.mix(Y, ET.prototype, false, false, { 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1601
    bubbles: false 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1602
});
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1603
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1604
ET.call(Y);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1605
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1606
YUI.Env.globalEvents = YUI.Env.globalEvents || new ET();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1607
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1608
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1609
 * Hosts YUI page level events.  This is where events bubble to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1610
 * when the broadcast config is set to 2.  This property is
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1611
 * only available if the custom event module is loaded.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1612
 * @property Global
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1613
 * @type EventTarget
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1614
 * @for YUI
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1615
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1616
Y.Global = YUI.Env.globalEvents;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1617
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1618
// @TODO implement a global namespace function on Y.Global?
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1619
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1620
})();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1621
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1622
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1623
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1624
 * <code>YUI</code>'s <code>on</code> method is a unified interface for subscribing to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1625
 * most events exposed by YUI.  This includes custom events, DOM events, and 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1626
 * function events.  <code>detach</code> is also provided to remove listeners
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1627
 * serviced by this function.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1628
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1629
 * The signature that <code>on</code> accepts varies depending on the type
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1630
 * of event being consumed.  Refer to the specific methods that will
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1631
 * service a specific request for additional information about subscribing
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1632
 * to that type of event.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1633
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1634
 * <ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1635
 * <li>Custom events.  These events are defined by various
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1636
 * modules in the library.  This type of event is delegated to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1637
 * <code>EventTarget</code>'s <code>on</code> method.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1638
 *   <ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1639
 *     <li>The type of the event</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1640
 *     <li>The callback to execute</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1641
 *     <li>An optional context object</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1642
 *     <li>0..n additional arguments to supply the callback.</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1643
 *   </ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1644
 *   Example: 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1645
 *   <code>Y.on('domready', function() { // start work });</code>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1646
 * </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1647
 * <li>DOM events.  These are moments reported by the browser related
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1648
 * to browser functionality and user interaction.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1649
 * This type of event is delegated to <code>Event</code>'s 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1650
 * <code>attach</code> method.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1651
 *   <ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1652
 *     <li>The type of the event</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1653
 *     <li>The callback to execute</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1654
 *     <li>The specification for the Node(s) to attach the listener
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1655
 *     to.  This can be a selector, collections, or Node/Element
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1656
 *     refereces.</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1657
 *     <li>An optional context object</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1658
 *     <li>0..n additional arguments to supply the callback.</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1659
 *   </ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1660
 *   Example: 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1661
 *   <code>Y.on('click', function(e) { // something was clicked }, '#someelement');</code>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1662
 * </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1663
 * <li>Function events.  These events can be used to react before or after a
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1664
 * function is executed.  This type of event is delegated to <code>Event.Do</code>'s 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1665
 * <code>before</code> method.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1666
 *   <ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1667
 *     <li>The callback to execute</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1668
 *     <li>The object that has the function that will be listened for.</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1669
 *     <li>The name of the function to listen for.</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1670
 *     <li>An optional context object</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1671
 *     <li>0..n additional arguments to supply the callback.</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1672
 *   </ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1673
 *   Example <code>Y.on(function(arg1, arg2, etc) { // obj.methodname was executed }, obj 'methodname');</code>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1674
 * </li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1675
 * </ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1676
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1677
 * <code>on</code> corresponds to the moment before any default behavior of
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1678
 * the event.  <code>after</code> works the same way, but these listeners
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1679
 * execute after the event's default behavior.  <code>before</code> is an
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1680
 * alias for <code>on</code>.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1681
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1682
 * @method on 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1683
 * @param type** event type (this parameter does not apply for function events)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1684
 * @param fn the callback
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1685
 * @param target** a descriptor for the target (applies to custom events only).
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1686
 * For function events, this is the object that contains the function to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1687
 * execute.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1688
 * @param extra** 0..n Extra information a particular event may need.  These
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1689
 * will be documented with the event.  In the case of function events, this
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1690
 * is the name of the function to execute on the host.  In the case of
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1691
 * delegate listeners, this is the event delegation specification.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1692
 * @param context optionally change the value of 'this' in the callback
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1693
 * @param args* 0..n additional arguments to pass to the callback.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1694
 * @return the event target or a detach handle per 'chain' config
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1695
 * @for YUI
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1696
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1697
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1698
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1699
 * after() is a unified interface for subscribing to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1700
 * most events exposed by YUI.  This includes custom events,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1701
 * DOM events, and AOP events.  This works the same way as
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1702
 * the on() function, only it operates after any default
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1703
 * behavior for the event has executed. @see <code>on</code> for more 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1704
 * information.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1705
 * @method after
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1706
 * @param type event type (this parameter does not apply for function events)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1707
 * @param fn the callback
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1708
 * @param target a descriptor for the target (applies to custom events only).
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1709
 * For function events, this is the object that contains the function to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1710
 * execute.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1711
 * @param extra 0..n Extra information a particular event may need.  These
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1712
 * will be documented with the event.  In the case of function events, this
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1713
 * is the name of the function to execute on the host.  In the case of
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1714
 * delegate listeners, this is the event delegation specification.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1715
 * @param context optionally change the value of 'this' in the callback
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1716
 * @param args* 0..n additional arguments to pass to the callback.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1717
 * @return the event target or a detach handle per 'chain' config
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1718
 * @for YUI
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1719
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1720
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1721
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
  1722
}, '3.0.0' ,{requires:['oop']});