<!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 event-dom.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 <span class="subtitle">3.0.0b1</span></h3>
<a href="./index.html" title="Yahoo! UI Library">Yahoo! UI Library</a>
> <a href="./module_event.html" title="event">event</a>
> event-dom.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="o">(</span><span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="c">/**</span>
<span class="c"> * DOM event listener abstraction layer</span>
<span class="c"> * @module event</span>
<span class="c"> */</span>
<span class="c">/**</span>
<span class="c"> * The event utility provides functions to add and remove event listeners,</span>
<span class="c"> * event cleansing. It also tries to automatically remove listeners it</span>
<span class="c"> * registers during the unload event.</span>
<span class="c"> *</span>
<span class="c"> * @class Event</span>
<span class="c"> * @static</span>
<span class="c"> */</span>
<span class="k">var</span> <span class="nx">add</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">add</span><span class="o">,</span>
<span class="nx">remove</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">remove</span><span class="o">,</span>
<span class="nx">onLoad</span> <span class="o">=</span> <span class="k">function</span><span class="o">()</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">windowLoaded</span> <span class="o">=</span> <span class="kc">true</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">_load</span><span class="o">();</span>
<span class="nx">remove</span><span class="o">(</span><span class="nb">window</span><span class="o">,</span> <span class="s2">"load"</span><span class="o">,</span> <span class="nx">onLoad</span><span class="o">);</span>
<span class="o">},</span>
<span class="nx">onUnload</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">Event</span><span class="o">.</span><span class="nx">_unload</span><span class="o">();</span>
<span class="nx">remove</span><span class="o">(</span><span class="nb">window</span><span class="o">,</span> <span class="s2">"unload"</span><span class="o">,</span> <span class="nx">onUnload</span><span class="o">);</span>
<span class="o">},</span>
<span class="nx">EVENT_READY</span> <span class="o">=</span> <span class="s1">'domready'</span><span class="o">,</span>
<span class="nx">COMPAT_ARG</span> <span class="o">=</span> <span class="s1">'~yui|2|compat~'</span><span class="o">,</span>
<span class="nx">shouldIterate</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">try</span> <span class="o">{</span>
<span class="c">// Y.log('node? ' + (o instanceof Y.Node) + ', ' + ((o.size) ? o.size() : ' no size'));</span>
<span class="c"></span> <span class="c">// if (o instanceof Y.Node) {</span>
<span class="c"></span> <span class="c">// o.tagName ="adsf";</span>
<span class="c"></span> <span class="c">// }</span>
<span class="c"></span>
<span class="k">return</span> <span class="o">(</span> <span class="nx">o</span> <span class="o">&&</span> <span class="c">// o is something</span>
<span class="c"></span> <span class="k">typeof</span> <span class="nx">o</span> <span class="o">!==</span> <span class="s2">"string"</span> <span class="o">&&</span> <span class="c">// o is not a string</span>
<span class="c"></span> <span class="c">// o.length && // o is indexed</span>
<span class="c"></span> <span class="o">(</span><span class="nx">o</span><span class="o">.</span><span class="nx">length</span> <span class="o">&&</span> <span class="o">((!</span><span class="nx">o</span><span class="o">.</span><span class="nx">size</span><span class="o">)</span> <span class="o">||</span> <span class="o">(</span><span class="nx">o</span><span class="o">.</span><span class="nx">size</span><span class="o">()</span> <span class="o">></span> <span class="m">1</span><span class="o">)))</span> <span class="o">&&</span> <span class="c">// o is indexed</span>
<span class="c"></span> <span class="o">!</span><span class="nx">o</span><span class="o">.</span><span class="nx">tagName</span> <span class="o">&&</span> <span class="c">// o is not an HTML element</span>
<span class="c"></span> <span class="o">!</span><span class="nx">o</span><span class="o">.</span><span class="nx">alert</span> <span class="o">&&</span> <span class="c">// o is not a window</span>
<span class="c"></span> <span class="o">(</span><span class="nx">o</span><span class="o">.</span><span class="nx">item</span> <span class="o">||</span> <span class="k">typeof</span> <span class="nx">o</span><span class="o">[</span><span class="m">0</span><span class="o">]</span> <span class="o">!==</span> <span class="s2">"undefined"</span><span class="o">)</span> <span class="o">);</span>
<span class="o">}</span> <span class="k">catch</span><span class="o">(</span><span class="nx">ex</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="s2">"collection check failure"</span><span class="o">,</span> <span class="s2">"warn"</span><span class="o">,</span> <span class="s2">"event"</span><span class="o">);</span>
<span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="nx">Event</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"> * True after the onload event has fired</span>
<span class="c"> * @property _loadComplete</span>
<span class="c"> * @type boolean</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="k">var</span> <span class="nx">_loadComplete</span> <span class="o">=</span> <span class="kc">false</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * The number of times to poll after window.onload. This number is</span>
<span class="c"> * increased if additional late-bound handlers are requested after</span>
<span class="c"> * the page load.</span>
<span class="c"> * @property _retryCount</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_retryCount</span> <span class="o">=</span> <span class="m">0</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * onAvailable listeners</span>
<span class="c"> * @property _avail</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_avail</span> <span class="o">=</span> <span class="o">[],</span>
<span class="c">/**</span>
<span class="c"> * Custom event wrappers for DOM events. Key is </span>
<span class="c"> * 'event:' + Element uid stamp + event type</span>
<span class="c"> * @property _wrappers</span>
<span class="c"> * @type Y.Event.Custom</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_wrappers</span> <span class="o">=</span> <span class="o">{},</span>
<span class="nx">_windowLoadKey</span> <span class="o">=</span> <span class="kc">null</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * Custom event wrapper map DOM events. Key is </span>
<span class="c"> * Element uid stamp. Each item is a hash of custom event</span>
<span class="c"> * wrappers as provided in the _wrappers collection. This</span>
<span class="c"> * provides the infrastructure for getListeners.</span>
<span class="c"> * @property _el_events</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_el_events</span> <span class="o">=</span> <span class="o">{};</span>
<span class="k">return</span> <span class="o">{</span>
<span class="c">/**</span>
<span class="c"> * The number of times we should look for elements that are not</span>
<span class="c"> * in the DOM at the time the event is requested after the document</span>
<span class="c"> * has been loaded. The default is 2000@amp;20 ms, so it will poll</span>
<span class="c"> * for 40 seconds or until all outstanding handlers are bound</span>
<span class="c"> * (whichever comes first).</span>
<span class="c"> * @property POLL_RETRYS</span>
<span class="c"> * @type int</span>
<span class="c"> * @static</span>
<span class="c"> * @final</span>
<span class="c"> */</span>
<span class="nx">POLL_RETRYS</span><span class="o">:</span> <span class="m">1000</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * The poll interval in milliseconds</span>
<span class="c"> * @property POLL_INTERVAL</span>
<span class="c"> * @type int</span>
<span class="c"> * @static</span>
<span class="c"> * @final</span>
<span class="c"> */</span>
<span class="nx">POLL_INTERVAL</span><span class="o">:</span> <span class="m">40</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * addListener/removeListener can throw errors in unexpected scenarios.</span>
<span class="c"> * These errors are suppressed, the method returns false, and this property</span>
<span class="c"> * is set</span>
<span class="c"> * @property lastError</span>
<span class="c"> * @static</span>
<span class="c"> * @type Error</span>
<span class="c"> */</span>
<span class="nx">lastError</span><span class="o">:</span> <span class="kc">null</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * poll handle</span>
<span class="c"> * @property _interval</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_interval</span><span class="o">:</span> <span class="kc">null</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * document readystate poll handle</span>
<span class="c"> * @property _dri</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_dri</span><span class="o">:</span> <span class="kc">null</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * True when the document is initially usable</span>
<span class="c"> * @property DOMReady</span>
<span class="c"> * @type boolean</span>
<span class="c"> * @static</span>
<span class="c"> */</span>
<span class="nx">DOMReady</span><span class="o">:</span> <span class="kc">false</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * @method startInterval</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">startInterval</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">E</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="k">if</span> <span class="o">(!</span><span class="nx">E</span><span class="o">.</span><span class="nx">_interval</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">E</span><span class="o">.</span><span class="nx">_interval</span> <span class="o">=</span> <span class="nx">setInterval</span><span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">bind</span><span class="o">(</span><span class="nx">E</span><span class="o">.</span><span class="nx">_poll</span><span class="o">,</span> <span class="nx">E</span><span class="o">),</span> <span class="nx">E</span><span class="o">.</span><span class="nx">POLL_INTERVAL</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Executes the supplied callback when the item with the supplied</span>
<span class="c"> * id is found. This is meant to be used to execute behavior as</span>
<span class="c"> * soon as possible as the page loads. If you use this after the</span>
<span class="c"> * initial page load it will poll for a fixed time for the element.</span>
<span class="c"> * The number of times it will poll and the frequency are</span>
<span class="c"> * configurable. By default it will poll for 10 seconds.</span>
<span class="c"> *</span>
<span class="c"> * <p>The callback is executed with a single parameter:</span>
<span class="c"> * the custom object parameter, if provided.</p></span>
<span class="c"> *</span>
<span class="c"> * @method onAvailable</span>
<span class="c"> *</span>
<span class="c"> * @param {string||string[]} id the id of the element, or an array</span>
<span class="c"> * of ids to look for.</span>
<span class="c"> * @param {function} fn what to execute when the element is found.</span>
<span class="c"> * @param {object} p_obj an optional object to be passed back as</span>
<span class="c"> * a parameter to fn.</span>
<span class="c"> * @param {boolean|object} p_override If set to true, fn will execute</span>
<span class="c"> * in the context of p_obj, if set to an object it</span>
<span class="c"> * will execute in the context of that object</span>
<span class="c"> * @param checkContent {boolean} check child node readiness (onContentReady)</span>
<span class="c"> * @static</span>
<span class="c"> * @deprecated Use Y.on("available")</span>
<span class="c"> */</span>
<span class="c">// @TODO fix arguments</span>
<span class="c"></span> <span class="nx">onAvailable</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">id</span><span class="o">,</span> <span class="nx">fn</span><span class="o">,</span> <span class="nx">p_obj</span><span class="o">,</span> <span class="nx">p_override</span><span class="o">,</span> <span class="nx">checkContent</span><span class="o">,</span> <span class="nx">compat</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">id</span><span class="o">),</span> <span class="nx">i</span><span class="o">;</span>
<span class="c">// Y.log('onAvailable registered for: ' + id);</span>
<span class="c"></span>
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span><span class="o">=</span><span class="m">0</span><span class="o">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">a</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span><span class="o">=</span><span class="nx">i</span><span class="o">+</span><span class="m">1</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">_avail</span><span class="o">.</span><span class="nx">push</span><span class="o">({</span>
<span class="nx">id</span><span class="o">:</span> <span class="nx">a</span><span class="o">[</span><span class="nx">i</span><span class="o">],</span>
<span class="nx">fn</span><span class="o">:</span> <span class="nx">fn</span><span class="o">,</span>
<span class="nx">obj</span><span class="o">:</span> <span class="nx">p_obj</span><span class="o">,</span>
<span class="nx">override</span><span class="o">:</span> <span class="nx">p_override</span><span class="o">,</span>
<span class="nx">checkReady</span><span class="o">:</span> <span class="nx">checkContent</span><span class="o">,</span>
<span class="nx">compat</span><span class="o">:</span> <span class="nx">compat</span>
<span class="o">});</span>
<span class="o">}</span>
<span class="nx">_retryCount</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">POLL_RETRYS</span><span class="o">;</span>
<span class="c">// We want the first test to be immediate, but async</span>
<span class="c"></span> <span class="nx">setTimeout</span><span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">bind</span><span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">Event</span><span class="o">.</span><span class="nx">_poll</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="m">0</span><span class="o">);</span>
<span class="k">return</span> <span class="k">new</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">EventHandle</span><span class="o">();</span> <span class="c">// @TODO by id needs a defered handle</span>
<span class="c"></span> <span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Works the same way as onAvailable, but additionally checks the</span>
<span class="c"> * state of sibling elements to determine if the content of the</span>
<span class="c"> * available element is safe to modify.</span>
<span class="c"> *</span>
<span class="c"> * <p>The callback is executed with a single parameter:</span>
<span class="c"> * the custom object parameter, if provided.</p></span>
<span class="c"> *</span>
<span class="c"> * @method onContentReady</span>
<span class="c"> *</span>
<span class="c"> * @param {string} id the id of the element to look for.</span>
<span class="c"> * @param {function} fn what to execute when the element is ready.</span>
<span class="c"> * @param {object} p_obj an optional object to be passed back as</span>
<span class="c"> * a parameter to fn.</span>
<span class="c"> * @param {boolean|object} p_override If set to true, fn will execute</span>
<span class="c"> * in the context of p_obj. If an object, fn will</span>
<span class="c"> * exectute in the context of that object</span>
<span class="c"> *</span>
<span class="c"> * @static</span>
<span class="c"> * @deprecated Use Y.on("contentready")</span>
<span class="c"> */</span>
<span class="c">// @TODO fix arguments</span>
<span class="c"></span> <span class="nx">onContentReady</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">id</span><span class="o">,</span> <span class="nx">fn</span><span class="o">,</span> <span class="nx">p_obj</span><span class="o">,</span> <span class="nx">p_override</span><span class="o">,</span> <span class="nx">compat</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">onAvailable</span><span class="o">(</span><span class="nx">id</span><span class="o">,</span> <span class="nx">fn</span><span class="o">,</span> <span class="nx">p_obj</span><span class="o">,</span> <span class="nx">p_override</span><span class="o">,</span> <span class="kc">true</span><span class="o">,</span> <span class="nx">compat</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Appends an event handler</span>
<span class="c"> *</span>
<span class="c"> * @method attach</span>
<span class="c"> *</span>
<span class="c"> * @param {String} type The type of event to append</span>
<span class="c"> * @param {Function} fn The method the event invokes</span>
<span class="c"> * @param {String|HTMLElement|Array|NodeList} el An id, an element </span>
<span class="c"> * reference, or a collection of ids and/or elements to assign the </span>
<span class="c"> * listener to.</span>
<span class="c"> * @param {Object} obj An arbitrary object that will be </span>
<span class="c"> * passed as a parameter to the handler</span>
<span class="c"> * @param {Boolean|object} args 0..n arguments to pass to the callback</span>
<span class="c"> * @return {Boolean} True if the action was successful or defered,</span>
<span class="c"> * false if one or more of the elements </span>
<span class="c"> * could not have the listener attached,</span>
<span class="c"> * or if the operation throws an exception.</span>
<span class="c"> * @static</span>
<span class="c"> */</span>
<span class="nx">attach</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">el</span><span class="o">,</span> <span class="nx">obj</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">Event</span><span class="o">.</span><span class="nx">_attach</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="o">},</span>
<span class="nx">_createWrapper</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="nx">type</span><span class="o">,</span> <span class="nx">capture</span><span class="o">,</span> <span class="nx">compat</span><span class="o">,</span> <span class="nx">facade</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">ek</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">el</span><span class="o">),</span>
<span class="nx">key</span> <span class="o">=</span> <span class="s1">'event:'</span> <span class="o">+</span> <span class="nx">ek</span> <span class="o">+</span> <span class="nx">type</span><span class="o">,</span>
<span class="nx">cewrapper</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="kc">false</span> <span class="o">===</span> <span class="nx">facade</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">key</span> <span class="o">+=</span> <span class="s1">'native'</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">capture</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">key</span> <span class="o">+=</span> <span class="s1">'capture'</span><span class="o">;</span>
<span class="o">}</span>
<span class="nx">cewrapper</span> <span class="o">=</span> <span class="nx">_wrappers</span><span class="o">[</span><span class="nx">key</span><span class="o">];</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">cewrapper</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// create CE wrapper</span>
<span class="c"></span> <span class="nx">cewrapper</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">publish</span><span class="o">(</span><span class="nx">key</span><span class="o">,</span> <span class="o">{</span>
<span class="c">//silent: true,</span>
<span class="c"></span> <span class="c">// host: this,</span>
<span class="c"></span> <span class="nx">bubbles</span><span class="o">:</span> <span class="kc">false</span><span class="o">,</span>
<span class="nx">contextFn</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="nx">cewrapper</span><span class="o">.</span><span class="nx">nodeRef</span> <span class="o">=</span> <span class="nx">cewrapper</span><span class="o">.</span><span class="nx">nodeRef</span> <span class="o">||</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">cewrapper</span><span class="o">.</span><span class="nx">el</span><span class="o">);</span>
<span class="k">return</span> <span class="nx">cewrapper</span><span class="o">.</span><span class="nx">nodeRef</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">});</span>
<span class="c">// for later removeListener calls</span>
<span class="c"></span> <span class="nx">cewrapper</span><span class="o">.</span><span class="nx">el</span> <span class="o">=</span> <span class="nx">el</span><span class="o">;</span>
<span class="nx">cewrapper</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">cewrapper</span><span class="o">.</span><span class="nx">fn</span> <span class="o">=</span> <span class="k">function</span><span class="o">(</span><span class="nx">e</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">cewrapper</span><span class="o">.</span><span class="nx">fire</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">getEvent</span><span class="o">(</span><span class="nx">e</span><span class="o">,</span> <span class="nx">el</span><span class="o">,</span> <span class="o">(</span><span class="nx">compat</span> <span class="o">||</span> <span class="o">(</span><span class="kc">false</span> <span class="o">===</span> <span class="nx">facade</span><span class="o">))));</span>
<span class="o">};</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">el</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">win</span> <span class="o">&&</span> <span class="nx">type</span> <span class="o">==</span> <span class="s2">"load"</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// window load happens once</span>
<span class="c"></span> <span class="nx">cewrapper</span><span class="o">.</span><span class="nx">fireOnce</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="nx">_windowLoadKey</span> <span class="o">=</span> <span class="nx">key</span><span class="o">;</span>
<span class="o">}</span>
<span class="nx">_wrappers</span><span class="o">[</span><span class="nx">key</span><span class="o">]</span> <span class="o">=</span> <span class="nx">cewrapper</span><span class="o">;</span>
<span class="nx">_el_events</span><span class="o">[</span><span class="nx">ek</span><span class="o">]</span> <span class="o">=</span> <span class="nx">_el_events</span><span class="o">[</span><span class="nx">ek</span><span class="o">]</span> <span class="o">||</span> <span class="o">{};</span>
<span class="nx">_el_events</span><span class="o">[</span><span class="nx">ek</span><span class="o">][</span><span class="nx">key</span><span class="o">]</span> <span class="o">=</span> <span class="nx">cewrapper</span><span class="o">;</span>
<span class="nx">add</span><span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="nx">type</span><span class="o">,</span> <span class="nx">cewrapper</span><span class="o">.</span><span class="nx">fn</span><span class="o">,</span> <span class="nx">capture</span><span class="o">);</span>
<span class="o">}</span>
<span class="k">return</span> <span class="nx">cewrapper</span><span class="o">;</span>
<span class="o">},</span>
<span class="nx">_attach</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">args</span><span class="o">,</span> <span class="nx">config</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">trimmedArgs</span><span class="o">=</span><span class="nx">args</span><span class="o">.</span><span class="nx">slice</span><span class="o">(</span><span class="m">1</span><span class="o">),</span>
<span class="nx">compat</span><span class="o">,</span> <span class="nx">E</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">handles</span><span class="o">,</span> <span class="nx">oEl</span><span class="o">,</span> <span class="nx">cewrapper</span><span class="o">,</span> <span class="nx">context</span><span class="o">,</span>
<span class="nx">fireNow</span> <span class="o">=</span> <span class="kc">false</span><span class="o">,</span> <span class="nx">ret</span><span class="o">,</span>
<span class="nx">type</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="nx">fn</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="nx">el</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">Y</span><span class="o">.</span><span class="nx">config</span><span class="o">.</span><span class="nx">win</span><span class="o">,</span>
<span class="nx">facade</span> <span class="o">=</span> <span class="nx">config</span> <span class="o">&&</span> <span class="nx">config</span><span class="o">.</span><span class="nx">facade</span><span class="o">,</span>
<span class="nx">capture</span> <span class="o">=</span> <span class="nx">config</span> <span class="o">&&</span> <span class="nx">config</span><span class="o">.</span><span class="nx">capture</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">trimmedArgs</span><span class="o">[</span><span class="nx">trimmedArgs</span><span class="o">.</span><span class="nx">length</span><span class="o">-</span><span class="m">1</span><span class="o">]</span> <span class="o">===</span> <span class="nx">COMPAT_ARG</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">compat</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="nx">trimmedArgs</span><span class="o">.</span><span class="nx">pop</span><span class="o">();</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">fn</span> <span class="o">||</span> <span class="o">!</span><span class="nx">fn</span><span class="o">.</span><span class="nx">call</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// throw new TypeError(type + " attach call failed, callback undefined");</span>
<span class="c"></span><span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="nx">type</span> <span class="o">+</span> <span class="s2">" attach call failed, invalid callback"</span><span class="o">,</span> <span class="s2">"error"</span><span class="o">,</span> <span class="s2">"event"</span><span class="o">);</span>
<span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
<span class="o">}</span>
<span class="c">// The el argument can be an array of elements or element ids.</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">shouldIterate</span><span class="o">(</span><span class="nx">el</span><span class="o">))</span> <span class="o">{</span>
<span class="c">// Y.log('collection: ' + el);</span>
<span class="c"></span> <span class="c">// Y.log('collection: ' + el.item(0) + ', ' + el.item(1));</span>
<span class="c"></span>
<span class="nx">handles</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">el</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">args</span><span class="o">[</span><span class="m">2</span><span class="o">]</span> <span class="o">=</span> <span class="nx">v</span><span class="o">;</span>
<span class="nx">handles</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">E</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="nx">config</span><span class="o">));</span>
<span class="o">});</span>
<span class="k">return</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="m">1</span><span class="o">)</span> <span class="o">?</span> <span class="nx">handles</span><span class="o">[</span><span class="m">0</span><span class="o">]</span> <span class="o">:</span> <span class="nx">handles</span><span class="o">;</span>
<span class="c">// If the el argument is a string, we assume it is </span>
<span class="c"></span> <span class="c">// actually the id of the element. If the page is loaded</span>
<span class="c"></span> <span class="c">// we convert el to the actual element, otherwise we </span>
<span class="c"></span> <span class="c">// defer attaching the event until the element is</span>
<span class="c"></span> <span class="c">// ready</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">Y</span><span class="o">.</span><span class="nx">Lang</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">el</span><span class="o">))</span> <span class="o">{</span>
<span class="c">// @TODO switch to using DOM directly here</span>
<span class="c"></span> <span class="c">// oEl = (compat) ? Y.DOM.byId(el) : Y.all(el);</span>
<span class="c"></span> <span class="nx">oEl</span> <span class="o">=</span> <span class="o">(</span><span class="nx">compat</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">DOM</span><span class="o">.</span><span class="nx">byId</span><span class="o">(</span><span class="nx">el</span><span class="o">)</span> <span class="o">:</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Selector</span><span class="o">.</span><span class="nx">query</span><span class="o">(</span><span class="nx">el</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">oEl</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">Lang</span><span class="o">.</span><span class="nx">isArray</span><span class="o">(</span><span class="nx">oEl</span><span class="o">))</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">oEl</span><span class="o">.</span><span class="nx">length</span> <span class="o">==</span> <span class="m">1</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">el</span> <span class="o">=</span> <span class="nx">oEl</span><span class="o">[</span><span class="m">0</span><span class="o">];</span>
<span class="o">}</span> <span class="k">else</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">oEl</span><span class="o">;</span>
<span class="k">return</span> <span class="nx">E</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="nx">config</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">// HTMLElement</span>
<span class="c"></span> <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="c">// Y.log('no size: ' + oEl + ', ' + type);</span>
<span class="c"></span> <span class="nx">el</span> <span class="o">=</span> <span class="nx">oEl</span><span class="o">;</span>
<span class="o">}</span>
<span class="c">// Not found = defer adding the event until the element is available</span>
<span class="c"></span> <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="c">// Y.log(el + ' not found');</span>
<span class="c"></span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">onAvailable</span><span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="c">// Y.log('lazy attach: ' + args);</span>
<span class="c"></span> <span class="nx">E</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="nx">config</span><span class="o">);</span>
<span class="o">},</span> <span class="nx">E</span><span class="o">,</span> <span class="kc">true</span><span class="o">,</span> <span class="kc">false</span><span class="o">,</span> <span class="nx">compat</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="c">// Element should be an html element or an array if we get here.</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(!</span><span class="nx">el</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="s2">"unable to attach event "</span> <span class="o">+</span> <span class="nx">type</span><span class="o">,</span> <span class="s2">"warn"</span><span class="o">,</span> <span class="s2">"event"</span><span class="o">);</span>
<span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
<span class="o">}</span>
<span class="c">// the custom event key is the uid for the element + type</span>
<span class="c"></span>
<span class="c">// allow a node reference to Y.on to work with load time addEventListener check</span>
<span class="c"></span> <span class="c">// (Node currently only has the addEventListener interface and that may be</span>
<span class="c"></span> <span class="c">// removed).</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">Node</span> <span class="o">&&</span> <span class="nx">el</span> <span class="k">instanceof</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Node</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span> <span class="nx">el</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">el</span><span class="o">,</span> <span class="nx">args</span><span class="o">);</span>
<span class="o">}</span>
<span class="nx">cewrapper</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_createWrapper</span><span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="nx">type</span><span class="o">,</span> <span class="nx">capture</span><span class="o">,</span> <span class="nx">compat</span><span class="o">,</span> <span class="nx">facade</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">el</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">win</span> <span class="o">&&</span> <span class="nx">type</span> <span class="o">==</span> <span class="s2">"load"</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// if the load is complete, fire immediately.</span>
<span class="c"></span> <span class="c">// all subscribers, including the current one</span>
<span class="c"></span> <span class="c">// will be notified.</span>
<span class="c"></span> <span class="k">if</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">windowLoaded</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">fireNow</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="c">// switched from obj to trimmedArgs[2] to deal with appened compat param</span>
<span class="c"></span> <span class="c">// context = trimmedArgs[2] || ((compat) ? el : Y.get(el));</span>
<span class="c"></span> <span class="nx">context</span> <span class="o">=</span> <span class="nx">trimmedArgs</span><span class="o">[</span><span class="m">2</span><span class="o">];</span>
<span class="c">// set the context as the second arg to subscribe</span>
<span class="c"></span> <span class="nx">trimmedArgs</span><span class="o">[</span><span class="m">1</span><span class="o">]</span> <span class="o">=</span> <span class="nx">context</span><span class="o">;</span>
<span class="c">// remove the 'obj' param</span>
<span class="c"></span> <span class="nx">trimmedArgs</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">1</span><span class="o">);</span>
<span class="c">// set context to the Node if not specified</span>
<span class="c"></span> <span class="nx">ret</span> <span class="o">=</span> <span class="nx">cewrapper</span><span class="o">.</span><span class="nx">subscribe</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="nx">cewrapper</span><span class="o">,</span> <span class="nx">trimmedArgs</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">fireNow</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">cewrapper</span><span class="o">.</span><span class="nx">fire</span><span class="o">();</span>
<span class="o">}</span>
<span class="k">return</span> <span class="nx">ret</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Removes an event listener. Supports the signature the event was bound</span>
<span class="c"> * with, but the preferred way to remove listeners is using the handle</span>
<span class="c"> * that is returned when using Y.on</span>
<span class="c"> *</span>
<span class="c"> * @method detach</span>
<span class="c"> *</span>
<span class="c"> * @param {String|HTMLElement|Array|NodeList} el An id, an element </span>
<span class="c"> * reference, or a collection of ids and/or elements to remove</span>
<span class="c"> * the listener from.</span>
<span class="c"> * @param {String} type the type of event to remove.</span>
<span class="c"> * @param {Function} fn the method the event invokes. If fn is</span>
<span class="c"> * undefined, then all event handlers for the type of event are * removed.</span>
<span class="c"> * @return {boolean} true if the unbind was successful, false * otherwise.</span>
<span class="c"> * @static</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">el</span><span class="o">,</span> <span class="nx">obj</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">args</span><span class="o">=</span><span class="nx">Y</span><span class="o">.</span><span class="nb">Array</span><span class="o">(</span><span class="nx">arguments</span><span class="o">,</span> <span class="m">0</span><span class="o">,</span> <span class="kc">true</span><span class="o">),</span> <span class="nx">compat</span><span class="o">,</span> <span class="nx">i</span><span class="o">,</span> <span class="nx">len</span><span class="o">,</span> <span class="nx">ok</span><span class="o">,</span>
<span class="nx">id</span><span class="o">,</span> <span class="nx">ce</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">args</span><span class="o">[</span><span class="nx">args</span><span class="o">.</span><span class="nx">length</span><span class="o">-</span><span class="m">1</span><span class="o">]</span> <span class="o">===</span> <span class="nx">COMPAT_ARG</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">compat</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="c">// args.pop();</span>
<span class="c"></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="nx">type</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">type</span><span class="o">.</span><span class="nx">detach</span><span class="o">();</span>
<span class="o">}</span>
<span class="c">// The el argument can be a string</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="k">typeof</span> <span class="nx">el</span> <span class="o">==</span> <span class="s2">"string"</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// el = (compat) ? Y.DOM.byId(el) : Y.all(el);</span>
<span class="c"></span> <span class="nx">el</span> <span class="o">=</span> <span class="o">(</span><span class="nx">compat</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">DOM</span><span class="o">.</span><span class="nx">byId</span><span class="o">(</span><span class="nx">el</span><span class="o">)</span> <span class="o">:</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Selector</span><span class="o">.</span><span class="nx">query</span><span class="o">(</span><span class="nx">el</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="c">// The el argument can be an array of elements or element ids.</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">shouldIterate</span><span class="o">(</span><span class="nx">el</span><span class="o">))</span> <span class="o">{</span>
<span class="nx">ok</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span><span class="o">=</span><span class="m">0</span><span class="o">,</span> <span class="nx">len</span><span class="o">=</span><span class="nx">el</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">len</span><span class="o">;</span> <span class="o">++</span><span class="nx">i</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">el</span><span class="o">[</span><span class="nx">i</span><span class="o">];</span>
<span class="nx">ok</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">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="nx">ok</span> <span class="o">);</span>
<span class="o">}</span>
<span class="k">return</span> <span class="nx">ok</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">fn</span> <span class="o">||</span> <span class="o">!</span><span class="nx">fn</span><span class="o">.</span><span class="nx">call</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">purgeElement</span><span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="kc">false</span><span class="o">,</span> <span class="nx">type</span><span class="o">);</span>
<span class="o">}</span>
<span class="nx">id</span> <span class="o">=</span> <span class="s1">'event:'</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">el</span><span class="o">)</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">_wrappers</span><span class="o">[</span><span class="nx">id</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="k">return</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="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Finds the event in the window object, the caller's arguments, or</span>
<span class="c"> * in the arguments of another method in the callstack. This is</span>
<span class="c"> * executed automatically for events registered through the event</span>
<span class="c"> * manager, so the implementer should not normally need to execute</span>
<span class="c"> * this function at all.</span>
<span class="c"> * @method getEvent</span>
<span class="c"> * @param {Event} e the event parameter from the handler</span>
<span class="c"> * @param {HTMLElement} el the element the listener was attached to</span>
<span class="c"> * @return {Event} the event </span>
<span class="c"> * @static</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">e</span><span class="o">,</span> <span class="nx">el</span><span class="o">,</span> <span class="nx">noFacade</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">ev</span> <span class="o">=</span> <span class="nx">e</span> <span class="o">||</span> <span class="nb">window</span><span class="o">.</span><span class="nx">event</span><span class="o">;</span>
<span class="k">return</span> <span class="o">(</span><span class="nx">noFacade</span><span class="o">)</span> <span class="o">?</span> <span class="nx">ev</span> <span class="o">:</span>
<span class="k">new</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">DOMEventFacade</span><span class="o">(</span><span class="nx">ev</span><span class="o">,</span> <span class="nx">el</span><span class="o">,</span> <span class="nx">_wrappers</span><span class="o">[</span><span class="s1">'event:'</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">el</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="c">/**</span>
<span class="c"> * Generates an unique ID for the element if it does not already </span>
<span class="c"> * have one.</span>
<span class="c"> * @method generateId</span>
<span class="c"> * @param el the element to create the id for</span>
<span class="c"> * @return {string} the resulting id of the element</span>
<span class="c"> * @static</span>
<span class="c"> */</span>
<span class="nx">generateId</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">el</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">id</span> <span class="o">=</span> <span class="nx">el</span><span class="o">.</span><span class="nx">id</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">id</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">stamp</span><span class="o">(</span><span class="nx">el</span><span class="o">);</span>
<span class="nx">el</span><span class="o">.</span><span class="nx">id</span> <span class="o">=</span> <span class="nx">id</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">return</span> <span class="nx">id</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * We want to be able to use getElementsByTagName as a collection</span>
<span class="c"> * to attach a group of events to. Unfortunately, different </span>
<span class="c"> * browsers return different types of collections. This function</span>
<span class="c"> * tests to determine if the object is array-like. It will also </span>
<span class="c"> * fail if the object is an array, but is empty.</span>
<span class="c"> * @method _isValidCollection</span>
<span class="c"> * @param o the object to test</span>
<span class="c"> * @return {boolean} true if the object is array-like and populated</span>
<span class="c"> * @deprecated was not meant to be used directly</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_isValidCollection</span><span class="o">:</span> <span class="nx">shouldIterate</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * hook up any deferred listeners</span>
<span class="c"> * @method _load</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_load</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">e</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">_loadComplete</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// Y.log('Load Complete', 'info', 'event');</span>
<span class="c"></span>
<span class="nx">_loadComplete</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="c">// Just in case DOMReady did not go off for some reason</span>
<span class="c"></span> <span class="c">// E._ready();</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">fire</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">EVENT_READY</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">// Available elements may not have been detected before the</span>
<span class="c"></span> <span class="c">// window load event fires. Try to find them now so that the</span>
<span class="c"></span> <span class="c">// the user is more likely to get the onAvailable notifications</span>
<span class="c"></span> <span class="c">// before the window load notification</span>
<span class="c"></span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Event</span><span class="o">.</span><span class="nx">_poll</span><span class="o">();</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Polling function that runs before the onload event fires, </span>
<span class="c"> * attempting to attach to DOM Nodes as soon as they are </span>
<span class="c"> * available</span>
<span class="c"> * @method _poll</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_poll</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">locked</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">UA</span><span class="o">.</span><span class="nx">ie</span> <span class="o">&&</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">DOMReady</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// Hold off if DOMReady has not fired and check current</span>
<span class="c"></span> <span class="c">// readyState to protect against the IE operation aborted</span>
<span class="c"></span> <span class="c">// issue.</span>
<span class="c"></span> <span class="k">this</span><span class="o">.</span><span class="nx">startInterval</span><span class="o">();</span>
<span class="k">return</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">this</span><span class="o">.</span><span class="nx">locked</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="c">// Y.log.debug("poll");</span>
<span class="c"></span>
<span class="c">// keep trying until after the page is loaded. We need to </span>
<span class="c"></span> <span class="c">// check the page load state prior to trying to bind the </span>
<span class="c"></span> <span class="c">// elements so that we can be certain all elements have been </span>
<span class="c"></span> <span class="c">// tested appropriately</span>
<span class="c"></span> <span class="k">var</span> <span class="nx">tryAgain</span> <span class="o">=</span> <span class="o">!</span><span class="nx">_loadComplete</span><span class="o">,</span> <span class="nx">notAvail</span><span class="o">,</span> <span class="nx">executeItem</span><span class="o">,</span>
<span class="nx">i</span><span class="o">,</span> <span class="nx">len</span><span class="o">,</span> <span class="nx">item</span><span class="o">,</span> <span class="nx">el</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">tryAgain</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">tryAgain</span> <span class="o">=</span> <span class="o">(</span><span class="nx">_retryCount</span> <span class="o">></span> <span class="m">0</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">// onAvailable</span>
<span class="c"></span> <span class="nx">notAvail</span> <span class="o">=</span> <span class="o">[];</span>
<span class="nx">executeItem</span> <span class="o">=</span> <span class="k">function</span> <span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="nx">item</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">context</span><span class="o">,</span> <span class="nx">ov</span> <span class="o">=</span> <span class="nx">item</span><span class="o">.</span><span class="nx">override</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">item</span><span class="o">.</span><span class="nx">compat</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">item</span><span class="o">.</span><span class="nx">override</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">ov</span> <span class="o">===</span> <span class="kc">true</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">context</span> <span class="o">=</span> <span class="nx">item</span><span class="o">.</span><span class="nx">obj</span><span class="o">;</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">context</span> <span class="o">=</span> <span class="nx">ov</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">context</span> <span class="o">=</span> <span class="nx">el</span><span class="o">;</span>
<span class="o">}</span>
<span class="nx">item</span><span class="o">.</span><span class="nx">fn</span><span class="o">.</span><span class="nx">call</span><span class="o">(</span><span class="nx">context</span><span class="o">,</span> <span class="nx">item</span><span class="o">.</span><span class="nx">obj</span><span class="o">);</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">context</span> <span class="o">=</span> <span class="nx">item</span><span class="o">.</span><span class="nx">obj</span> <span class="o">||</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">el</span><span class="o">);</span>
<span class="nx">item</span><span class="o">.</span><span class="nx">fn</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="nx">context</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">isArray</span><span class="o">(</span><span class="nx">ov</span><span class="o">))</span> <span class="o">?</span> <span class="nx">ov</span> <span class="o">:</span> <span class="o">[]);</span>
<span class="o">}</span>
<span class="o">};</span>
<span class="c">// onAvailable</span>
<span class="c"></span> <span class="k">for</span> <span class="o">(</span><span class="nx">i</span><span class="o">=</span><span class="m">0</span><span class="o">,</span><span class="nx">len</span><span class="o">=</span><span class="nx">_avail</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">len</span><span class="o">;</span> <span class="o">++</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">item</span> <span class="o">=</span> <span class="nx">_avail</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">item</span> <span class="o">&&</span> <span class="o">!</span><span class="nx">item</span><span class="o">.</span><span class="nx">checkReady</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// el = (item.compat) ? Y.DOM.byId(item.id) : Y.get(item.id);</span>
<span class="c"></span> <span class="nx">el</span> <span class="o">=</span> <span class="o">(</span><span class="nx">item</span><span class="o">.</span><span class="nx">compat</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">DOM</span><span class="o">.</span><span class="nx">byId</span><span class="o">(</span><span class="nx">item</span><span class="o">.</span><span class="nx">id</span><span class="o">)</span> <span class="o">:</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Selector</span><span class="o">.</span><span class="nx">query</span><span class="o">(</span><span class="nx">item</span><span class="o">.</span><span class="nx">id</span><span class="o">,</span> <span class="kc">null</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">el</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// Y.log('avail: ' + el);</span>
<span class="c"></span> <span class="nx">executeItem</span><span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="nx">item</span><span class="o">);</span>
<span class="nx">_avail</span><span class="o">[</span><span class="nx">i</span><span class="o">]</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="c">// Y.log('NOT avail: ' + el);</span>
<span class="c"></span> <span class="nx">notAvail</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">item</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="c">// onContentReady</span>
<span class="c"></span> <span class="k">for</span> <span class="o">(</span><span class="nx">i</span><span class="o">=</span><span class="m">0</span><span class="o">,</span><span class="nx">len</span><span class="o">=</span><span class="nx">_avail</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">len</span><span class="o">;</span> <span class="o">++</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">item</span> <span class="o">=</span> <span class="nx">_avail</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">item</span> <span class="o">&&</span> <span class="nx">item</span><span class="o">.</span><span class="nx">checkReady</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// el = (item.compat) ? Y.DOM.byId(item.id) : Y.get(item.id);</span>
<span class="c"></span> <span class="nx">el</span> <span class="o">=</span> <span class="o">(</span><span class="nx">item</span><span class="o">.</span><span class="nx">compat</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">DOM</span><span class="o">.</span><span class="nx">byId</span><span class="o">(</span><span class="nx">item</span><span class="o">.</span><span class="nx">id</span><span class="o">)</span> <span class="o">:</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Selector</span><span class="o">.</span><span class="nx">query</span><span class="o">(</span><span class="nx">item</span><span class="o">.</span><span class="nx">id</span><span class="o">,</span> <span class="kc">null</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">el</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// The element is available, but not necessarily ready</span>
<span class="c"></span> <span class="c">// @todo should we test parentNode.nextSibling?</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">_loadComplete</span> <span class="o">||</span> <span class="o">(</span><span class="nx">el</span><span class="o">.</span><span class="nx">get</span> <span class="o">&&</span> <span class="nx">el</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'nextSibling'</span><span class="o">))</span> <span class="o">||</span> <span class="nx">el</span><span class="o">.</span><span class="nx">nextSibling</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">executeItem</span><span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="nx">item</span><span class="o">);</span>
<span class="nx">_avail</span><span class="o">[</span><span class="nx">i</span><span class="o">]</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">notAvail</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">item</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="nx">_retryCount</span> <span class="o">=</span> <span class="o">(</span><span class="nx">notAvail</span><span class="o">.</span><span class="nx">length</span> <span class="o">===</span> <span class="m">0</span><span class="o">)</span> <span class="o">?</span> <span class="m">0</span> <span class="o">:</span> <span class="nx">_retryCount</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">tryAgain</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// we may need to strip the nulled out items here</span>
<span class="c"></span> <span class="k">this</span><span class="o">.</span><span class="nx">startInterval</span><span class="o">();</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">clearInterval</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">_interval</span><span class="o">);</span>
<span class="k">this</span><span class="o">.</span><span class="nx">_interval</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">this</span><span class="o">.</span><span class="nx">locked</span> <span class="o">=</span> <span class="kc">false</span><span class="o">;</span>
<span class="k">return</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Removes all listeners attached to the given element via addListener.</span>
<span class="c"> * Optionally, the node's children can also be purged.</span>
<span class="c"> * Optionally, you can specify a specific type of event to remove.</span>
<span class="c"> * @method purgeElement</span>
<span class="c"> * @param {HTMLElement} el the element to purge</span>
<span class="c"> * @param {boolean} recurse recursively purge this element's children</span>
<span class="c"> * as well. Use with caution.</span>
<span class="c"> * @param {string} type optional type of listener to purge. If</span>
<span class="c"> * left out, all listeners will be removed</span>
<span class="c"> * @static</span>
<span class="c"> */</span>
<span class="nx">purgeElement</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="nx">recurse</span><span class="o">,</span> <span class="nx">type</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// var oEl = (Y.Lang.isString(el)) ? Y.get(el) : el,</span>
<span class="c"></span> <span class="k">var</span> <span class="nx">oEl</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">isString</span><span class="o">(</span><span class="nx">el</span><span class="o">))</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Selector</span><span class="o">.</span><span class="nx">query</span><span class="o">(</span><span class="nx">el</span><span class="o">,</span> <span class="kc">null</span><span class="o">,</span> <span class="kc">true</span><span class="o">)</span> <span class="o">:</span> <span class="nx">el</span><span class="o">,</span>
<span class="nx">lis</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">getListeners</span><span class="o">(</span><span class="nx">oEl</span><span class="o">,</span> <span class="nx">type</span><span class="o">),</span> <span class="nx">i</span><span class="o">,</span> <span class="nx">len</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">lis</span><span class="o">)</span> <span class="o">{</span>
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span><span class="o">=</span><span class="m">0</span><span class="o">,</span><span class="nx">len</span><span class="o">=</span><span class="nx">lis</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">len</span> <span class="o">;</span> <span class="o">++</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">lis</span><span class="o">[</span><span class="nx">i</span><span class="o">].</span><span class="nx">detachAll</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">recurse</span> <span class="o">&&</span> <span class="nx">oEl</span> <span class="o">&&</span> <span class="nx">oEl</span><span class="o">.</span><span class="nx">childNodes</span><span class="o">)</span> <span class="o">{</span>
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span><span class="o">=</span><span class="m">0</span><span class="o">,</span><span class="nx">len</span><span class="o">=</span><span class="nx">oEl</span><span class="o">.</span><span class="nx">childNodes</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">len</span> <span class="o">;</span> <span class="o">++</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span class="nx">purgeElement</span><span class="o">(</span><span class="nx">oEl</span><span class="o">.</span><span class="nx">childNodes</span><span class="o">[</span><span class="nx">i</span><span class="o">],</span> <span class="nx">recurse</span><span class="o">,</span> <span class="nx">type</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Returns all listeners attached to the given element via addListener.</span>
<span class="c"> * Optionally, you can specify a specific type of event to return.</span>
<span class="c"> * @method getListeners</span>
<span class="c"> * @param el {HTMLElement|string} the element or element id to inspect </span>
<span class="c"> * @param type {string} optional type of listener to return. If</span>
<span class="c"> * left out, all listeners will be returned</span>
<span class="c"> * @return {Y.Custom.Event} the custom event wrapper for the DOM event(s)</span>
<span class="c"> * @static</span>
<span class="c"> */</span>
<span class="nx">getListeners</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">el</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">ek</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">el</span><span class="o">,</span> <span class="kc">true</span><span class="o">),</span> <span class="nx">evts</span> <span class="o">=</span> <span class="nx">_el_events</span><span class="o">[</span><span class="nx">ek</span><span class="o">],</span>
<span class="nx">results</span><span class="o">=[]</span> <span class="o">,</span> <span class="nx">key</span> <span class="o">=</span> <span class="o">(</span><span class="nx">type</span><span class="o">)</span> <span class="o">?</span> <span class="s1">'event:'</span> <span class="o">+</span> <span class="nx">ek</span> <span class="o">+</span> <span class="nx">type</span> <span class="o">:</span> <span class="kc">null</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="o">{</span>
<span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">key</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">key</span><span class="o">])</span> <span class="o">{</span>
<span class="nx">results</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">evts</span><span class="o">[</span><span class="nx">key</span><span class="o">]);</span>
<span class="o">}</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">evts</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">results</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">v</span><span class="o">);</span>
<span class="o">});</span>
<span class="o">}</span>
<span class="k">return</span> <span class="o">(</span><span class="nx">results</span><span class="o">.</span><span class="nx">length</span><span class="o">)</span> <span class="o">?</span> <span class="nx">results</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"> * Removes all listeners registered by pe.event. Called </span>
<span class="c"> * automatically during the unload event.</span>
<span class="c"> * @method _unload</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">_unload</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">e</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">E</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">Y</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">_wrappers</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">v</span><span class="o">.</span><span class="nx">detachAll</span><span class="o">();</span>
<span class="nx">remove</span><span class="o">(</span><span class="nx">v</span><span class="o">.</span><span class="nx">el</span><span class="o">,</span> <span class="nx">v</span><span class="o">.</span><span class="nx">type</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="nx">delete</span> <span class="nx">_wrappers</span><span class="o">[</span><span class="nx">k</span><span class="o">];</span>
<span class="o">});</span>
<span class="nx">remove</span><span class="o">(</span><span class="nb">window</span><span class="o">,</span> <span class="s2">"load"</span><span class="o">,</span> <span class="nx">E</span><span class="o">.</span><span class="nx">_load</span><span class="o">);</span>
<span class="nx">remove</span><span class="o">(</span><span class="nb">window</span><span class="o">,</span> <span class="s2">"unload"</span><span class="o">,</span> <span class="nx">E</span><span class="o">.</span><span class="nx">_unload</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Adds a DOM event directly without the caching, cleanup, context adj, etc</span>
<span class="c"> *</span>
<span class="c"> * @method nativeAdd</span>
<span class="c"> * @param {HTMLElement} el the element to bind the handler to</span>
<span class="c"> * @param {string} type the type of event handler</span>
<span class="c"> * @param {function} fn the callback to invoke</span>
<span class="c"> * @param {boolen} capture capture or bubble phase</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">nativeAdd</span><span class="o">:</span> <span class="nx">add</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * Basic remove listener</span>
<span class="c"> *</span>
<span class="c"> * @method nativeRemove</span>
<span class="c"> * @param {HTMLElement} el the element to bind the handler to</span>
<span class="c"> * @param {string} type the type of event handler</span>
<span class="c"> * @param {function} fn the callback to invoke</span>
<span class="c"> * @param {boolen} capture capture or bubble phase</span>
<span class="c"> * @static</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="nx">nativeRemove</span><span class="o">:</span> <span class="nx">remove</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">Event</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">config</span><span class="o">.</span><span class="nx">injected</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">windowLoaded</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">onLoad</span><span class="o">();</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">add</span><span class="o">(</span><span class="nb">window</span><span class="o">,</span> <span class="s2">"load"</span><span class="o">,</span> <span class="nx">onLoad</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">// Process onAvailable/onContentReady items when when the DOM is ready in IE</span>
<span class="c"></span><span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">UA</span><span class="o">.</span><span class="nx">ie</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">on</span><span class="o">(</span><span class="nx">EVENT_READY</span><span class="o">,</span> <span class="nx">Event</span><span class="o">.</span><span class="nx">_poll</span><span class="o">,</span> <span class="nx">Event</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span>
<span class="o">}</span>
<span class="nx">add</span><span class="o">(</span><span class="nb">window</span><span class="o">,</span> <span class="s2">"unload"</span><span class="o">,</span> <span class="nx">onUnload</span><span class="o">);</span>
<span class="nx">Event</span><span class="o">.</span><span class="nx">Custom</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">CustomEvent</span><span class="o">;</span>
<span class="nx">Event</span><span class="o">.</span><span class="nx">Subscriber</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Subscriber</span><span class="o">;</span>
<span class="nx">Event</span><span class="o">.</span><span class="nx">Target</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">Event</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">EventHandle</span><span class="o">;</span>
<span class="nx">Event</span><span class="o">.</span><span class="nx">Facade</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">EventFacade</span><span class="o">;</span>
<span class="nx">Event</span><span class="o">.</span><span class="nx">_poll</span><span class="o">();</span>
<span class="o">})();</span>
</pre></div>
</div>
</div>
</div>
<div class="yui-b">
<div class="nav">
<div id="moduleList" class="module">
<h4>Modules</h4>
<ul class="content">
<li class=""><a href="module_anim.html" title="anim">anim</a></li>
<li class=""><a href="module_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="selected"><a href="module_event.html" title="event">event</a></li>
<li class=""><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.html" title="queue">queue</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="DOMEventFacade.html" title="DOMEventFacade">DOMEventFacade</a></li>
<li class=""><a href="Event.html" title="Event">Event</a></li>
</ul>
</div>
<div id="fileList" class="module">
<h4>Files</h4>
<ul class="content">
<li class=""><a href="available.js.html" title="available.js">available.js</a></li>
<li class=""><a href="delegate.js.html" title="delegate.js">delegate.js</a></li>
<li class="selected"><a href="event-dom.js.html" title="event-dom.js">event-dom.js</a></li>
<li class=""><a href="event-facade-dom.js.html" title="event-facade-dom.js">event-facade-dom.js</a></li>
<li class=""><a href="event-ready-base.js.html" title="event-ready-base.js">event-ready-base.js</a></li>
<li class=""><a href="event-ready.js.html" title="event-ready.js">event-ready.js</a></li>
<li class=""><a href="focusblur.js.html" title="focusblur.js">focusblur.js</a></li>
<li class=""><a href="key.js.html" title="key.js">key.js</a></li>
<li class=""><a href="mouseentermouseleave.js.html" title="mouseentermouseleave.js">mouseentermouseleave.js</a></li>
<li class=""><a href="resize-window.js.html" title="resize-window.js">resize-window.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": "Event", "name": "attach", "url": "Event.html#method_attach", "type": "method"}, {"access": "private", "host": "Event", "name": "_avail", "url": "Event.html#property__avail", "type": "property"}, {"access": "", "host": "DOMEventFacade", "name": "button", "url": "DOMEventFacade.html#property_button", "type": "property"}, {"access": "", "host": "DOMEventFacade", "name": "charCode", "url": "DOMEventFacade.html#property_charCode", "type": "property"}, {"access": "", "host": "DOMEventFacade", "name": "currentTarget", "url": "DOMEventFacade.html#property_currentTarget", "type": "property"}, {"access": "", "host": "Event", "name": "detach", "url": "Event.html#method_detach", "type": "method"}, {"access": "", "host": "Event", "name": "DOMReady", "url": "Event.html#property_DOMReady", "type": "property"}, {"access": "private", "host": "Event", "name": "_dri", "url": "Event.html#property__dri", "type": "property"}, {"access": "private", "host": "Event", "name": "_el_events", "url": "Event.html#property__el_events", "type": "property"}, {"access": "", "host": "Event", "name": "generateId", "url": "Event.html#method_generateId", "type": "method"}, {"access": "", "host": "Event", "name": "getEvent", "url": "Event.html#method_getEvent", "type": "method"}, {"access": "", "host": "Event", "name": "getListeners", "url": "Event.html#method_getListeners", "type": "method"}, {"access": "", "host": "DOMEventFacade", "name": "halt", "url": "DOMEventFacade.html#method_halt", "type": "method"}, {"access": "private", "host": "Event", "name": "_interval", "url": "Event.html#property__interval", "type": "property"}, {"access": "private", "host": "Event", "name": "_isValidCollection", "url": "Event.html#method__isValidCollection", "type": "method"}, {"access": "", "host": "DOMEventFacade", "name": "keyCode", "url": "DOMEventFacade.html#property_keyCode", "type": "property"}, {"access": "", "host": "Event", "name": "lastError", "url": "Event.html#property_lastError", "type": "property"}, {"access": "private", "host": "Event", "name": "_load", "url": "Event.html#method__load", "type": "method"}, {"access": "private", "host": "Event", "name": "_loadComplete", "url": "Event.html#property__loadComplete", "type": "property"}, {"access": "private", "host": "Event", "name": "nativeAdd", "url": "Event.html#method_nativeAdd", "type": "method"}, {"access": "private", "host": "Event", "name": "nativeRemove", "url": "Event.html#method_nativeRemove", "type": "method"}, {"access": "", "host": "Event", "name": "onAvailable", "url": "Event.html#method_onAvailable", "type": "method"}, {"access": "", "host": "Event", "name": "onContentReady", "url": "Event.html#method_onContentReady", "type": "method"}, {"access": "", "host": "DOMEventFacade", "name": "pageX", "url": "DOMEventFacade.html#property_pageX", "type": "property"}, {"access": "", "host": "DOMEventFacade", "name": "pageY", "url": "DOMEventFacade.html#property_pageY", "type": "property"}, {"access": "private", "host": "Event", "name": "_poll", "url": "Event.html#method__poll", "type": "method"}, {"access": "", "host": "Event", "name": "POLL_INTERVAL", "url": "Event.html#property_POLL_INTERVAL", "type": "property"}, {"access": "", "host": "Event", "name": "POLL_RETRYS", "url": "Event.html#property_POLL_RETRYS", "type": "property"}, {"access": "", "host": "DOMEventFacade", "name": "preventDefault", "url": "DOMEventFacade.html#method_preventDefault", "type": "method"}, {"access": "", "host": "Event", "name": "purgeElement", "url": "Event.html#method_purgeElement", "type": "method"}, {"access": "", "host": "DOMEventFacade", "name": "relatedTarget", "url": "DOMEventFacade.html#property_relatedTarget", "type": "property"}, {"access": "private", "host": "DOMEventFacade", "name": "resolve", "url": "DOMEventFacade.html#method_resolve", "type": "method"}, {"access": "private", "host": "Event", "name": "_retryCount", "url": "Event.html#property__retryCount", "type": "property"}, {"access": "private", "host": "Event", "name": "startInterval", "url": "Event.html#method_startInterval", "type": "method"}, {"access": "", "host": "DOMEventFacade", "name": "stopImmediatePropagation", "url": "DOMEventFacade.html#method_stopImmediatePropagation", "type": "method"}, {"access": "", "host": "DOMEventFacade", "name": "stopPropagation", "url": "DOMEventFacade.html#method_stopPropagation", "type": "method"}, {"access": "", "host": "DOMEventFacade", "name": "target", "url": "DOMEventFacade.html#property_target", "type": "property"}, {"access": "private", "host": "Event", "name": "_unload", "url": "Event.html#method__unload", "type": "method"}, {"access": "private", "host": "DOMEventFacade", "name": "webkitKeymap", "url": "DOMEventFacade.html#property_webkitKeymap", "type": "property"}, {"access": "", "host": "DOMEventFacade", "name": "which", "url": "DOMEventFacade.html#property_which", "type": "property"}, {"access": "private", "host": "Event", "name": "_wrappers", "url": "Event.html#property__wrappers", "type": "property"}];
</script>
</body>
</html>