<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html xmlns:yui="http://yuilibrary.com/rdf/1.0/yui.rdf#">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
<title>API: event-custom event-custom.js (YUI Library)</title>
<link rel="stylesheet" type="text/css" href="assets/reset-fonts-grids-min.css" />
<link rel="stylesheet" type="text/css" href="assets/api.css" />
<script type="text/javascript" src="assets/api-js"></script>
<script type="text/javascript" src="assets/ac-js"></script>
</head>
<body id="yahoo-com">
<div id="doc3" class="yui-t2">
<div id="hd">
<h1><a href="http://developer.yahoo.com/yui/" title="Yahoo! UI Library">Yahoo! UI Library</a></h1>
<h3>event-custom <span class="subtitle">3.0.0</span></h3>
<a href="./index.html" title="Yahoo! UI Library">Yahoo! UI Library</a>
> <a href="./module_event-custom.html" title="event-custom">event-custom</a>
> event-custom.js (source view)
<form onsubmit="return false">
<div id="propertysearch">
Search: <input autocomplete="off" id="searchinput" />
<div id="searchresults">
</div>
</div>
</form>
</div>
<div id="bd">
<div id="yui-main">
<div class="yui-b">
<form action="#" name="yui-classopts-form" method="get" id="yui-classopts-form">
<fieldset>
<legend>Filters</legend>
<span class="classopts"><input type="checkbox" name="show_private" id="show_private" /> <label for="show_private">Show Private</label></span>
<span class="classopts"><input type="checkbox" name="show_protected" id="show_protected" /> <label for="show_protected">Show Protected</label></span>
<span class="classopts"><input type="checkbox" name="show_deprecated" id="show_deprecated" /> <label for="show_deprecated">Show Deprecated</label></span>
</fieldset>
</form>
<div id="srcout">
<style>
#doc3 .classopts { display:none; }
</style>
<div class="highlight" ><pre><span class="c">/**</span>
<span class="c"> * Custom event engine, DOM event listener abstraction layer, synthetic DOM </span>
<span class="c"> * events.</span>
<span class="c"> * @module event-custom</span>
<span class="c"> * @submodule event-custom-base</span>
<span class="c"> */</span>
<span class="c">/**</span>
<span class="c"> * Return value from all subscribe operations</span>
<span class="c"> * @class EventHandle</span>
<span class="c"> * @constructor</span>
<span class="c"> * @param evt {CustomEvent} the custom event</span>
<span class="c"> * @param sub {Subscriber} the subscriber</span>
<span class="c"> */</span>
<span class="c">// var onsubscribeType = "_event:onsub",</span>
<span class="c"></span><span class="k">var</span> <span class="nx">AFTER</span> <span class="o">=</span> <span class="s1">'after'</span><span class="o">,</span>
<span class="nx">CONFIGS</span> <span class="o">=</span> <span class="o">[</span>
<span class="s1">'broadcast'</span><span class="o">,</span>
<span class="s1">'bubbles'</span><span class="o">,</span>
<span class="s1">'context'</span><span class="o">,</span>
<span class="s1">'contextFn'</span><span class="o">,</span>
<span class="s1">'currentTarget'</span><span class="o">,</span>
<span class="s1">'defaultFn'</span><span class="o">,</span>
<span class="s1">'details'</span><span class="o">,</span>
<span class="s1">'emitFacade'</span><span class="o">,</span>
<span class="s1">'fireOnce'</span><span class="o">,</span>
<span class="s1">'host'</span><span class="o">,</span>
<span class="s1">'preventable'</span><span class="o">,</span>
<span class="s1">'preventedFn'</span><span class="o">,</span>
<span class="s1">'queuable'</span><span class="o">,</span>
<span class="s1">'silent'</span><span class="o">,</span>
<span class="s1">'stoppedFn'</span><span class="o">,</span>
<span class="s1">'target'</span><span class="o">,</span>
<span class="s1">'type'</span>
<span class="o">],</span>
<span class="nx">YUI3_SIGNATURE</span> <span class="o">=</span> <span class="m">9</span><span class="o">,</span>
<span class="nx">YUI_LOG</span> <span class="o">=</span> <span class="s1">'yui:log'</span><span class="o">;</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">EventHandle</span> <span class="o">=</span> <span class="k">function</span><span class="o">(</span><span class="nx">evt</span><span class="o">,</span> <span class="nx">sub</span><span class="o">)</span> <span class="o">{</span>
<span class="c">/**</span>
<span class="c"> * The custom event</span>
<span class="c"> * @type CustomEvent</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">evt</span> <span class="o">=</span> <span class="nx">evt</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * The subscriber object</span>
<span class="c"> * @type Subscriber</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">sub</span> <span class="o">=</span> <span class="nx">sub</span><span class="o">;</span>
<span class="o">};</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">EventHandle</span><span class="o">.</span><span class="nx">prototype</span> <span class="o">=</span> <span class="o">{</span>
<span class="c">/**</span>
<span class="c"> * Detaches this subscriber</span>
<span class="c"> * @method detach</span>
<span class="c"> */</span>
<span class="nx">detach</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">evt</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">evt</span><span class="o">,</span> <span class="nx">i</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">evt</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// Y.log('EventHandle.detach: ' + this.sub, 'info', 'Event');</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">Lang</span><span class="o">.</span><span class="nx">isArray</span><span class="o">(</span><span class="nx">evt</span><span class="o">))</span> <span class="o">{</span>
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span><span class="o">=</span><span class="m">0</span><span class="o">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">evt</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span><span class="o">++)</span> <span class="o">{</span>
<span class="nx">evt</span><span class="o">[</span><span class="nx">i</span><span class="o">].</span><span class="nx">detach</span><span class="o">();</span>
<span class="o">}</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">evt</span><span class="o">.</span><span class="nx">_delete</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">sub</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">};</span>
<span class="c">/**</span>
<span class="c"> * The CustomEvent class lets you define events for your application</span>
<span class="c"> * that can be subscribed to by one or more independent component.</span>
<span class="c"> *</span>
<span class="c"> * @param {String} type The type of event, which is passed to the callback</span>
<span class="c"> * when the event fires</span>
<span class="c"> * @param o configuration object</span>
<span class="c"> * @class CustomEvent</span>
<span class="c"> * @constructor</span>
<span class="c"> */</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">CustomEvent</span> <span class="o">=</span> <span class="k">function</span><span class="o">(</span><span class="nx">type</span><span class="o">,</span> <span class="nx">o</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// if (arguments.length > 2) {</span>
<span class="c">// this.log('CustomEvent context and silent are now in the config', 'warn', 'Event');</span>
<span class="c"></span> <span class="c">// }</span>
<span class="c"></span>
<span class="nx">o</span> <span class="o">=</span> <span class="nx">o</span> <span class="o">||</span> <span class="o">{};</span>
<span class="k">this</span><span class="o">.</span><span class="nx">id</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">stamp</span><span class="o">(</span><span class="k">this</span><span class="o">);</span>
<span class="c">/**</span>
<span class="c"> * The type of event, returned to subscribers when the event fires</span>
<span class="c"> * @property type</span>
<span class="c"> * @type string</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">type</span> <span class="o">=</span> <span class="nx">type</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * The context the the event will fire from by default. Defaults to the YUI</span>
<span class="c"> * instance.</span>
<span class="c"> * @property context</span>
<span class="c"> * @type object</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">context</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">;</span>
<span class="k">this</span><span class="o">.</span><span class="nx">logSystem</span> <span class="o">=</span> <span class="o">(</span><span class="nx">type</span> <span class="o">==</span> <span class="nx">YUI_LOG</span><span class="o">);</span>
<span class="c">/**</span>
<span class="c"> * If 0, this event does not broadcast. If 1, the YUI instance is notified</span>
<span class="c"> * every time this event fires. If 2, the YUI instance and the YUI global</span>
<span class="c"> * (if event is enabled on the global) are notified every time this event</span>
<span class="c"> * fires.</span>
<span class="c"> * @property broadcast</span>
<span class="c"> * @type int</span>
<span class="c"> */</span>
<span class="c">// this.broadcast = 0;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * By default all custom events are logged in the debug build, set silent</span>
<span class="c"> * to true to disable debug outpu for this event.</span>
<span class="c"> * @property silent</span>
<span class="c"> * @type boolean</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">silent</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">logSystem</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * Specifies whether this event should be queued when the host is actively</span>
<span class="c"> * processing an event. This will effect exectution order of the callbacks</span>
<span class="c"> * for the various events.</span>
<span class="c"> * @property queuable</span>
<span class="c"> * @type boolean</span>
<span class="c"> * @default false</span>
<span class="c"> */</span>
<span class="c">// this.queuable = false;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * The subscribers to this event</span>
<span class="c"> * @property subscribers</span>
<span class="c"> * @type Subscriber{}</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">subscribers</span> <span class="o">=</span> <span class="o">{};</span>
<span class="c">/**</span>
<span class="c"> * 'After' subscribers</span>
<span class="c"> * @property afters</span>
<span class="c"> * @type Subscriber{}</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">afters</span> <span class="o">=</span> <span class="o">{};</span>
<span class="c">/**</span>
<span class="c"> * This event has fired if true</span>
<span class="c"> *</span>
<span class="c"> * @property fired</span>
<span class="c"> * @type boolean</span>
<span class="c"> * @default false;</span>
<span class="c"> */</span>
<span class="c">// this.fired = false;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * An array containing the arguments the custom event</span>
<span class="c"> * was last fired with.</span>
<span class="c"> * @property firedWith</span>
<span class="c"> * @type Array</span>
<span class="c"> */</span>
<span class="c">// this.firedWith;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * This event should only fire one time if true, and if</span>
<span class="c"> * it has fired, any new subscribers should be notified</span>
<span class="c"> * immediately.</span>
<span class="c"> *</span>
<span class="c"> * @property fireOnce</span>
<span class="c"> * @type boolean</span>
<span class="c"> * @default false;</span>
<span class="c"> */</span>
<span class="c">// this.fireOnce = false;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * Flag for stopPropagation that is modified during fire()</span>
<span class="c"> * 1 means to stop propagation to bubble targets. 2 means</span>
<span class="c"> * to also stop additional subscribers on this target.</span>
<span class="c"> * @property stopped</span>
<span class="c"> * @type int</span>
<span class="c"> */</span>
<span class="c">// this.stopped = 0;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * Flag for preventDefault that is modified during fire().</span>
<span class="c"> * if it is not 0, the default behavior for this event</span>
<span class="c"> * @property prevented</span>
<span class="c"> * @type int</span>
<span class="c"> */</span>
<span class="c">// this.prevented = 0;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * Specifies the host for this custom event. This is used</span>
<span class="c"> * to enable event bubbling</span>
<span class="c"> * @property host</span>
<span class="c"> * @type EventTarget</span>
<span class="c"> */</span>
<span class="c">// this.host = null;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * The default function to execute after event listeners</span>
<span class="c"> * have fire, but only if the default action was not</span>
<span class="c"> * prevented.</span>
<span class="c"> * @property defaultFn</span>
<span class="c"> * @type Function</span>
<span class="c"> */</span>
<span class="c">// this.defaultFn = null;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * The function to execute if a subscriber calls</span>
<span class="c"> * stopPropagation or stopImmediatePropagation</span>
<span class="c"> * @property stoppedFn</span>
<span class="c"> * @type Function</span>
<span class="c"> */</span>
<span class="c">// this.stoppedFn = null;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * The function to execute if a subscriber calls</span>
<span class="c"> * preventDefault</span>
<span class="c"> * @property preventedFn</span>
<span class="c"> * @type Function</span>
<span class="c"> */</span>
<span class="c">// this.preventedFn = null;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * Specifies whether or not this event's default function</span>
<span class="c"> * can be cancelled by a subscriber by executing preventDefault() </span>
<span class="c"> * on the event facade </span>
<span class="c"> * @property preventable </span>
<span class="c"> * @type boolean </span>
<span class="c"> * @default true</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">preventable</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * Specifies whether or not a subscriber can stop the event propagation</span>
<span class="c"> * via stopPropagation(), stopImmediatePropagation(), or halt()</span>
<span class="c"> * @property bubbles</span>
<span class="c"> * @type boolean</span>
<span class="c"> * @default true</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">bubbles</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * Supports multiple options for listener signatures in order to</span>
<span class="c"> * port YUI 2 apps.</span>
<span class="c"> * @property signature</span>
<span class="c"> * @type int</span>
<span class="c"> * @default 9</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">signature</span> <span class="o">=</span> <span class="nx">YUI3_SIGNATURE</span><span class="o">;</span>
<span class="c">// this.hasSubscribers = false;</span>
<span class="c"></span>
<span class="c">// this.hasAfters = false;</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * If set to true, the custom event will deliver an EventFacade object</span>
<span class="c"> * that is similar to a DOM event object.</span>
<span class="c"> * @property emitFacade</span>
<span class="c"> * @type boolean</span>
<span class="c"> * @default false</span>
<span class="c"> */</span>
<span class="c">// this.emitFacade = false;</span>
<span class="c"></span>
<span class="k">this</span><span class="o">.</span><span class="nx">applyConfig</span><span class="o">(</span><span class="nx">o</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
<span class="c">// this.log("Creating " + this.type);</span>
<span class="c"></span>
<span class="o">};</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">CustomEvent</span><span class="o">.</span><span class="nx">prototype</span> <span class="o">=</span> <span class="o">{</span>
<span class="c">/**</span>
<span class="c"> * Apply configuration properties. Only applies the CONFIG whitelist</span>
<span class="c"> * @method applyConfig</span>
<span class="c"> * @param o hash of properties to apply</span>
<span class="c"> * @param force {boolean} if true, properties that exist on the event </span>
<span class="c"> * will be overwritten.</span>
<span class="c"> */</span>
<span class="nx">applyConfig</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">o</span><span class="o">,</span> <span class="nx">force</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">o</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">mix</span><span class="o">(</span><span class="k">this</span><span class="o">,</span> <span class="nx">o</span><span class="o">,</span> <span class="nx">force</span><span class="o">,</span> <span class="nx">CONFIGS</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="nx">_on</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">when</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">fn</span><span class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s2">"Invalid callback for CE: "</span> <span class="o">+</span> <span class="k">this</span><span class="o">.</span><span class="nx">type</span><span class="o">);</span>
<span class="o">}</span>
<span class="k">var</span> <span class="nx">s</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Subscriber</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">when</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">fireOnce</span> <span class="o">&&</span> <span class="k">this</span><span class="o">.</span><span class="nx">fired</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">later</span><span class="o">(</span><span class="m">0</span><span class="o">,</span> <span class="k">this</span><span class="o">,</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">bind</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">_notify</span><span class="o">,</span> <span class="k">this</span><span class="o">,</span> <span class="nx">s</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">firedWith</span><span class="o">));</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">when</span> <span class="o">==</span> <span class="nx">AFTER</span><span class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">afters</span><span class="o">[</span><span class="nx">s</span><span class="o">.</span><span class="nx">id</span><span class="o">]</span> <span class="o">=</span> <span class="nx">s</span><span class="o">;</span>
<span class="k">this</span><span class="o">.</span><span class="nx">hasAfters</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">subscribers</span><span class="o">[</span><span class="nx">s</span><span class="o">.</span><span class="nx">id</span><span class="o">]</span> <span class="o">=</span> <span class="nx">s</span><span class="o">;</span>
<span class="k">this</span><span class="o">.</span><span class="nx">hasSubscribers</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">return</span> <span class="k">new</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">EventHandle</span><span class="o">(</span><span class="k">this</span><span class="o">,</span> <span class="nx">s</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Listen for this event</span>
<span class="c"> * @method subscribe</span>
<span class="c"> * @param {Function} fn The function to execute</span>
<span class="c"> * @return {EventHandle|EventTarget} unsubscribe handle or a</span>
<span class="c"> * chainable event target depending on the 'chain' config.</span>
<span class="c"> * @deprecated use on</span>
<span class="c"> */</span>
<span class="nx">subscribe</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s1">'ce.subscribe deprecated, use "on"'</span><span class="o">,</span> <span class="s1">'warn'</span><span class="o">,</span> <span class="s1">'deprecated'</span><span class="o">);</span>
<span class="k">var</span> <span class="nx">a</span> <span class="o">=</span> <span class="o">(</span><span class="nx">arguments</span><span class="o">.</span><span class="nx">length</span> <span class="o">></span> <span class="m">2</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nb">Array</span><span class="o">(</span><span class="nx">arguments</span><span class="o">,</span> <span class="m">2</span><span class="o">,</span> <span class="kc">true</span><span class="o">):</span> <span class="kc">null</span><span class="o">;</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_on</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">,</span> <span class="nx">a</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Listen for this event</span>
<span class="c"> * @method on</span>
<span class="c"> * @param {Function} fn The function to execute</span>
<span class="c"> * @return {EventHandle|EventTarget} unsubscribe handle or a</span>
<span class="c"> * chainable event target depending on the 'chain' config.</span>
<span class="c"> */</span>
<span class="nx">on</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">a</span> <span class="o">=</span> <span class="o">(</span><span class="nx">arguments</span><span class="o">.</span><span class="nx">length</span> <span class="o">></span> <span class="m">2</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nb">Array</span><span class="o">(</span><span class="nx">arguments</span><span class="o">,</span> <span class="m">2</span><span class="o">,</span> <span class="kc">true</span><span class="o">):</span> <span class="kc">null</span><span class="o">;</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_on</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">,</span> <span class="nx">a</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Listen for this event after the normal subscribers have been notified and</span>
<span class="c"> * the default behavior has been applied. If a normal subscriber prevents the </span>
<span class="c"> * default behavior, it also prevents after listeners from firing.</span>
<span class="c"> * @method after</span>
<span class="c"> * @param {Function} fn The function to execute</span>
<span class="c"> * @return {EventHandle|EventTarget} unsubscribe handle or a</span>
<span class="c"> * chainable event target depending on the 'chain' config.</span>
<span class="c"> */</span>
<span class="nx">after</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">a</span> <span class="o">=</span> <span class="o">(</span><span class="nx">arguments</span><span class="o">.</span><span class="nx">length</span> <span class="o">></span> <span class="m">2</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nb">Array</span><span class="o">(</span><span class="nx">arguments</span><span class="o">,</span> <span class="m">2</span><span class="o">,</span> <span class="kc">true</span><span class="o">):</span> <span class="kc">null</span><span class="o">;</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_on</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">,</span> <span class="nx">a</span><span class="o">,</span> <span class="nx">AFTER</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Detach listeners.</span>
<span class="c"> * @method detach </span>
<span class="c"> * @param {Function} fn The subscribed function to remove, if not supplied</span>
<span class="c"> * all will be removed</span>
<span class="c"> * @param {Object} context The context object passed to subscribe.</span>
<span class="c"> * @return {int|EventTarget} returns a chainable event target</span>
<span class="c"> * or the number of subscribers unsubscribed.</span>
<span class="c"> */</span>
<span class="nx">detach</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// unsubscribe handle</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">fn</span> <span class="o">&&</span> <span class="nx">fn</span><span class="o">.</span><span class="nx">detach</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span> <span class="nx">fn</span><span class="o">.</span><span class="nx">detach</span><span class="o">();</span>
<span class="o">}</span>
<span class="k">var</span> <span class="nx">found</span> <span class="o">=</span> <span class="m">0</span><span class="o">,</span> <span class="nx">subs</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">subscribers</span><span class="o">,</span> <span class="nx">i</span><span class="o">,</span> <span class="nx">s</span><span class="o">;</span>
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="k">in</span> <span class="nx">subs</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">subs</span><span class="o">.</span><span class="nx">hasOwnProperty</span><span class="o">(</span><span class="nx">i</span><span class="o">))</span> <span class="o">{</span>
<span class="nx">s</span> <span class="o">=</span> <span class="nx">subs</span><span class="o">[</span><span class="nx">i</span><span class="o">];</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">s</span> <span class="o">&&</span> <span class="o">(!</span><span class="nx">fn</span> <span class="o">||</span> <span class="nx">fn</span> <span class="o">===</span> <span class="nx">s</span><span class="o">.</span><span class="nx">fn</span><span class="o">))</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">_delete</span><span class="o">(</span><span class="nx">s</span><span class="o">);</span>
<span class="nx">found</span><span class="o">++;</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="k">return</span> <span class="nx">found</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Detach listeners.</span>
<span class="c"> * @method unsubscribe</span>
<span class="c"> * @param {Function} fn The subscribed function to remove, if not supplied</span>
<span class="c"> * all will be removed</span>
<span class="c"> * @param {Object} context The context object passed to subscribe.</span>
<span class="c"> * @return {boolean|EventTarget} returns a chainable event target</span>
<span class="c"> * or a boolean for legacy detach support.</span>
<span class="c"> * @deprecated use detach</span>
<span class="c"> */</span>
<span class="nx">unsubscribe</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">detach</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="k">this</span><span class="o">,</span> <span class="nx">arguments</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Notify a single subscriber</span>
<span class="c"> * @method _notify</span>
<span class="c"> * @param s {Subscriber} the subscriber</span>
<span class="c"> * @param args {Array} the arguments array to apply to the listener</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_notify</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">s</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">ef</span><span class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">type</span> <span class="o">+</span> <span class="s2">"->"</span> <span class="o">+</span> <span class="s2">"sub: "</span> <span class="o">+</span> <span class="nx">s</span><span class="o">.</span><span class="nx">id</span><span class="o">);</span>
<span class="k">var</span> <span class="nx">ret</span><span class="o">;</span>
<span class="nx">ret</span> <span class="o">=</span> <span class="nx">s</span><span class="o">.</span><span class="nx">notify</span><span class="o">(</span><span class="nx">args</span><span class="o">,</span> <span class="k">this</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="kc">false</span> <span class="o">===</span> <span class="nx">ret</span> <span class="o">||</span> <span class="k">this</span><span class="o">.</span><span class="nx">stopped</span> <span class="o">></span> <span class="m">1</span><span class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">type</span> <span class="o">+</span> <span class="s2">" cancelled by subscriber"</span><span class="o">);</span>
<span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">return</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Logger abstraction to centralize the application of the silent flag</span>
<span class="c"> * @method log</span>
<span class="c"> * @param msg {string} message to log</span>
<span class="c"> * @param cat {string} log category</span>
<span class="c"> */</span>
<span class="nx">log</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">msg</span><span class="o">,</span> <span class="nx">cat</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(!</span><span class="k">this</span><span class="o">.</span><span class="nx">silent</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">id</span> <span class="o">+</span> <span class="s1">': '</span> <span class="o">+</span> <span class="nx">msg</span><span class="o">,</span> <span class="nx">cat</span> <span class="o">||</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"event"</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Notifies the subscribers. The callback functions will be executed</span>
<span class="c"> * from the context specified when the event was created, and with the </span>
<span class="c"> * following parameters:</span>
<span class="c"> * <ul></span>
<span class="c"> * <li>The type of event</li></span>
<span class="c"> * <li>All of the arguments fire() was executed with as an array</li></span>
<span class="c"> * <li>The custom object (if any) that was passed into the subscribe() </span>
<span class="c"> * method</li></span>
<span class="c"> * </ul></span>
<span class="c"> * @method fire </span>
<span class="c"> * @param {Object*} arguments an arbitrary set of parameters to pass to </span>
<span class="c"> * the handler.</span>
<span class="c"> * @return {boolean} false if one of the subscribers returned false, </span>
<span class="c"> * true otherwise</span>
<span class="c"> * </span>
<span class="c"> */</span>
<span class="nx">fire</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">fireOnce</span> <span class="o">&&</span> <span class="k">this</span><span class="o">.</span><span class="nx">fired</span><span class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s1">'fireOnce event: '</span> <span class="o">+</span> <span class="k">this</span><span class="o">.</span><span class="nx">type</span> <span class="o">+</span> <span class="s1">' already fired'</span><span class="o">);</span>
<span class="k">return</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">args</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nb">Array</span><span class="o">(</span><span class="nx">arguments</span><span class="o">,</span> <span class="m">0</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
<span class="k">this</span><span class="o">.</span><span class="nx">fired</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="k">this</span><span class="o">.</span><span class="nx">firedWith</span> <span class="o">=</span> <span class="nx">args</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">emitFacade</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">fireComplex</span><span class="o">(</span><span class="nx">args</span><span class="o">);</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">fireSimple</span><span class="o">(</span><span class="nx">args</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="nx">fireSimple</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">args</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">hasSubscribers</span> <span class="o">||</span> <span class="k">this</span><span class="o">.</span><span class="nx">hasAfters</span><span class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">_procSubs</span><span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">merge</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">subscribers</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">afters</span><span class="o">),</span> <span class="nx">args</span><span class="o">);</span>
<span class="o">}</span>
<span class="k">this</span><span class="o">.</span><span class="nx">_broadcast</span><span class="o">(</span><span class="nx">args</span><span class="o">);</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">stopped</span> <span class="o">?</span> <span class="kc">false</span> <span class="o">:</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">// Requires the event-custom-complex module for full funcitonality.</span>
<span class="c"></span> <span class="nx">fireComplex</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">args</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">args</span><span class="o">[</span><span class="m">0</span><span class="o">]</span> <span class="o">=</span> <span class="nx">args</span><span class="o">[</span><span class="m">0</span><span class="o">]</span> <span class="o">||</span> <span class="o">{};</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">fireSimple</span><span class="o">(</span><span class="nx">args</span><span class="o">);</span>
<span class="o">},</span>
<span class="nx">_procSubs</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">subs</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">ef</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">s</span><span class="o">,</span> <span class="nx">i</span><span class="o">;</span>
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="k">in</span> <span class="nx">subs</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">subs</span><span class="o">.</span><span class="nx">hasOwnProperty</span><span class="o">(</span><span class="nx">i</span><span class="o">))</span> <span class="o">{</span>
<span class="nx">s</span> <span class="o">=</span> <span class="nx">subs</span><span class="o">[</span><span class="nx">i</span><span class="o">];</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">s</span> <span class="o">&&</span> <span class="nx">s</span><span class="o">.</span><span class="nx">fn</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="kc">false</span> <span class="o">===</span> <span class="k">this</span><span class="o">.</span><span class="nx">_notify</span><span class="o">(</span><span class="nx">s</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">ef</span><span class="o">))</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">stopped</span> <span class="o">=</span> <span class="m">2</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">stopped</span> <span class="o">==</span> <span class="m">2</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="k">return</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">},</span>
<span class="nx">_broadcast</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">args</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(!</span><span class="k">this</span><span class="o">.</span><span class="nx">stopped</span> <span class="o">&&</span> <span class="k">this</span><span class="o">.</span><span class="nx">broadcast</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">a</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nb">Array</span><span class="o">(</span><span class="nx">args</span><span class="o">);</span>
<span class="nx">a</span><span class="o">.</span><span class="nx">unshift</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">type</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">host</span> <span class="o">!==</span> <span class="nx">Y</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">fire</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="nx">Y</span><span class="o">,</span> <span class="nx">a</span><span class="o">);</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">broadcast</span> <span class="o">==</span> <span class="m">2</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">Global</span><span class="o">.</span><span class="nx">fire</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">Global</span><span class="o">,</span> <span class="nx">a</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Removes all listeners</span>
<span class="c"> * @method unsubscribeAll</span>
<span class="c"> * @return {int} The number of listeners unsubscribed</span>
<span class="c"> * @deprecated use detachAll</span>
<span class="c"> */</span>
<span class="nx">unsubscribeAll</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">detachAll</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="k">this</span><span class="o">,</span> <span class="nx">arguments</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Removes all listeners</span>
<span class="c"> * @method detachAll</span>
<span class="c"> * @return {int} The number of listeners unsubscribed</span>
<span class="c"> */</span>
<span class="nx">detachAll</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">detach</span><span class="o">();</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * @method _delete</span>
<span class="c"> * @param subscriber object</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_delete</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">s</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">s</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">delete</span> <span class="nx">s</span><span class="o">.</span><span class="nx">fn</span><span class="o">;</span>
<span class="nx">delete</span> <span class="nx">s</span><span class="o">.</span><span class="nx">context</span><span class="o">;</span>
<span class="nx">delete</span> <span class="k">this</span><span class="o">.</span><span class="nx">subscribers</span><span class="o">[</span><span class="nx">s</span><span class="o">.</span><span class="nx">id</span><span class="o">];</span>
<span class="nx">delete</span> <span class="k">this</span><span class="o">.</span><span class="nx">afters</span><span class="o">[</span><span class="nx">s</span><span class="o">.</span><span class="nx">id</span><span class="o">];</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">};</span>
<span class="c">/////////////////////////////////////////////////////////////////////</span>
<span class="c"></span>
<span class="c">/**</span>
<span class="c"> * Stores the subscriber information to be used when the event fires.</span>
<span class="c"> * @param {Function} fn The wrapped function to execute</span>
<span class="c"> * @param {Object} context The value of the keyword 'this' in the listener</span>
<span class="c"> * @param {Array} args* 0..n additional arguments to supply the listener</span>
<span class="c"> *</span>
<span class="c"> * @class Subscriber</span>
<span class="c"> * @constructor</span>
<span class="c"> */</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">Subscriber</span> <span class="o">=</span> <span class="k">function</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">,</span> <span class="nx">args</span><span class="o">)</span> <span class="o">{</span>
<span class="c">/**</span>
<span class="c"> * The callback that will be execute when the event fires</span>
<span class="c"> * This is wrapped by Y.rbind if obj was supplied.</span>
<span class="c"> * @property fn</span>
<span class="c"> * @type Function</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">fn</span> <span class="o">=</span> <span class="nx">fn</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * Optional 'this' keyword for the listener</span>
<span class="c"> * @property context</span>
<span class="c"> * @type Object</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">context</span> <span class="o">=</span> <span class="nx">context</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * Unique subscriber id</span>
<span class="c"> * @property id</span>
<span class="c"> * @type String</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">id</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">stamp</span><span class="o">(</span><span class="k">this</span><span class="o">);</span>
<span class="c">/**</span>
<span class="c"> * Additional arguments to propagate to the subscriber</span>
<span class="c"> * @property args</span>
<span class="c"> * @type Array</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">args</span> <span class="o">=</span> <span class="nx">args</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * Custom events for a given fire transaction.</span>
<span class="c"> * @property events</span>
<span class="c"> * @type {EventTarget}</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">events</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span>
<span class="o">};</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">Subscriber</span><span class="o">.</span><span class="nx">prototype</span> <span class="o">=</span> <span class="o">{</span>
<span class="nx">_notify</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">c</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">ce</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">a</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">args</span><span class="o">,</span> <span class="nx">ret</span><span class="o">;</span>
<span class="nx">switch</span> <span class="o">(</span><span class="nx">ce</span><span class="o">.</span><span class="nx">signature</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">case</span> <span class="m">0</span><span class="o">:</span>
<span class="nx">ret</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">fn</span><span class="o">.</span><span class="nx">call</span><span class="o">(</span><span class="nx">c</span><span class="o">,</span> <span class="nx">ce</span><span class="o">.</span><span class="nx">type</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">c</span><span class="o">);</span>
<span class="k">break</span><span class="o">;</span>
<span class="nx">case</span> <span class="m">1</span><span class="o">:</span>
<span class="nx">ret</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">fn</span><span class="o">.</span><span class="nx">call</span><span class="o">(</span><span class="nx">c</span><span class="o">,</span> <span class="nx">args</span><span class="o">[</span><span class="m">0</span><span class="o">]</span> <span class="o">||</span> <span class="kc">null</span><span class="o">,</span> <span class="nx">c</span><span class="o">);</span>
<span class="k">break</span><span class="o">;</span>
<span class="nx">default</span><span class="o">:</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">a</span> <span class="o">||</span> <span class="nx">args</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">args</span> <span class="o">=</span> <span class="nx">args</span> <span class="o">||</span> <span class="o">[];</span>
<span class="nx">a</span> <span class="o">=</span> <span class="o">(</span><span class="nx">a</span><span class="o">)</span> <span class="o">?</span> <span class="nx">args</span><span class="o">.</span><span class="nx">concat</span><span class="o">(</span><span class="nx">a</span><span class="o">)</span> <span class="o">:</span> <span class="nx">args</span><span class="o">;</span>
<span class="nx">ret</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">fn</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="nx">c</span><span class="o">,</span> <span class="nx">a</span><span class="o">);</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">ret</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">fn</span><span class="o">.</span><span class="nx">call</span><span class="o">(</span><span class="nx">c</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="k">return</span> <span class="nx">ret</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Executes the subscriber.</span>
<span class="c"> * @method notify</span>
<span class="c"> * @param args {Array} Arguments array for the subscriber</span>
<span class="c"> * @param ce {CustomEvent} The custom event that sent the notification</span>
<span class="c"> */</span>
<span class="nx">notify</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">args</span><span class="o">,</span> <span class="nx">ce</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">c</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">context</span><span class="o">,</span>
<span class="nx">ret</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">c</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">c</span> <span class="o">=</span> <span class="o">(</span><span class="nx">ce</span><span class="o">.</span><span class="nx">contextFn</span><span class="o">)</span> <span class="o">?</span> <span class="nx">ce</span><span class="o">.</span><span class="nx">contextFn</span><span class="o">()</span> <span class="o">:</span> <span class="nx">ce</span><span class="o">.</span><span class="nx">context</span><span class="o">;</span>
<span class="o">}</span>
<span class="c">// only catch errors if we will not re-throw them.</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">config</span><span class="o">.</span><span class="nx">throwFail</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">ret</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_notify</span><span class="o">(</span><span class="nx">c</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">ce</span><span class="o">);</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="k">try</span> <span class="o">{</span>
<span class="nx">ret</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_notify</span><span class="o">(</span><span class="nx">c</span><span class="o">,</span> <span class="nx">args</span><span class="o">,</span> <span class="nx">ce</span><span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span><span class="o">(</span><span class="nx">e</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">error</span><span class="o">(</span><span class="k">this</span> <span class="o">+</span> <span class="s1">' failed: '</span> <span class="o">+</span> <span class="nx">e</span><span class="o">.</span><span class="nx">message</span><span class="o">,</span> <span class="nx">e</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="k">return</span> <span class="nx">ret</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Returns true if the fn and obj match this objects properties.</span>
<span class="c"> * Used by the unsubscribe method to match the right subscriber.</span>
<span class="c"> *</span>
<span class="c"> * @method contains</span>
<span class="c"> * @param {Function} fn the function to execute</span>
<span class="c"> * @param {Object} context optional 'this' keyword for the listener</span>
<span class="c"> * @return {boolean} true if the supplied arguments match this </span>
<span class="c"> * subscriber's signature.</span>
<span class="c"> */</span>
<span class="nx">contains</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">context</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span> <span class="o">((</span><span class="k">this</span><span class="o">.</span><span class="nx">fn</span> <span class="o">==</span> <span class="nx">fn</span><span class="o">)</span> <span class="o">&&</span> <span class="k">this</span><span class="o">.</span><span class="nx">context</span> <span class="o">==</span> <span class="nx">context</span><span class="o">);</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="k">return</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">fn</span> <span class="o">==</span> <span class="nx">fn</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">};</span>
</pre></div>
</div>
</div>
</div>
<div class="yui-b">
<div class="nav">
<div id="moduleList" class="module">
<h4>Modules</h4>
<ul class="content">
<li class=""><a href="module_anim.html" title="anim">anim</a></li>
<li class=""><a href="module_async-queue.html" title="async-queue">async-queue</a></li>
<li class=""><a href="module_attribute.html" title="attribute">attribute</a></li>
<li class=""><a href="module_base.html" title="base">base</a></li>
<li class=""><a href="module_cache.html" title="cache">cache</a></li>
<li class=""><a href="module_classnamemanager.html" title="classnamemanager">classnamemanager</a></li>
<li class=""><a href="module_collection.html" title="collection">collection</a></li>
<li class=""><a href="module_console.html" title="console">console</a></li>
<li class=""><a href="module_console-filters.html" title="console-filters">console-filters</a></li>
<li class=""><a href="module_cookie.html" title="cookie">cookie</a></li>
<li class=""><a href="module_dataschema.html" title="dataschema">dataschema</a></li>
<li class=""><a href="module_datasource.html" title="datasource">datasource</a></li>
<li class=""><a href="module_datatype.html" title="datatype">datatype</a></li>
<li class=""><a href="module_dd.html" title="dd">dd</a></li>
<li class=""><a href="module_dom.html" title="dom">dom</a></li>
<li class=""><a href="module_dump.html" title="dump">dump</a></li>
<li class=""><a href="module_event.html" title="event">event</a></li>
<li class="selected"><a href="module_event-custom.html" title="event-custom">event-custom</a></li>
<li class=""><a href="module_event-simulate.html" title="event-simulate">event-simulate</a></li>
<li class=""><a href="module_history.html" title="history">history</a></li>
<li class=""><a href="module_imageloader.html" title="imageloader">imageloader</a></li>
<li class=""><a href="module_io.html" title="io">io</a></li>
<li class=""><a href="module_json.html" title="json">json</a></li>
<li class=""><a href="module_node.html" title="node">node</a></li>
<li class=""><a href="module_node-focusmanager.html" title="node-focusmanager">node-focusmanager</a></li>
<li class=""><a href="module_node-menunav.html" title="node-menunav">node-menunav</a></li>
<li class=""><a href="module_oop.html" title="oop">oop</a></li>
<li class=""><a href="module_overlay.html" title="overlay">overlay</a></li>
<li class=""><a href="module_plugin.html" title="plugin">plugin</a></li>
<li class=""><a href="module_profiler.html" title="profiler">profiler</a></li>
<li class=""><a href="module_queue-promote.html" title="queue-promote">queue-promote</a></li>
<li class=""><a href="module_slider.html" title="slider">slider</a></li>
<li class=""><a href="module_stylesheet.html" title="stylesheet">stylesheet</a></li>
<li class=""><a href="module_substitute.html" title="substitute">substitute</a></li>
<li class=""><a href="module_test.html" title="test">test</a></li>
<li class=""><a href="module_widget.html" title="widget">widget</a></li>
<li class=""><a href="module_widget-position.html" title="widget-position">widget-position</a></li>
<li class=""><a href="module_widget-position-ext.html" title="widget-position-ext">widget-position-ext</a></li>
<li class=""><a href="module_widget-stack.html" title="widget-stack">widget-stack</a></li>
<li class=""><a href="module_widget-stdmod.html" title="widget-stdmod">widget-stdmod</a></li>
<li class=""><a href="module_yui.html" title="yui">yui</a></li>
</ul>
</div>
<div id="classList" class="module">
<h4>Classes</h4>
<ul class="content">
<li class=""><a href="CustomEvent.html" title="CustomEvent">CustomEvent</a></li>
<li class=""><a href="Do.html" title="Do">Do</a></li>
<li class=""><a href="Do.AlterArgs.html" title="Do.AlterArgs">Do.AlterArgs</a></li>
<li class=""><a href="Do.AlterReturn.html" title="Do.AlterReturn">Do.AlterReturn</a></li>
<li class=""><a href="Do.Error.html" title="Do.Error">Do.Error</a></li>
<li class=""><a href="Do.Halt.html" title="Do.Halt">Do.Halt</a></li>
<li class=""><a href="Do.Method.html" title="Do.Method">Do.Method</a></li>
<li class=""><a href="Do.Prevent.html" title="Do.Prevent">Do.Prevent</a></li>
<li class=""><a href="EventFacade.html" title="EventFacade">EventFacade</a></li>
<li class=""><a href="EventHandle.html" title="EventHandle">EventHandle</a></li>
<li class=""><a href="EventTarget.html" title="EventTarget">EventTarget</a></li>
<li class=""><a href="Subscriber.html" title="Subscriber">Subscriber</a></li>
</ul>
</div>
<div id="fileList" class="module">
<h4>Files</h4>
<ul class="content">
<li class="selected"><a href="event-custom.js.html" title="event-custom.js">event-custom.js</a></li>
<li class=""><a href="event-do.js.html" title="event-do.js">event-do.js</a></li>
<li class=""><a href="event-facade.js.html" title="event-facade.js">event-facade.js</a></li>
<li class=""><a href="event-target.js.html" title="event-target.js">event-target.js</a></li>
<li class=""><a href="event.js.html" title="event.js">event.js</a></li>
</ul>
</div>
</div>
</div>
</div>
<div id="ft">
<hr />
Copyright © 2009 Yahoo! Inc. All rights reserved.
</div>
</div>
<script type="text/javascript">
ALL_YUI_PROPS = [{"access": "", "host": "EventTarget", "name": "addTarget", "url": "EventTarget.html#method_addTarget", "type": "method"}, {"access": "", "host": "EventTarget", "name": "after", "url": "EventTarget.html#method_after", "type": "method"}, {"access": "", "host": "Do", "name": "after", "url": "Do.html#method_after", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "after", "url": "CustomEvent.html#method_after", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "afters", "url": "CustomEvent.html#property_afters", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "applyConfig", "url": "CustomEvent.html#method_applyConfig", "type": "method"}, {"access": "", "host": "Subscriber", "name": "args", "url": "Subscriber.html#property_args", "type": "property"}, {"access": "", "host": "EventTarget", "name": "before", "url": "EventTarget.html#method_before", "type": "method"}, {"access": "", "host": "Do", "name": "before", "url": "Do.html#method_before", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "broadcast", "url": "CustomEvent.html#property_broadcast", "type": "property"}, {"access": "", "host": "EventTarget", "name": "bubble", "url": "EventTarget.html#method_bubble", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "bubbles", "url": "CustomEvent.html#property_bubbles", "type": "property"}, {"access": "", "host": "Subscriber", "name": "contains", "url": "Subscriber.html#method_contains", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "context", "url": "CustomEvent.html#property_context", "type": "property"}, {"access": "", "host": "Subscriber", "name": "context", "url": "Subscriber.html#property_context", "type": "property"}, {"access": "", "host": "EventFacade", "name": "currentTarget", "url": "EventFacade.html#property_currentTarget", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "defaultFn", "url": "CustomEvent.html#property_defaultFn", "type": "property"}, {"access": "", "host": "Do.Method", "name": "delete", "url": "Do.Method.html#method_delete", "type": "method"}, {"access": "private", "host": "CustomEvent", "name": "_delete", "url": "CustomEvent.html#method__delete", "type": "method"}, {"access": "", "host": "EventTarget", "name": "detach", "url": "EventTarget.html#method_detach", "type": "method"}, {"access": "", "host": "Do", "name": "detach", "url": "Do.html#method_detach", "type": "method"}, {"access": "", "host": "EventHandle", "name": "detach", "url": "EventHandle.html#method_detach", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "detach", "url": "CustomEvent.html#method_detach", "type": "method"}, {"access": "", "host": "EventTarget", "name": "detachAll", "url": "EventTarget.html#method_detachAll", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "detachAll", "url": "CustomEvent.html#method_detachAll", "type": "method"}, {"access": "", "host": "EventFacade", "name": "details", "url": "EventFacade.html#property_details", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "emitFacade", "url": "CustomEvent.html#property_emitFacade", "type": "property"}, {"access": "", "host": "Subscriber", "name": "events", "url": "Subscriber.html#property_events", "type": "property"}, {"access": "", "host": "EventHandle", "name": "evt", "url": "EventHandle.html#property_evt", "type": "property"}, {"access": "", "host": "Do.Method", "name": "exec", "url": "Do.Method.html#method_exec", "type": "method"}, {"access": "", "host": "EventTarget", "name": "fire", "url": "EventTarget.html#method_fire", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "fire", "url": "CustomEvent.html#method_fire", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "fired", "url": "CustomEvent.html#property_fired", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "firedWith", "url": "CustomEvent.html#property_firedWith", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "fireOnce", "url": "CustomEvent.html#property_fireOnce", "type": "property"}, {"access": "", "host": "Subscriber", "name": "fn", "url": "Subscriber.html#property_fn", "type": "property"}, {"access": "", "host": "EventTarget", "name": "getEvent", "url": "EventTarget.html#method_getEvent", "type": "method"}, {"access": "private", "host": "EventTarget", "name": "_getType", "url": "EventTarget.html#method__getType", "type": "method"}, {"access": "", "host": "EventFacade", "name": "halt", "url": "EventFacade.html#method_halt", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "halt", "url": "CustomEvent.html#method_halt", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "host", "url": "CustomEvent.html#property_host", "type": "property"}, {"access": "", "host": "Subscriber", "name": "id", "url": "Subscriber.html#property_id", "type": "property"}, {"access": "private", "host": "Do", "name": "_inject", "url": "Do.html#method__inject", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "log", "url": "CustomEvent.html#method_log", "type": "method"}, {"access": "private", "host": "CustomEvent", "name": "_notify", "url": "CustomEvent.html#method__notify", "type": "method"}, {"access": "", "host": "Subscriber", "name": "notify", "url": "Subscriber.html#method_notify", "type": "method"}, {"access": "", "host": "Do", "name": "objs", "url": "Do.html#property_objs", "type": "property"}, {"access": "", "host": "EventTarget", "name": "on", "url": "EventTarget.html#method_on", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "on", "url": "CustomEvent.html#method_on", "type": "method"}, {"access": "private", "host": "EventTarget", "name": "_parseType", "url": "EventTarget.html#method__parseType", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "preventable", "url": "CustomEvent.html#property_preventable", "type": "property"}, {"access": "", "host": "EventFacade", "name": "preventDefault", "url": "EventFacade.html#method_preventDefault", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "preventDefault", "url": "CustomEvent.html#method_preventDefault", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "prevented", "url": "CustomEvent.html#property_prevented", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "preventedFn", "url": "CustomEvent.html#property_preventedFn", "type": "property"}, {"access": "", "host": "EventTarget", "name": "publish", "url": "EventTarget.html#method_publish", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "queuable", "url": "CustomEvent.html#property_queuable", "type": "property"}, {"access": "", "host": "Do.Method", "name": "register", "url": "Do.Method.html#method_register", "type": "method"}, {"access": "", "host": "EventFacade", "name": "relatedTarget", "url": "EventFacade.html#property_relatedTarget", "type": "property"}, {"access": "", "host": "EventTarget", "name": "removeTarget", "url": "EventTarget.html#method_removeTarget", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "signature", "url": "CustomEvent.html#property_signature", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "silent", "url": "CustomEvent.html#property_silent", "type": "property"}, {"access": "", "host": "EventFacade", "name": "stopImmediatePropagation", "url": "EventFacade.html#method_stopImmediatePropagation", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "stopImmediatePropagation", "url": "CustomEvent.html#method_stopImmediatePropagation", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "stopped", "url": "CustomEvent.html#property_stopped", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "stoppedFn", "url": "CustomEvent.html#property_stoppedFn", "type": "property"}, {"access": "", "host": "EventFacade", "name": "stopPropagation", "url": "EventFacade.html#method_stopPropagation", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "stopPropagation", "url": "CustomEvent.html#method_stopPropagation", "type": "method"}, {"access": "", "host": "EventHandle", "name": "sub", "url": "EventHandle.html#property_sub", "type": "property"}, {"access": "", "host": "EventTarget", "name": "subscribe", "url": "EventTarget.html#method_subscribe", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "subscribe", "url": "CustomEvent.html#method_subscribe", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "subscribers", "url": "CustomEvent.html#property_subscribers", "type": "property"}, {"access": "", "host": "EventFacade", "name": "target", "url": "EventFacade.html#property_target", "type": "property"}, {"access": "", "host": "EventFacade", "name": "type", "url": "EventFacade.html#property_type", "type": "property"}, {"access": "", "host": "CustomEvent", "name": "type", "url": "CustomEvent.html#property_type", "type": "property"}, {"access": "", "host": "EventTarget", "name": "unsubscribe", "url": "EventTarget.html#method_unsubscribe", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "unsubscribe", "url": "CustomEvent.html#method_unsubscribe", "type": "method"}, {"access": "", "host": "EventTarget", "name": "unsubscribeAll", "url": "EventTarget.html#method_unsubscribeAll", "type": "method"}, {"access": "", "host": "CustomEvent", "name": "unsubscribeAll", "url": "CustomEvent.html#method_unsubscribeAll", "type": "method"}];
</script>
</body>
</html>