--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cm/media/js/lib/yui/yui3.0.0/api/event-target.js.html Mon Nov 23 15:14:29 2009 +0100
@@ -0,0 +1,888 @@
+<!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-target.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-target.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="o">(</span><span class="k">function</span><span class="o">()</span> <span class="o">{</span>
+
+<span class="c">/**</span>
+<span class="c"> * EventTarget provides the implementation for any object to</span>
+<span class="c"> * publish, subscribe and fire to custom events, and also</span>
+<span class="c"> * alows other EventTargets to target the object with events</span>
+<span class="c"> * sourced from the other object.</span>
+<span class="c"> * EventTarget is designed to be used with Y.augment to wrap </span>
+<span class="c"> * EventCustom in an interface that allows events to be listened to </span>
+<span class="c"> * and fired by name. This makes it possible for implementing code to</span>
+<span class="c"> * subscribe to an event that either has not been created yet, or will</span>
+<span class="c"> * not be created at all.</span>
+<span class="c"> * @class EventTarget</span>
+<span class="c"> * @param opts a configuration object</span>
+<span class="c"> * @config emitFacade {boolean} if true, all events will emit event </span>
+<span class="c"> * facade payloads by default (default false)</span>
+<span class="c"> * @config prefix {string} the prefix to apply to non-prefixed event names </span>
+<span class="c"> * @config chain {boolean} if true, on/after/detach return the host to allow </span>
+<span class="c"> * chaining, otherwise they return an EventHandle (default false)</span>
+<span class="c"> */</span>
+
+<span class="k">var</span> <span class="nx">L</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">PREFIX_DELIMITER</span> <span class="o">=</span> <span class="s1">':'</span><span class="o">,</span>
+ <span class="nx">CATEGORY_DELIMITER</span> <span class="o">=</span> <span class="s1">'|'</span><span class="o">,</span>
+ <span class="nx">AFTER_PREFIX</span> <span class="o">=</span> <span class="s1">'~AFTER~'</span><span class="o">,</span>
+
+ <span class="c">/**</span>
+<span class="c"> * If the instance has a prefix attribute and the</span>
+<span class="c"> * event type is not prefixed, the instance prefix is</span>
+<span class="c"> * applied to the supplied type.</span>
+<span class="c"> * @method _getType</span>
+<span class="c"> * @private</span>
+<span class="c"> */</span>
+ <span class="nx">_getType</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">cached</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">pre</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="k">if</span> <span class="o">(!</span><span class="nx">pre</span> <span class="o">||</span> <span class="o">!</span><span class="nx">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">type</span><span class="o">)</span> <span class="o">||</span> <span class="nx">type</span><span class="o">.</span><span class="nx">indexOf</span><span class="o">(</span><span class="nx">PREFIX_DELIMITER</span><span class="o">)</span> <span class="o">></span> <span class="o">-</span><span class="m">1</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="nx">type</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="k">return</span> <span class="nx">pre</span> <span class="o">+</span> <span class="nx">PREFIX_DELIMITER</span> <span class="o">+</span> <span class="nx">type</span><span class="o">;</span>
+ <span class="o">}),</span>
+
+ <span class="c">/**</span>
+<span class="c"> * Returns an array with the detach key (if provided),</span>
+<span class="c"> * and the prefixed event name from _getType</span>
+<span class="c"> * Y.on('detachcategory, menu:click', fn)</span>
+<span class="c"> * @method _parseType</span>
+<span class="c"> * @private</span>
+<span class="c"> */</span>
+ <span class="nx">_parseType</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">cached</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">pre</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="k">var</span> <span class="nx">t</span> <span class="o">=</span> <span class="nx">type</span><span class="o">,</span> <span class="nx">detachcategory</span><span class="o">,</span> <span class="nx">after</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">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">t</span><span class="o">))</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="nx">t</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="nx">i</span> <span class="o">=</span> <span class="nx">t</span><span class="o">.</span><span class="nx">indexOf</span><span class="o">(</span><span class="nx">AFTER_PREFIX</span><span class="o">);</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">i</span> <span class="o">></span> <span class="o">-</span><span class="m">1</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">after</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
+ <span class="nx">t</span> <span class="o">=</span> <span class="nx">t</span><span class="o">.</span><span class="nx">substr</span><span class="o">(</span><span class="nx">AFTER_PREFIX</span><span class="o">.</span><span class="nx">length</span><span class="o">);</span>
+ <span class="c">// Y.log(t);</span>
+<span class="c"></span> <span class="o">}</span>
+
+ <span class="nx">i</span> <span class="o">=</span> <span class="nx">t</span><span class="o">.</span><span class="nx">indexOf</span><span class="o">(</span><span class="nx">CATEGORY_DELIMITER</span><span class="o">);</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">i</span> <span class="o">></span> <span class="o">-</span><span class="m">1</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">detachcategory</span> <span class="o">=</span> <span class="nx">t</span><span class="o">.</span><span class="nx">substr</span><span class="o">(</span><span class="m">0</span><span class="o">,</span> <span class="o">(</span><span class="nx">i</span><span class="o">));</span>
+ <span class="nx">t</span> <span class="o">=</span> <span class="nx">t</span><span class="o">.</span><span class="nx">substr</span><span class="o">(</span><span class="nx">i</span><span class="o">+</span><span class="m">1</span><span class="o">);</span>
+ <span class="k">if</span> <span class="o">(</span><span class="nx">t</span> <span class="o">==</span> <span class="s1">'*'</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">t</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span>
+ <span class="o">}</span>
+ <span class="o">}</span>
+
+ <span class="c">// detach category, full type with instance prefix, is this an after listener, short type</span>
+<span class="c"></span> <span class="k">return</span> <span class="o">[</span><span class="nx">detachcategory</span><span class="o">,</span> <span class="o">(</span><span class="nx">pre</span><span class="o">)</span> <span class="o">?</span> <span class="nx">_getType</span><span class="o">(</span><span class="nx">t</span><span class="o">,</span> <span class="nx">pre</span><span class="o">)</span> <span class="o">:</span> <span class="nx">t</span><span class="o">,</span> <span class="nx">after</span><span class="o">,</span> <span class="nx">t</span><span class="o">];</span>
+ <span class="o">}),</span>
+
+ <span class="nx">ET</span> <span class="o">=</span> <span class="k">function</span><span class="o">(</span><span class="nx">opts</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="c">// Y.log('EventTarget constructor executed: ' + this._yuid);</span>
+<span class="c"></span>
+ <span class="k">var</span> <span class="nx">o</span> <span class="o">=</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isObject</span><span class="o">(</span><span class="nx">opts</span><span class="o">))</span> <span class="o">?</span> <span class="nx">opts</span> <span class="o">:</span> <span class="o">{};</span>
+
+ <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span> <span class="o">||</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">guid</span><span class="o">(),</span>
+
+ <span class="nx">events</span><span class="o">:</span> <span class="o">{},</span>
+
+ <span class="nx">targets</span><span class="o">:</span> <span class="o">{},</span>
+
+ <span class="nx">config</span><span class="o">:</span> <span class="nx">o</span><span class="o">,</span>
+
+ <span class="nx">chain</span><span class="o">:</span> <span class="o">(</span><span class="s1">'chain'</span> <span class="k">in</span> <span class="nx">o</span><span class="o">)</span> <span class="o">?</span> <span class="nx">o</span><span class="o">.</span><span class="nx">chain</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">chain</span><span class="o">,</span>
+
+ <span class="nx">defaults</span><span class="o">:</span> <span class="o">{</span>
+ <span class="nx">context</span><span class="o">:</span> <span class="nx">o</span><span class="o">.</span><span class="nx">context</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="k">this</span><span class="o">,</span>
+ <span class="nx">emitFacade</span><span class="o">:</span> <span class="nx">o</span><span class="o">.</span><span class="nx">emitFacade</span><span class="o">,</span>
+ <span class="nx">fireOnce</span><span class="o">:</span> <span class="nx">o</span><span class="o">.</span><span class="nx">fireOnce</span><span class="o">,</span>
+ <span class="nx">queuable</span><span class="o">:</span> <span class="nx">o</span><span class="o">.</span><span class="nx">queuable</span><span class="o">,</span>
+ <span class="nx">broadcast</span><span class="o">:</span> <span class="nx">o</span><span class="o">.</span><span class="nx">broadcast</span><span class="o">,</span>
+ <span class="nx">bubbles</span><span class="o">:</span> <span class="o">(</span><span class="s1">'bubbles'</span> <span class="k">in</span> <span class="nx">o</span><span class="o">)</span> <span class="o">?</span> <span class="nx">o</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="o">};</span>
+
+ <span class="o">};</span>
+
+
+<span class="nx">ET</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"> * Subscribe to a custom event hosted by this object</span>
+<span class="c"> * @method on </span>
+<span class="c"> * @param type {string} The type of the event</span>
+<span class="c"> * @param fn {Function} The callback</span>
+<span class="c"> * @return the event target or a detach handle per '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">type</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">x</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="k">var</span> <span class="nx">parts</span> <span class="o">=</span> <span class="nx">_parseType</span><span class="o">(</span><span class="nx">type</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">config</span><span class="o">.</span><span class="nx">prefix</span><span class="o">),</span> <span class="nx">f</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">ret</span><span class="o">,</span> <span class="nx">ce</span><span class="o">,</span>
+ <span class="nx">detachcategory</span><span class="o">,</span> <span class="nx">handle</span><span class="o">,</span> <span class="nx">store</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Env</span><span class="o">.</span><span class="nx">evt</span><span class="o">.</span><span class="nx">handles</span><span class="o">,</span> <span class="nx">after</span><span class="o">,</span> <span class="nx">adapt</span><span class="o">,</span> <span class="nx">shorttype</span><span class="o">,</span>
+ <span class="nx">Node</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Node</span><span class="o">,</span> <span class="nx">n</span><span class="o">,</span> <span class="nx">domevent</span><span class="o">;</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isObject</span><span class="o">(</span><span class="nx">type</span><span class="o">))</span> <span class="o">{</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isFunction</span><span class="o">(</span><span class="nx">type</span><span class="o">))</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Do</span><span class="o">.</span><span class="nx">before</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">Do</span><span class="o">,</span> <span class="nx">arguments</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="nx">f</span> <span class="o">=</span> <span class="nx">fn</span><span class="o">;</span>
+ <span class="nx">c</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">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="nx">ret</span> <span class="o">=</span> <span class="o">{};</span>
+ <span class="nx">after</span> <span class="o">=</span> <span class="nx">type</span><span class="o">.</span><span class="nx">_after</span><span class="o">;</span>
+ <span class="nx">delete</span> <span class="nx">type</span><span class="o">.</span><span class="nx">_after</span><span class="o">;</span>
+
+ <span class="nx">Y</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">type</span><span class="o">,</span> <span class="k">function</span><span class="o">(</span><span class="nx">v</span><span class="o">,</span> <span class="nx">k</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">v</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">f</span> <span class="o">=</span> <span class="nx">v</span><span class="o">.</span><span class="nx">fn</span> <span class="o">||</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">isFunction</span><span class="o">(</span><span class="nx">v</span><span class="o">))</span> <span class="o">?</span> <span class="nx">v</span> <span class="o">:</span> <span class="nx">f</span><span class="o">);</span>
+ <span class="nx">c</span> <span class="o">=</span> <span class="nx">v</span><span class="o">.</span><span class="nx">context</span> <span class="o">||</span> <span class="nx">c</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="nx">after</span><span class="o">)</span> <span class="o">?</span> <span class="nx">AFTER_PREFIX</span> <span class="o">+</span> <span class="nx">k</span> <span class="o">:</span> <span class="nx">k</span><span class="o">;</span>
+ <span class="nx">args</span><span class="o">[</span><span class="m">1</span><span class="o">]</span> <span class="o">=</span> <span class="nx">f</span><span class="o">;</span>
+ <span class="nx">args</span><span class="o">[</span><span class="m">2</span><span class="o">]</span> <span class="o">=</span> <span class="nx">c</span><span class="o">;</span>
+
+ <span class="nx">ret</span><span class="o">[</span><span class="nx">k</span><span class="o">]</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">on</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">args</span><span class="o">);</span>
+
+ <span class="o">},</span> <span class="k">this</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">_yuievt</span><span class="o">.</span><span class="nx">chain</span><span class="o">)</span> <span class="o">?</span> <span class="k">this</span> <span class="o">:</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="nx">ret</span><span class="o">);</span>
+
+ <span class="o">}</span>
+
+ <span class="nx">detachcategory</span> <span class="o">=</span> <span class="nx">parts</span><span class="o">[</span><span class="m">0</span><span class="o">];</span>
+ <span class="nx">after</span> <span class="o">=</span> <span class="nx">parts</span><span class="o">[</span><span class="m">2</span><span class="o">];</span>
+ <span class="nx">shorttype</span> <span class="o">=</span> <span class="nx">parts</span><span class="o">[</span><span class="m">3</span><span class="o">];</span>
+
+ <span class="c">// extra redirection so we catch adaptor events too. take a look at this.</span>
+<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">Node</span> <span class="o">&&</span> <span class="o">(</span><span class="k">this</span> <span class="k">instanceof</span> <span class="nx">Node</span><span class="o">)</span> <span class="o">&&</span> <span class="o">(</span><span class="nx">shorttype</span> <span class="k">in</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">DOM_EVENTS</span><span class="o">))</span> <span class="o">{</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="nx">args</span><span class="o">.</span><span class="nx">splice</span><span class="o">(</span><span class="m">2</span><span class="o">,</span> <span class="m">0</span><span class="o">,</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">getDOMNode</span><span class="o">(</span><span class="k">this</span><span class="o">));</span>
+ <span class="c">// Y.log("Node detected, redirecting with these args: " + args);</span>
+<span class="c"></span> <span class="k">return</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">on</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">args</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="nx">type</span> <span class="o">=</span> <span class="nx">parts</span><span class="o">[</span><span class="m">1</span><span class="o">];</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="k">this</span> <span class="k">instanceof</span> <span class="nx">YUI</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="nx">adapt</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Env</span><span class="o">.</span><span class="nx">evt</span><span class="o">.</span><span class="nx">plugins</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">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="nx">args</span><span class="o">[</span><span class="m">0</span><span class="o">]</span> <span class="o">=</span> <span class="nx">shorttype</span><span class="o">;</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">Node</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">n</span> <span class="o">=</span> <span class="nx">args</span><span class="o">[</span><span class="m">2</span><span class="o">];</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">n</span> <span class="k">instanceof</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">NodeList</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">n</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">NodeList</span><span class="o">.</span><span class="nx">getDOMNodes</span><span class="o">(</span><span class="nx">n</span><span class="o">);</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="k">if</span> <span class="o">(</span><span class="nx">n</span> <span class="k">instanceof</span> <span class="nx">Node</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">n</span> <span class="o">=</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">getDOMNode</span><span class="o">(</span><span class="nx">n</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="nx">domevent</span> <span class="o">=</span> <span class="o">(</span><span class="nx">shorttype</span> <span class="k">in</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">DOM_EVENTS</span><span class="o">);</span>
+
+ <span class="c">// Captures both DOM events and event plugins.</span>
+<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">domevent</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">args</span><span class="o">[</span><span class="m">2</span><span class="o">]</span> <span class="o">=</span> <span class="nx">n</span><span class="o">;</span>
+ <span class="o">}</span>
+ <span class="o">}</span>
+
+ <span class="c">// check for the existance of an event adaptor</span>
+<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">adapt</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">'Using adaptor for '</span> <span class="o">+</span> <span class="nx">shorttype</span> <span class="o">+</span> <span class="s1">', '</span> <span class="o">+</span> <span class="nx">n</span><span class="o">,</span> <span class="s1">'info'</span><span class="o">,</span> <span class="s1">'event'</span><span class="o">);</span>
+ <span class="nx">handle</span> <span class="o">=</span> <span class="nx">adapt</span><span class="o">.</span><span class="nx">on</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">args</span><span class="o">);</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="k">if</span> <span class="o">((!</span><span class="nx">type</span><span class="o">)</span> <span class="o">||</span> <span class="nx">domevent</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">handle</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Event</span><span class="o">.</span><span class="nx">_attach</span><span class="o">(</span><span class="nx">args</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="o">}</span>
+
+ <span class="k">if</span> <span class="o">(!</span><span class="nx">handle</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">ce</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">events</span><span class="o">[</span><span class="nx">type</span><span class="o">]</span> <span class="o">||</span> <span class="k">this</span><span class="o">.</span><span class="nx">publish</span><span class="o">(</span><span class="nx">type</span><span class="o">);</span>
+ <span class="nx">handle</span> <span class="o">=</span> <span class="nx">ce</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="o">(</span><span class="nx">arguments</span><span class="o">.</span><span class="nx">length</span> <span class="o">></span> <span class="m">3</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">3</span><span class="o">,</span> <span class="kc">true</span><span class="o">)</span> <span class="o">:</span> <span class="kc">null</span><span class="o">,</span> <span class="o">(</span><span class="nx">after</span><span class="o">)</span> <span class="o">?</span> <span class="s1">'after'</span> <span class="o">:</span> <span class="kc">true</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">detachcategory</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">store</span><span class="o">[</span><span class="nx">detachcategory</span><span class="o">]</span> <span class="o">=</span> <span class="nx">store</span><span class="o">[</span><span class="nx">detachcategory</span><span class="o">]</span> <span class="o">||</span> <span class="o">{};</span>
+ <span class="nx">store</span><span class="o">[</span><span class="nx">detachcategory</span><span class="o">][</span><span class="nx">type</span><span class="o">]</span> <span class="o">=</span> <span class="nx">store</span><span class="o">[</span><span class="nx">detachcategory</span><span class="o">][</span><span class="nx">type</span><span class="o">]</span> <span class="o">||</span> <span class="o">[];</span>
+ <span class="nx">store</span><span class="o">[</span><span class="nx">detachcategory</span><span class="o">][</span><span class="nx">type</span><span class="o">].</span><span class="nx">push</span><span class="o">(</span><span class="nx">handle</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">_yuievt</span><span class="o">.</span><span class="nx">chain</span><span class="o">)</span> <span class="o">?</span> <span class="k">this</span> <span class="o">:</span> <span class="nx">handle</span><span class="o">;</span>
+
+ <span class="o">},</span>
+
+ <span class="c">/**</span>
+<span class="c"> * subscribe to an event</span>
+<span class="c"> * @method subscribe</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="o">{</span>
+ <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s1">'EventTarget subscribe() is 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">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">on</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"> * Detach one or more listeners the from the specified event</span>
+<span class="c"> * @method detach </span>
+<span class="c"> * @param type {string|Object} Either the handle to the subscriber or the </span>
+<span class="c"> * type of event. If the type</span>
+<span class="c"> * is not specified, it will attempt to remove</span>
+<span class="c"> * the listener from all hosted events.</span>
+<span class="c"> * @param fn {Function} The subscribed function to unsubscribe, if not</span>
+<span class="c"> * supplied, all subscribers will be removed.</span>
+<span class="c"> * @param context {Object} The custom object passed to subscribe. This is</span>
+<span class="c"> * optional, but if supplied will be used to</span>
+<span class="c"> * disambiguate multiple listeners that are the same</span>
+<span class="c"> * (e.g., you subscribe many object using a function</span>
+<span class="c"> * that lives on the prototype)</span>
+<span class="c"> * @return {EventTarget} the host</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">type</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">evts</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">events</span><span class="o">,</span> <span class="nx">i</span><span class="o">,</span> <span class="nx">ret</span><span class="o">,</span>
+ <span class="nx">Node</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Node</span><span class="o">,</span> <span class="nx">isNode</span> <span class="o">=</span> <span class="o">(</span><span class="k">this</span> <span class="k">instanceof</span> <span class="nx">Node</span><span class="o">);</span>
+
+ <span class="c">// detachAll disabled on the Y instance.</span>
+<span class="c"></span> <span class="k">if</span> <span class="o">(!</span><span class="nx">type</span> <span class="o">&&</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="o">{</span>
+ <span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="k">in</span> <span class="nx">evts</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">if</span> <span class="o">(</span><span class="nx">evts</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">ret</span> <span class="o">=</span> <span class="nx">evts</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="nx">fn</span><span class="o">,</span> <span class="nx">context</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">}</span>
+ <span class="k">if</span> <span class="o">(</span><span class="nx">isNode</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="nx">Y</span><span class="o">.</span><span class="nx">Event</span><span class="o">.</span><span class="nx">purgeElement</span><span class="o">(</span><span class="nx">Node</span><span class="o">.</span><span class="nx">getDOMNode</span><span class="o">(</span><span class="k">this</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="k">var</span> <span class="nx">parts</span> <span class="o">=</span> <span class="nx">_parseType</span><span class="o">(</span><span class="nx">type</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">config</span><span class="o">.</span><span class="nx">prefix</span><span class="o">),</span>
+ <span class="nx">detachcategory</span> <span class="o">=</span> <span class="nx">L</span><span class="o">.</span><span class="nx">isArray</span><span class="o">(</span><span class="nx">parts</span><span class="o">)</span> <span class="o">?</span> <span class="nx">parts</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">shorttype</span> <span class="o">=</span> <span class="o">(</span><span class="nx">parts</span><span class="o">)</span> <span class="o">?</span> <span class="nx">parts</span><span class="o">[</span><span class="m">3</span><span class="o">]</span> <span class="o">:</span> <span class="kc">null</span><span class="o">,</span>
+ <span class="nx">handle</span><span class="o">,</span> <span class="nx">adapt</span><span class="o">,</span> <span class="nx">store</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Env</span><span class="o">.</span><span class="nx">evt</span><span class="o">.</span><span class="nx">handles</span><span class="o">,</span> <span class="nx">cat</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="nx">keyDetacher</span> <span class="o">=</span> <span class="k">function</span><span class="o">(</span><span class="nx">lcat</span><span class="o">,</span> <span class="nx">ltype</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">var</span> <span class="nx">handles</span> <span class="o">=</span> <span class="nx">lcat</span><span class="o">[</span><span class="nx">ltype</span><span class="o">];</span>
+ <span class="k">if</span> <span class="o">(</span><span class="nx">handles</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">while</span> <span class="o">(</span><span class="nx">handles</span><span class="o">.</span><span class="nx">length</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">handle</span> <span class="o">=</span> <span class="nx">handles</span><span class="o">.</span><span class="nx">pop</span><span class="o">();</span>
+ <span class="nx">handle</span><span class="o">.</span><span class="nx">detach</span><span class="o">();</span>
+ <span class="o">}</span>
+ <span class="o">}</span>
+ <span class="o">};</span>
+
+ <span class="k">if</span> <span class="o">(</span><span class="nx">detachcategory</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="nx">cat</span> <span class="o">=</span> <span class="nx">store</span><span class="o">[</span><span class="nx">detachcategory</span><span class="o">];</span>
+ <span class="nx">type</span> <span class="o">=</span> <span class="nx">parts</span><span class="o">[</span><span class="m">1</span><span class="o">];</span>
+
+ <span class="k">if</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="nx">type</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">keyDetacher</span><span class="o">(</span><span class="nx">cat</span><span class="o">,</span> <span class="nx">type</span><span class="o">);</span>
+ <span class="o">}</span> <span class="k">else</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">cat</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">if</span> <span class="o">(</span><span class="nx">cat</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">keyDetacher</span><span class="o">(</span><span class="nx">cat</span><span class="o">,</span> <span class="nx">i</span><span class="o">);</span>
+ <span class="o">}</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">_yuievt</span><span class="o">.</span><span class="nx">chain</span><span class="o">)</span> <span class="o">?</span> <span class="k">this</span> <span class="o">:</span> <span class="kc">true</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="c">// If this is an event handle, use it to detach</span>
+<span class="c"></span> <span class="o">}</span> <span class="k">else</span> <span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isObject</span><span class="o">(</span><span class="nx">type</span><span class="o">)</span> <span class="o">&&</span> <span class="nx">type</span><span class="o">.</span><span class="nx">detach</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">ret</span> <span class="o">=</span> <span class="nx">type</span><span class="o">.</span><span class="nx">detach</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">_yuievt</span><span class="o">.</span><span class="nx">chain</span><span class="o">)</span> <span class="o">?</span> <span class="k">this</span> <span class="o">:</span> <span class="nx">ret</span><span class="o">;</span>
+ <span class="c">// extra redirection so we catch adaptor events too. take a look at this.</span>
+<span class="c"></span> <span class="o">}</span> <span class="k">else</span> <span class="k">if</span> <span class="o">(</span><span class="nx">isNode</span> <span class="o">&&</span> <span class="o">((!</span><span class="nx">shorttype</span><span class="o">)</span> <span class="o">||</span> <span class="o">(</span><span class="nx">shorttype</span> <span class="k">in</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">DOM_EVENTS</span><span class="o">)))</span> <span class="o">{</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="nx">args</span><span class="o">[</span><span class="m">2</span><span class="o">]</span> <span class="o">=</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">getDOMNode</span><span class="o">(</span><span class="k">this</span><span class="o">);</span>
+ <span class="k">return</span> <span class="nx">Y</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="nx">Y</span><span class="o">,</span> <span class="nx">args</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="nx">adapt</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Env</span><span class="o">.</span><span class="nx">evt</span><span class="o">.</span><span class="nx">plugins</span><span class="o">[</span><span class="nx">shorttype</span><span class="o">];</span>
+
+ <span class="c">// The YUI instance handles DOM events and adaptors</span>
+<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="k">this</span> <span class="k">instanceof</span> <span class="nx">YUI</span><span class="o">)</span> <span class="o">{</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="c">// use the adaptor specific detach code if</span>
+<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">adapt</span> <span class="o">&&</span> <span class="nx">adapt</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">adapt</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="nx">Y</span><span class="o">,</span> <span class="nx">args</span><span class="o">);</span>
+ <span class="c">// DOM event fork</span>
+<span class="c"></span> <span class="o">}</span> <span class="k">else</span> <span class="k">if</span> <span class="o">(!</span><span class="nx">type</span> <span class="o">||</span> <span class="o">(!</span><span class="nx">adapt</span> <span class="o">&&</span> <span class="nx">Node</span> <span class="o">&&</span> <span class="o">(</span><span class="nx">type</span> <span class="k">in</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">DOM_EVENTS</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">type</span><span class="o">;</span>
+ <span class="k">return</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Event</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="nx">Y</span><span class="o">.</span><span class="nx">Event</span><span class="o">,</span> <span class="nx">args</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">}</span>
+
+ <span class="nx">ce</span> <span class="o">=</span> <span class="nx">evts</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="nx">ce</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">ret</span> <span class="o">=</span> <span class="nx">ce</span><span class="o">.</span><span class="nx">detach</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">return</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">chain</span><span class="o">)</span> <span class="o">?</span> <span class="k">this</span> <span class="o">:</span> <span class="nx">ret</span><span class="o">;</span>
+ <span class="o">},</span>
+
+ <span class="c">/**</span>
+<span class="c"> * detach a listener</span>
+<span class="c"> * @method unsubscribe</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"> * Removes all listeners from the specified event. If the event type</span>
+<span class="c"> * is not specified, all listeners from all hosted custom events will</span>
+<span class="c"> * be removed.</span>
+<span class="c"> * @method detachAll</span>
+<span class="c"> * @param type {string} The type, or name of the event</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="nx">type</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">type</span><span class="o">);</span>
+ <span class="o">},</span>
+
+ <span class="c">/**</span>
+<span class="c"> * Removes all listeners from the specified event. If the event type</span>
+<span class="c"> * is not specified, all listeners from all hosted custom events will</span>
+<span class="c"> * be removed.</span>
+<span class="c"> * @method unsubscribeAll</span>
+<span class="c"> * @param type {string} The type, or name of the event</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"> * Creates a new custom event of the specified type. If a custom event</span>
+<span class="c"> * by that name already exists, it will not be re-created. In either</span>
+<span class="c"> * case the custom event is returned. </span>
+<span class="c"> *</span>
+<span class="c"> * @method publish</span>
+<span class="c"> *</span>
+<span class="c"> * @param type {string} the type, or name of the event</span>
+<span class="c"> * @param opts {object} optional config params. Valid properties are:</span>
+<span class="c"> *</span>
+<span class="c"> * <ul></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'broadcast': whether or not the YUI instance and YUI global are notified when the event is fired (false)</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'bubbles': whether or not this event bubbles (true)</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'context': the default execution context for the listeners (this)</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'defaultFn': the default function to execute when this event fires if preventDefault was not called</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'emitFacade': whether or not this event emits a facade (false)</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'prefix': the prefix for this targets events, e.g., 'menu' in 'menu:click' </span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'fireOnce': if an event is configured to fire once, new subscribers after</span>
+<span class="c"> * the fire will be notified immediately.</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'preventable': whether or not preventDefault() has an effect (true)</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'preventedFn': a function that is executed when preventDefault is called</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'queuable': whether or not this event can be queued during bubbling (false)</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'silent': if silent is true, debug messages are not provided for this event.</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'stoppedFn': a function that is executed when stopPropagation is called</span>
+<span class="c"> * </li></span>
+<span class="c"> * <li></span>
+<span class="c"> * 'type': the event type (valid option if not provided as the first parameter to publish)</span>
+<span class="c"> * </li></span>
+<span class="c"> * </ul></span>
+<span class="c"> *</span>
+<span class="c"> * @return {Event.Custom} the custom event</span>
+<span class="c"> *</span>
+<span class="c"> */</span>
+ <span class="nx">publish</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">opts</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">var</span> <span class="nx">events</span><span class="o">,</span> <span class="nx">ce</span><span class="o">,</span> <span class="nx">ret</span><span class="o">,</span> <span class="nx">pre</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">config</span><span class="o">.</span><span class="nx">prefix</span><span class="o">;</span>
+
+ <span class="nx">type</span> <span class="o">=</span> <span class="o">(</span><span class="nx">pre</span><span class="o">)</span> <span class="o">?</span> <span class="nx">_getType</span><span class="o">(</span><span class="nx">type</span><span class="o">,</span> <span class="nx">pre</span><span class="o">)</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="nx">L</span><span class="o">.</span><span class="nx">isObject</span><span class="o">(</span><span class="nx">type</span><span class="o">))</span> <span class="o">{</span>
+ <span class="nx">ret</span> <span class="o">=</span> <span class="o">{};</span>
+ <span class="nx">Y</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">type</span><span class="o">,</span> <span class="k">function</span><span class="o">(</span><span class="nx">v</span><span class="o">,</span> <span class="nx">k</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">ret</span><span class="o">[</span><span class="nx">k</span><span class="o">]</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">publish</span><span class="o">(</span><span class="nx">k</span><span class="o">,</span> <span class="nx">v</span> <span class="o">||</span> <span class="nx">opts</span><span class="o">);</span>
+ <span class="o">},</span> <span class="k">this</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="nx">events</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">events</span><span class="o">;</span>
+ <span class="nx">ce</span> <span class="o">=</span> <span class="nx">events</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="nx">ce</span><span class="o">)</span> <span class="o">{</span>
+<span class="c">// ce.log("publish applying new config to published event: '"+type+"' exists", 'info', 'event');</span>
+<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">opts</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">ce</span><span class="o">.</span><span class="nx">applyConfig</span><span class="o">(</span><span class="nx">opts</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
+ <span class="c">// apply defaults</span>
+<span class="c"></span> <span class="nx">ce</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">CustomEvent</span><span class="o">(</span><span class="nx">type</span><span class="o">,</span> <span class="o">(</span><span class="nx">opts</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="nx">opts</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">defaults</span><span class="o">)</span> <span class="o">:</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">defaults</span><span class="o">);</span>
+ <span class="nx">events</span><span class="o">[</span><span class="nx">type</span><span class="o">]</span> <span class="o">=</span> <span class="nx">ce</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="c">// make sure we turn the broadcast flag off if this</span>
+<span class="c"></span> <span class="c">// event was published as a result of bubbling</span>
+<span class="c"></span> <span class="c">// if (opts instanceof Y.CustomEvent) {</span>
+<span class="c"></span> <span class="c">// events[type].broadcast = false;</span>
+<span class="c"></span> <span class="c">// }</span>
+<span class="c"></span>
+ <span class="k">return</span> <span class="nx">events</span><span class="o">[</span><span class="nx">type</span><span class="o">];</span>
+ <span class="o">},</span>
+
+ <span class="c">/**</span>
+<span class="c"> * Registers another EventTarget as a bubble target. Bubble order</span>
+<span class="c"> * is determined by the order registered. Multiple targets can</span>
+<span class="c"> * be specified.</span>
+<span class="c"> * @method addTarget</span>
+<span class="c"> * @param o {EventTarget} the target to add</span>
+<span class="c"> */</span>
+ <span class="nx">addTarget</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="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">targets</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="nx">o</span><span class="o">)]</span> <span class="o">=</span> <span class="nx">o</span><span class="o">;</span>
+ <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">hasTargets</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"> * Removes a bubble target</span>
+<span class="c"> * @method removeTarget</span>
+<span class="c"> * @param o {EventTarget} the target to remove</span>
+<span class="c"> */</span>
+ <span class="nx">removeTarget</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="o">{</span>
+ <span class="nx">delete</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">targets</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="nx">o</span><span class="o">)];</span>
+ <span class="o">},</span>
+
+ <span class="c">/**</span>
+<span class="c"> * Fire a custom event by name. 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"> *</span>
+<span class="c"> * If the custom event object hasn't been created, then the event hasn't </span>
+<span class="c"> * been published and it has no subscribers. For performance sake, we </span>
+<span class="c"> * immediate exit in this case. This means the event won't bubble, so </span>
+<span class="c"> * if the intention is that a bubble target be notified, the event must </span>
+<span class="c"> * be published on this object first.</span>
+<span class="c"> *</span>
+<span class="c"> * The first argument is the event type, and any additional arguments are</span>
+<span class="c"> * passed to the listeners as parameters. If the first of these is an</span>
+<span class="c"> * object literal, and the event is configured to emit an event facade,</span>
+<span class="c"> * that object is mixed into the event facade and the facade is provided </span>
+<span class="c"> * in place of the original object.</span>
+<span class="c"> *</span>
+<span class="c"> * @method fire</span>
+<span class="c"> * @param type {String|Object} The type of the event, or an object that contains</span>
+<span class="c"> * a 'type' property.</span>
+<span class="c"> * @param arguments {Object*} an arbitrary set of parameters to pass to </span>
+<span class="c"> * the handler. If the first of these is an object literal and the event is</span>
+<span class="c"> * configured to emit an event facade, the event facade will replace that</span>
+<span class="c"> * parameter after the properties the object literal contains are copied to</span>
+<span class="c"> * the event facade.</span>
+<span class="c"> * @return {Event.Target} the event host</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="nx">type</span><span class="o">)</span> <span class="o">{</span>
+
+ <span class="k">var</span> <span class="nx">typeIncluded</span> <span class="o">=</span> <span class="nx">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">type</span><span class="o">),</span>
+ <span class="nx">t</span> <span class="o">=</span> <span class="o">(</span><span class="nx">typeIncluded</span><span class="o">)</span> <span class="o">?</span> <span class="nx">type</span> <span class="o">:</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="nx">type</span><span class="o">),</span>
+ <span class="nx">ce</span><span class="o">,</span> <span class="nx">a</span><span class="o">,</span> <span class="nx">ret</span><span class="o">,</span> <span class="nx">pre</span><span class="o">=</span><span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">config</span><span class="o">.</span><span class="nx">prefix</span><span class="o">;</span>
+
+ <span class="nx">t</span> <span class="o">=</span> <span class="o">(</span><span class="nx">pre</span><span class="o">)</span> <span class="o">?</span> <span class="nx">_getType</span><span class="o">(</span><span class="nx">t</span><span class="o">,</span> <span class="nx">pre</span><span class="o">)</span> <span class="o">:</span> <span class="nx">t</span><span class="o">;</span>
+ <span class="nx">ce</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">getEvent</span><span class="o">(</span><span class="nx">t</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
+
+ <span class="c">// this event has not been published or subscribed to</span>
+<span class="c"></span> <span class="k">if</span> <span class="o">(!</span><span class="nx">ce</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">_yuievt</span><span class="o">.</span><span class="nx">hasTargets</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">typeIncluded</span><span class="o">)</span> <span class="o">?</span> <span class="nx">arguments</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="nx">unshift</span><span class="o">(</span><span class="nx">t</span><span class="o">);</span>
+ <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">bubble</span><span class="o">(</span><span class="kc">null</span><span class="o">,</span> <span class="nx">a</span><span class="o">,</span> <span class="k">this</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="c">// otherwise there is nothing to be done</span>
+<span class="c"></span> <span class="nx">ret</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="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">arguments</span><span class="o">,</span> <span class="o">(</span><span class="nx">typeIncluded</span><span class="o">)</span> <span class="o">?</span> <span class="m">1</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="nx">ret</span> <span class="o">=</span> <span class="nx">ce</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">ce</span><span class="o">,</span> <span class="nx">a</span><span class="o">);</span>
+
+ <span class="c">// clear target for next fire()</span>
+<span class="c"></span> <span class="nx">ce</span><span class="o">.</span><span class="nx">target</span> <span class="o">=</span> <span class="kc">null</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">_yuievt</span><span class="o">.</span><span class="nx">chain</span><span class="o">)</span> <span class="o">?</span> <span class="k">this</span> <span class="o">:</span> <span class="nx">ret</span><span class="o">;</span>
+ <span class="o">},</span>
+
+ <span class="c">/**</span>
+<span class="c"> * Returns the custom event of the provided type has been created, a</span>
+<span class="c"> * falsy value otherwise</span>
+<span class="c"> * @method getEvent</span>
+<span class="c"> * @param type {string} the type, or name of the event</span>
+<span class="c"> * @param prefixed {string} if true, the type is prefixed already</span>
+<span class="c"> * @return {Event.Custom} the custom event or null</span>
+<span class="c"> */</span>
+ <span class="nx">getEvent</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">prefixed</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">var</span> <span class="nx">pre</span><span class="o">,</span> <span class="nx">e</span><span class="o">;</span>
+ <span class="k">if</span> <span class="o">(!</span><span class="nx">prefixed</span><span class="o">)</span> <span class="o">{</span>
+ <span class="nx">pre</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">config</span><span class="o">.</span><span class="nx">prefix</span><span class="o">;</span>
+ <span class="nx">type</span> <span class="o">=</span> <span class="o">(</span><span class="nx">pre</span><span class="o">)</span> <span class="o">?</span> <span class="nx">_getType</span><span class="o">(</span><span class="nx">type</span><span class="o">,</span> <span class="nx">pre</span><span class="o">)</span> <span class="o">:</span> <span class="nx">type</span><span class="o">;</span>
+ <span class="o">}</span>
+ <span class="nx">e</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuievt</span><span class="o">.</span><span class="nx">events</span><span class="o">;</span>
+ <span class="k">return</span> <span class="o">(</span><span class="nx">e</span> <span class="o">&&</span> <span class="nx">type</span> <span class="k">in</span> <span class="nx">e</span><span class="o">)</span> <span class="o">?</span> <span class="nx">e</span><span class="o">[</span><span class="nx">type</span><span class="o">]</span> <span class="o">:</span> <span class="kc">null</span><span class="o">;</span>
+ <span class="o">},</span>
+
+ <span class="c">/**</span>
+<span class="c"> * Subscribe to a custom event hosted by this object. The</span>
+<span class="c"> * supplied callback will execute after any listeners add</span>
+<span class="c"> * via the subscribe method, and after the default function,</span>
+<span class="c"> * if configured for the event, has executed.</span>
+<span class="c"> * @method after</span>
+<span class="c"> * @param type {string} The type of the event</span>
+<span class="c"> * @param fn {Function} The callback</span>
+<span class="c"> * @return the event target or a detach handle per '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">type</span><span class="o">,</span> <span class="nx">fn</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">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="nx">switch</span> <span class="o">(</span><span class="nx">L</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="o">{</span>
+ <span class="nx">case</span> <span class="s1">'function'</span><span class="o">:</span>
+ <span class="k">return</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Do</span><span class="o">.</span><span class="nx">after</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">Do</span><span class="o">,</span> <span class="nx">arguments</span><span class="o">);</span>
+ <span class="nx">case</span> <span class="s1">'object'</span><span class="o">:</span>
+ <span class="nx">a</span><span class="o">[</span><span class="m">0</span><span class="o">].</span><span class="nx">_after</span> <span class="o">=</span> <span class="kc">true</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="nx">a</span><span class="o">[</span><span class="m">0</span><span class="o">]</span> <span class="o">=</span> <span class="nx">AFTER_PREFIX</span> <span class="o">+</span> <span class="nx">type</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">on</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">a</span><span class="o">);</span>
+
+ <span class="o">},</span>
+
+ <span class="c">/**</span>
+<span class="c"> * Executes the callback before a DOM event, custom event</span>
+<span class="c"> * or method. If the first argument is a function, it</span>
+<span class="c"> * is assumed the target is a method. For DOM and custom</span>
+<span class="c"> * events, this is an alias for Y.on.</span>
+<span class="c"> *</span>
+<span class="c"> * For DOM and custom events:</span>
+<span class="c"> * type, callback, context, 0-n arguments</span>
+<span class="c"> * </span>
+<span class="c"> * For methods:</span>
+<span class="c"> * callback, object (method host), methodName, context, 0-n arguments</span>
+<span class="c"> *</span>
+<span class="c"> * @method before</span>
+<span class="c"> * @return detach handle</span>
+<span class="c"> * @deprecated use the on method</span>
+<span class="c"> */</span>
+ <span class="nx">before</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">on</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="o">};</span>
+
+<span class="nx">Y</span><span class="o">.</span><span class="nx">EventTarget</span> <span class="o">=</span> <span class="nx">ET</span><span class="o">;</span>
+
+<span class="c">// make Y an event target</span>
+<span class="c"></span><span class="nx">Y</span><span class="o">.</span><span class="nx">mix</span><span class="o">(</span><span class="nx">Y</span><span class="o">,</span> <span class="nx">ET</span><span class="o">.</span><span class="nx">prototype</span><span class="o">,</span> <span class="kc">false</span><span class="o">,</span> <span class="kc">false</span><span class="o">,</span> <span class="o">{</span>
+ <span class="nx">bubbles</span><span class="o">:</span> <span class="kc">false</span>
+<span class="o">});</span>
+
+<span class="nx">ET</span><span class="o">.</span><span class="nx">call</span><span class="o">(</span><span class="nx">Y</span><span class="o">);</span>
+
+<span class="nx">YUI</span><span class="o">.</span><span class="nx">Env</span><span class="o">.</span><span class="nx">globalEvents</span> <span class="o">=</span> <span class="nx">YUI</span><span class="o">.</span><span class="nx">Env</span><span class="o">.</span><span class="nx">globalEvents</span> <span class="o">||</span> <span class="k">new</span> <span class="nx">ET</span><span class="o">();</span>
+
+<span class="c">/**</span>
+<span class="c"> * Hosts YUI page level events. This is where events bubble to</span>
+<span class="c"> * when the broadcast config is set to 2. This property is</span>
+<span class="c"> * only available if the custom event module is loaded.</span>
+<span class="c"> * @property Global</span>
+<span class="c"> * @type EventTarget</span>
+<span class="c"> * @for YUI</span>
+<span class="c"> */</span>
+<span class="nx">Y</span><span class="o">.</span><span class="nx">Global</span> <span class="o">=</span> <span class="nx">YUI</span><span class="o">.</span><span class="nx">Env</span><span class="o">.</span><span class="nx">globalEvents</span><span class="o">;</span>
+
+<span class="c">// @TODO implement a global namespace function on Y.Global?</span>
+<span class="c"></span>
+<span class="o">})();</span>
+
+
+<span class="c">/**</span>
+<span class="c"> * <code>YUI</code>'s <code>on</code> method is a unified interface for subscribing to</span>
+<span class="c"> * most events exposed by YUI. This includes custom events, DOM events, and </span>
+<span class="c"> * function events. <code>detach</code> is also provided to remove listeners</span>
+<span class="c"> * serviced by this function.</span>
+<span class="c"> *</span>
+<span class="c"> * The signature that <code>on</code> accepts varies depending on the type</span>
+<span class="c"> * of event being consumed. Refer to the specific methods that will</span>
+<span class="c"> * service a specific request for additional information about subscribing</span>
+<span class="c"> * to that type of event.</span>
+<span class="c"> *</span>
+<span class="c"> * <ul></span>
+<span class="c"> * <li>Custom events. These events are defined by various</span>
+<span class="c"> * modules in the library. This type of event is delegated to</span>
+<span class="c"> * <code>EventTarget</code>'s <code>on</code> method.</span>
+<span class="c"> * <ul></span>
+<span class="c"> * <li>The type of the event</li></span>
+<span class="c"> * <li>The callback to execute</li></span>
+<span class="c"> * <li>An optional context object</li></span>
+<span class="c"> * <li>0..n additional arguments to supply the callback.</li></span>
+<span class="c"> * </ul></span>
+<span class="c"> * Example: </span>
+<span class="c"> * <code>Y.on('domready', function() { // start work });</code></span>
+<span class="c"> * </li></span>
+<span class="c"> * <li>DOM events. These are moments reported by the browser related</span>
+<span class="c"> * to browser functionality and user interaction.</span>
+<span class="c"> * This type of event is delegated to <code>Event</code>'s </span>
+<span class="c"> * <code>attach</code> method.</span>
+<span class="c"> * <ul></span>
+<span class="c"> * <li>The type of the event</li></span>
+<span class="c"> * <li>The callback to execute</li></span>
+<span class="c"> * <li>The specification for the Node(s) to attach the listener</span>
+<span class="c"> * to. This can be a selector, collections, or Node/Element</span>
+<span class="c"> * refereces.</li></span>
+<span class="c"> * <li>An optional context object</li></span>
+<span class="c"> * <li>0..n additional arguments to supply the callback.</li></span>
+<span class="c"> * </ul></span>
+<span class="c"> * Example: </span>
+<span class="c"> * <code>Y.on('click', function(e) { // something was clicked }, '#someelement');</code></span>
+<span class="c"> * </li></span>
+<span class="c"> * <li>Function events. These events can be used to react before or after a</span>
+<span class="c"> * function is executed. This type of event is delegated to <code>Event.Do</code>'s </span>
+<span class="c"> * <code>before</code> method.</span>
+<span class="c"> * <ul></span>
+<span class="c"> * <li>The callback to execute</li></span>
+<span class="c"> * <li>The object that has the function that will be listened for.</li></span>
+<span class="c"> * <li>The name of the function to listen for.</li></span>
+<span class="c"> * <li>An optional context object</li></span>
+<span class="c"> * <li>0..n additional arguments to supply the callback.</li></span>
+<span class="c"> * </ul></span>
+<span class="c"> * Example <code>Y.on(function(arg1, arg2, etc) { // obj.methodname was executed }, obj 'methodname');</code></span>
+<span class="c"> * </li></span>
+<span class="c"> * </ul></span>
+<span class="c"> *</span>
+<span class="c"> * <code>on</code> corresponds to the moment before any default behavior of</span>
+<span class="c"> * the event. <code>after</code> works the same way, but these listeners</span>
+<span class="c"> * execute after the event's default behavior. <code>before</code> is an</span>
+<span class="c"> * alias for <code>on</code>.</span>
+<span class="c"> *</span>
+<span class="c"> * @method on </span>
+<span class="c"> * @param type** event type (this parameter does not apply for function events)</span>
+<span class="c"> * @param fn the callback</span>
+<span class="c"> * @param target** a descriptor for the target (applies to custom events only).</span>
+<span class="c"> * For function events, this is the object that contains the function to</span>
+<span class="c"> * execute.</span>
+<span class="c"> * @param extra** 0..n Extra information a particular event may need. These</span>
+<span class="c"> * will be documented with the event. In the case of function events, this</span>
+<span class="c"> * is the name of the function to execute on the host. In the case of</span>
+<span class="c"> * delegate listeners, this is the event delegation specification.</span>
+<span class="c"> * @param context optionally change the value of 'this' in the callback</span>
+<span class="c"> * @param args* 0..n additional arguments to pass to the callback.</span>
+<span class="c"> * @return the event target or a detach handle per 'chain' config</span>
+<span class="c"> * @for YUI</span>
+<span class="c"> */</span>
+
+<span class="c">/**</span>
+<span class="c"> * after() is a unified interface for subscribing to</span>
+<span class="c"> * most events exposed by YUI. This includes custom events,</span>
+<span class="c"> * DOM events, and AOP events. This works the same way as</span>
+<span class="c"> * the on() function, only it operates after any default</span>
+<span class="c"> * behavior for the event has executed. @see <code>on</code> for more </span>
+<span class="c"> * information.</span>
+<span class="c"> * @method after</span>
+<span class="c"> * @param type event type (this parameter does not apply for function events)</span>
+<span class="c"> * @param fn the callback</span>
+<span class="c"> * @param target a descriptor for the target (applies to custom events only).</span>
+<span class="c"> * For function events, this is the object that contains the function to</span>
+<span class="c"> * execute.</span>
+<span class="c"> * @param extra 0..n Extra information a particular event may need. These</span>
+<span class="c"> * will be documented with the event. In the case of function events, this</span>
+<span class="c"> * is the name of the function to execute on the host. In the case of</span>
+<span class="c"> * delegate listeners, this is the event delegation specification.</span>
+<span class="c"> * @param context optionally change the value of 'this' in the callback</span>
+<span class="c"> * @param args* 0..n additional arguments to pass to the callback.</span>
+<span class="c"> * @return the event target or a detach handle per 'chain' config</span>
+<span class="c"> * @for YUI</span>
+<span class="c"> */</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=""><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="selected"><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>