<!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: history history.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>history <span class="subtitle">3.0.0b1</span></h3>
<a href="./index.html" title="Yahoo! UI Library">Yahoo! UI Library</a>
> <a href="./module_history.html" title="history">history</a>
> history.js (source view)
<form onsubmit="return false">
<div id="propertysearch">
Search: <input autocomplete="off" id="searchinput" />
<div id="searchresults">
</div>
</div>
</form>
</div>
<div id="bd">
<div id="yui-main">
<div class="yui-b">
<form action="#" name="yui-classopts-form" method="get" id="yui-classopts-form">
<fieldset>
<legend>Filters</legend>
<span class="classopts"><input type="checkbox" name="show_private" id="show_private" /> <label for="show_private">Show Private</label></span>
<span class="classopts"><input type="checkbox" name="show_protected" id="show_protected" /> <label for="show_protected">Show Protected</label></span>
<span class="classopts"><input type="checkbox" name="show_deprecated" id="show_deprecated" /> <label for="show_deprecated">Show Deprecated</label></span>
</fieldset>
</form>
<div id="srcout">
<style>
#doc3 .classopts { display:none; }
</style>
<div class="highlight" ><pre><span class="c">/*global YUI*/</span>
<span class="c">/**</span>
<span class="c"> * The Browser History Utility provides the ability to use the back/forward</span>
<span class="c"> * navigation buttons in a DHTML application. It also allows a DHTML</span>
<span class="c"> * application to be bookmarked in a specific state.</span>
<span class="c"> *</span>
<span class="c"> * This utility requires the following static markup:</span>
<span class="c"> *</span>
<span class="c"> * &lt;iframe id="yui-history-iframe" src="path-to-real-asset-in-same-domain"&gt;&lt;/iframe&gt;</span>
<span class="c"> * &lt;input id="yui-history-field" type="hidden"&gt;</span>
<span class="c"> *</span>
<span class="c"> * @module history</span>
<span class="c"> */</span>
<span class="c">/**</span>
<span class="c"> * This class represents an instance of the browser history utility.</span>
<span class="c"> * @class History</span>
<span class="c"> * @constructor</span>
<span class="c"> */</span>
<span class="c">// SHortcuts...</span>
<span class="c"></span> <span class="k">var</span> <span class="nx">L</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Lang</span><span class="o">,</span>
<span class="nx">A</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">ET</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">Target</span><span class="o">,</span>
<span class="nx">C</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">WH</span> <span class="o">=</span> <span class="nx">C</span><span class="o">.</span><span class="nx">win</span><span class="o">.</span><span class="nx">history</span><span class="o">,</span>
<span class="nx">WL</span> <span class="o">=</span> <span class="nx">C</span><span class="o">.</span><span class="nx">win</span><span class="o">.</span><span class="nx">location</span><span class="o">,</span>
<span class="nx">DM</span> <span class="o">=</span> <span class="nx">C</span><span class="o">.</span><span class="nx">doc</span><span class="o">.</span><span class="nx">documentMode</span><span class="o">,</span>
<span class="nx">encode</span> <span class="o">=</span> <span class="nb">encodeURIComponent</span><span class="o">,</span>
<span class="nx">decode</span> <span class="o">=</span> <span class="nb">decodeURIComponent</span><span class="o">,</span>
<span class="nx">H</span><span class="o">,</span> <span class="nx">G</span><span class="o">,</span>
<span class="c">// YUI Compressor helper...</span>
<span class="c"></span> <span class="nx">E_MISSING_OR_INVALID_ARG</span> <span class="o">=</span> <span class="s2">"Missing or invalid argument"</span><span class="o">,</span>
<span class="c">// Regular expression used to parse query strings and such.</span>
<span class="c"></span> <span class="nx">REGEXP</span> <span class="o">=</span> <span class="sr">/([^=&]+)=([^&]*)/g</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * @event history:ready</span>
<span class="c"> * @description Fires when the browser history utility is ready</span>
<span class="c"> * @type Event.Custom</span>
<span class="c"> */</span>
<span class="nx">EV_HISTORY_READY</span> <span class="o">=</span> <span class="s2">"history:ready"</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * @event history:globalStateChange</span>
<span class="c"> * @description Fires when the global state of the page has changed (that is,</span>
<span class="c"> * when the state of at least one browser history module has changed)</span>
<span class="c"> * @type Event.Custom</span>
<span class="c"> */</span>
<span class="nx">EV_HISTORY_GLOBAL_STATE_CHANGE</span> <span class="o">=</span> <span class="s2">"history:globalStateChange"</span><span class="o">,</span>
<span class="c">/**</span>
<span class="c"> * @event history:moduleStateChange</span>
<span class="c"> * @description Fires when the state of a history module object has changed</span>
<span class="c"> * @type Event.Custom</span>
<span class="c"> */</span>
<span class="nx">EV_HISTORY_MODULE_STATE_CHANGE</span> <span class="o">=</span> <span class="s2">"history:moduleStateChange"</span><span class="o">;</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">history</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">history</span> <span class="o">=</span> <span class="nx">G</span> <span class="o">=</span> <span class="o">{</span>
<span class="c">// Flag used to tell whether the history utility is ready to be used.</span>
<span class="c"></span> <span class="nx">ready</span><span class="o">:</span> <span class="kc">false</span><span class="o">,</span>
<span class="c">// List of registered modules.</span>
<span class="c"></span> <span class="nx">_modules</span><span class="o">:</span> <span class="o">[],</span>
<span class="c">// List of fully qualified states. This is used only by Safari.</span>
<span class="c"></span> <span class="nx">_fqstates</span><span class="o">:</span> <span class="o">[],</span>
<span class="c">// INPUT field (with type="hidden" or type="text") or TEXTAREA.</span>
<span class="c"></span> <span class="c">// This field keeps the value of the initial state, current state</span>
<span class="c"></span> <span class="c">// the list of all states across pages within a single browser session.</span>
<span class="c"></span> <span class="nx">_stateField</span><span class="o">:</span> <span class="kc">null</span><span class="o">,</span>
<span class="c">// Hidden IFrame used to store the browsing history on IE6/7.</span>
<span class="c"></span> <span class="nx">_historyIFrame</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"> * Returns the portion of the hash after the '#' symbol.</span>
<span class="c"> * @method _getHash</span>
<span class="c"> * @return {string} The hash portion of the document's location</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="k">function</span> <span class="nx">_getHash</span><span class="o">()</span> <span class="o">{</span>
<span class="k">return</span> <span class="nx">WL</span><span class="o">.</span><span class="nx">hash</span><span class="o">.</span><span class="nx">substr</span><span class="o">(</span><span class="m">1</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">/**</span>
<span class="c"> * Stores the initial state and current state for all registered modules.</span>
<span class="c"> * On Safari, we also store all the fully qualified states visited by</span>
<span class="c"> * the application within a single browser session. The storage takes</span>
<span class="c"> * place in the form field specified during initialization.</span>
<span class="c"> * @method _storeStates</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="k">function</span> <span class="nx">_storeStates</span><span class="o">()</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">initialStates</span> <span class="o">=</span> <span class="o">[],</span> <span class="nx">currentStates</span> <span class="o">=</span> <span class="o">[],</span> <span class="nx">s</span><span class="o">;</span>
<span class="nx">Y</span><span class="o">.</span><span class="nb">Object</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">,</span> <span class="k">function</span> <span class="o">(</span><span class="nx">module</span><span class="o">,</span> <span class="nx">moduleId</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">initialStates</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">moduleId</span> <span class="o">+</span> <span class="s2">"="</span> <span class="o">+</span> <span class="nx">module</span><span class="o">.</span><span class="nx">initialState</span><span class="o">);</span>
<span class="nx">currentStates</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">moduleId</span> <span class="o">+</span> <span class="s2">"="</span> <span class="o">+</span> <span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span><span class="o">);</span>
<span class="o">});</span>
<span class="nx">s</span> <span class="o">=</span> <span class="nx">initialStates</span><span class="o">.</span><span class="nx">join</span><span class="o">(</span><span class="s2">"&"</span><span class="o">)</span> <span class="o">+</span> <span class="s2">"|"</span> <span class="o">+</span> <span class="nx">currentStates</span><span class="o">.</span><span class="nx">join</span><span class="o">(</span><span class="s2">"&"</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">A</span><span class="o">.</span><span class="nx">webkit</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">s</span> <span class="o">+=</span> <span class="s2">"|"</span> <span class="o">+</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_fqstates</span><span class="o">.</span><span class="nx">join</span><span class="o">(</span><span class="s2">","</span><span class="o">);</span>
<span class="o">}</span>
<span class="nx">G</span><span class="o">.</span><span class="nx">_stateField</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="s2">"value"</span><span class="o">,</span> <span class="nx">s</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">/**</span>
<span class="c"> * Sets the new currentState attribute of all modules depending on the new fully</span>
<span class="c"> * qualified state. Also notifies the modules which current state has changed.</span>
<span class="c"> * @method _handleFQStateChange</span>
<span class="c"> * @param {string} fqstate fully qualified state</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="k">function</span> <span class="nx">_handleFQStateChange</span><span class="o">(</span><span class="nx">fqstate</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">m</span><span class="o">,</span> <span class="nx">modules</span><span class="o">,</span> <span class="nx">globalStateChanged</span> <span class="o">=</span> <span class="kc">false</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">fqstate</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nb">Object</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">,</span> <span class="k">function</span> <span class="o">(</span><span class="nx">module</span><span class="o">,</span> <span class="nx">moduleId</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span> <span class="o">!==</span> <span class="nx">module</span><span class="o">.</span><span class="nx">initialState</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span> <span class="o">=</span> <span class="nx">module</span><span class="o">.</span><span class="nx">initialState</span><span class="o">;</span>
<span class="nx">module</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">EV_HISTORY_MODULE_STATE_CHANGE</span><span class="o">,</span> <span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span><span class="o">);</span>
<span class="nx">globalStateChanged</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">});</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">globalStateChanged</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">H</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">EV_HISTORY_GLOBAL_STATE_CHANGE</span><span class="o">);</span>
<span class="o">}</span>
<span class="k">return</span><span class="o">;</span>
<span class="o">}</span>
<span class="nx">modules</span> <span class="o">=</span> <span class="o">[];</span>
<span class="nx">REGEXP</span><span class="o">.</span><span class="nx">lastIndex</span> <span class="o">=</span> <span class="m">0</span><span class="o">;</span>
<span class="k">while</span> <span class="o">((</span><span class="nx">m</span> <span class="o">=</span> <span class="nx">REGEXP</span><span class="o">.</span><span class="nx">exec</span><span class="o">(</span><span class="nx">fqstate</span><span class="o">)))</span> <span class="o">{</span>
<span class="nx">modules</span><span class="o">[</span><span class="nx">m</span><span class="o">[</span><span class="m">1</span><span class="o">]]</span> <span class="o">=</span> <span class="nx">m</span><span class="o">[</span><span class="m">2</span><span class="o">];</span>
<span class="o">}</span>
<span class="nx">Y</span><span class="o">.</span><span class="nb">Object</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">,</span> <span class="k">function</span> <span class="o">(</span><span class="nx">module</span><span class="o">,</span> <span class="nx">moduleId</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">currentState</span> <span class="o">=</span> <span class="nx">modules</span><span class="o">[</span><span class="nx">moduleId</span><span class="o">];</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">currentState</span> <span class="o">||</span> <span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span> <span class="o">!==</span> <span class="nx">currentState</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span> <span class="o">=</span> <span class="nx">currentState</span> <span class="o">||</span> <span class="nx">module</span><span class="o">.</span><span class="nx">initialState</span><span class="o">;</span>
<span class="nx">module</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">EV_HISTORY_MODULE_STATE_CHANGE</span><span class="o">,</span> <span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span><span class="o">);</span>
<span class="nx">globalStateChanged</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">});</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">globalStateChanged</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">H</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">EV_HISTORY_GLOBAL_STATE_CHANGE</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="c">/**</span>
<span class="c"> * Update the IFrame with our new state.</span>
<span class="c"> * @method _updateIFrame</span>
<span class="c"> * @private</span>
<span class="c"> * @return {boolean} true if successful. false otherwise.</span>
<span class="c"> */</span>
<span class="k">function</span> <span class="nx">_updateIFrame</span><span class="o">(</span><span class="nx">fqstate</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">html</span><span class="o">,</span> <span class="nx">doc</span><span class="o">;</span>
<span class="nx">html</span> <span class="o">=</span> <span class="s1">'<html><body>'</span> <span class="o">+</span> <span class="nx">fqstate</span> <span class="o">+</span> <span class="s1">'</body></html>'</span><span class="o">;</span>
<span class="k">try</span> <span class="o">{</span>
<span class="nx">doc</span> <span class="o">=</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_historyIFrame</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s2">"contentWindow.document"</span><span class="o">);</span>
<span class="c">// TODO: The Node API should expose these methods in the very near future...</span>
<span class="c"></span> <span class="nx">doc</span><span class="o">.</span><span class="nx">invoke</span><span class="o">(</span><span class="s1">'open'</span><span class="o">);</span>
<span class="nx">doc</span><span class="o">.</span><span class="nx">invoke</span><span class="o">(</span><span class="s1">'write'</span><span class="o">,</span> <span class="nx">html</span><span class="o">,</span> <span class="s1">''</span><span class="o">,</span> <span class="s1">''</span><span class="o">,</span> <span class="s1">''</span><span class="o">,</span> <span class="s1">''</span><span class="o">);</span> <span class="c">// see bug #2447937</span>
<span class="c"></span> <span class="nx">doc</span><span class="o">.</span><span class="nx">invoke</span><span class="o">(</span><span class="s1">'close'</span><span class="o">);</span>
<span class="k">return</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="nx">e</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s2">"Exception while storing a new browser history entry: "</span> <span class="o">+</span> <span class="nx">e</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"history"</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"> * Periodically checks whether our internal IFrame is ready to be used</span>
<span class="c"> * @method _checkIframeLoaded</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="k">function</span> <span class="nx">_checkIframeLoaded</span><span class="o">()</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">elem</span><span class="o">,</span> <span class="nx">fqstate</span><span class="o">,</span> <span class="nx">hash</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">G</span><span class="o">.</span><span class="nx">_historyIFrame</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s2">"contentWindow.document"</span><span class="o">))</span> <span class="o">{</span>
<span class="c">// Check again in 10 msec...</span>
<span class="c"></span> <span class="nx">setTimeout</span><span class="o">(</span><span class="nx">_checkIframeLoaded</span><span class="o">,</span> <span class="m">10</span><span class="o">);</span>
<span class="k">return</span><span class="o">;</span>
<span class="o">}</span>
<span class="c">// Start the thread that will have the responsibility to</span>
<span class="c"></span> <span class="c">// periodically check whether a navigate operation has been</span>
<span class="c"></span> <span class="c">// requested on the main window. This will happen when</span>
<span class="c"></span> <span class="c">// History.navigate has been called or after the user has</span>
<span class="c"></span> <span class="c">// hit the back/forward button.</span>
<span class="c"></span> <span class="nx">elem</span> <span class="o">=</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_historyIFrame</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'contentWindow.document.body'</span><span class="o">);</span>
<span class="c">// We must use innerText, and not innerHTML because our string contains</span>
<span class="c"></span> <span class="c">// the "&" character (which would end up being escaped as "&amp;") and</span>
<span class="c"></span> <span class="c">// the string comparison would fail...</span>
<span class="c"></span> <span class="nx">fqstate</span> <span class="o">=</span> <span class="nx">elem</span> <span class="o">?</span> <span class="nx">elem</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s2">"innerText"</span><span class="o">)</span> <span class="o">:</span> <span class="kc">null</span><span class="o">;</span>
<span class="nx">hash</span> <span class="o">=</span> <span class="nx">_getHash</span><span class="o">();</span>
<span class="nx">setInterval</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">newfqstate</span><span class="o">,</span> <span class="nx">states</span><span class="o">,</span> <span class="nx">newHash</span><span class="o">;</span>
<span class="nx">elem</span> <span class="o">=</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_historyIFrame</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'contentWindow.document.body'</span><span class="o">);</span>
<span class="c">// See my comment above about using innerText instead of innerHTML...</span>
<span class="c"></span> <span class="nx">newfqstate</span> <span class="o">=</span> <span class="nx">elem</span> <span class="o">?</span> <span class="nx">elem</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s2">"innerText"</span><span class="o">)</span> <span class="o">:</span> <span class="kc">null</span><span class="o">;</span>
<span class="nx">newHash</span> <span class="o">=</span> <span class="nx">_getHash</span><span class="o">();</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">newfqstate</span> <span class="o">!==</span> <span class="nx">fqstate</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">fqstate</span> <span class="o">=</span> <span class="nx">newfqstate</span><span class="o">;</span>
<span class="nx">_handleFQStateChange</span><span class="o">(</span><span class="nx">fqstate</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">fqstate</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">states</span> <span class="o">=</span> <span class="o">[];</span>
<span class="nx">Y</span><span class="o">.</span><span class="nb">Object</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">,</span> <span class="k">function</span> <span class="o">(</span><span class="nx">module</span><span class="o">,</span> <span class="nx">moduleId</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">states</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">moduleId</span> <span class="o">+</span> <span class="s2">"="</span> <span class="o">+</span> <span class="nx">module</span><span class="o">.</span><span class="nx">initialState</span><span class="o">);</span>
<span class="o">});</span>
<span class="nx">newHash</span> <span class="o">=</span> <span class="nx">states</span><span class="o">.</span><span class="nx">join</span><span class="o">(</span><span class="s2">"&"</span><span class="o">);</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">newHash</span> <span class="o">=</span> <span class="nx">fqstate</span><span class="o">;</span>
<span class="o">}</span>
<span class="c">// Allow the state to be bookmarked by setting the top window's</span>
<span class="c"></span> <span class="c">// URL fragment identifier. Note that here, we are on IE < 8</span>
<span class="c"></span> <span class="c">// which does not touch the browser history when changing the</span>
<span class="c"></span> <span class="c">// hash (unlike all the other browsers).</span>
<span class="c"></span> <span class="nx">WL</span><span class="o">.</span><span class="nx">hash</span> <span class="o">=</span> <span class="nx">hash</span> <span class="o">=</span> <span class="nx">newHash</span><span class="o">;</span>
<span class="nx">_storeStates</span><span class="o">();</span>
<span class="o">}</span> <span class="k">else</span> <span class="k">if</span> <span class="o">(</span><span class="nx">newHash</span> <span class="o">!==</span> <span class="nx">hash</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// The hash has changed. The user might have clicked on a link,</span>
<span class="c"></span> <span class="c">// or modified the URL directly, or opened the same application</span>
<span class="c"></span> <span class="c">// bookmarked in a specific state using a bookmark. However, we</span>
<span class="c"></span> <span class="c">// know the hash change was not caused by a hit on the back or</span>
<span class="c"></span> <span class="c">// forward buttons, or by a call to navigate() (because it would</span>
<span class="c"></span> <span class="c">// have been handled above) We must handle these cases, which is</span>
<span class="c"></span> <span class="c">// why we also need to keep track of hash changes on IE!</span>
<span class="c"></span>
<span class="c">// Note that IE6 has some major issues with this kind of user</span>
<span class="c"></span> <span class="c">// interaction (the history stack gets completely messed up)</span>
<span class="c"></span> <span class="c">// but it seems to work fine on IE7.</span>
<span class="c"></span>
<span class="nx">hash</span> <span class="o">=</span> <span class="nx">newHash</span><span class="o">;</span>
<span class="c">// Now, store a new history entry. The following will cause the</span>
<span class="c"></span> <span class="c">// code above to execute, doing all the dirty work for us...</span>
<span class="c"></span> <span class="nx">_updateIFrame</span><span class="o">(</span><span class="nx">newHash</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">},</span> <span class="m">50</span><span class="o">);</span>
<span class="nx">G</span><span class="o">.</span><span class="nx">ready</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="nx">H</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">EV_HISTORY_READY</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">/**</span>
<span class="c"> * Finish up the initialization of the browser utility library.</span>
<span class="c"> * @method _initialize</span>
<span class="c"> * @private</span>
<span class="c"> */</span>
<span class="k">function</span> <span class="nx">_initialize</span><span class="o">()</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">m</span><span class="o">,</span> <span class="nx">parts</span><span class="o">,</span> <span class="nx">moduleId</span><span class="o">,</span> <span class="nx">module</span><span class="o">,</span> <span class="nx">initialState</span><span class="o">,</span> <span class="nx">currentState</span><span class="o">,</span> <span class="nx">counter</span><span class="o">,</span> <span class="nx">hash</span><span class="o">;</span>
<span class="c">// Decode the content of our storage field...</span>
<span class="c"></span> <span class="nx">parts</span> <span class="o">=</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_stateField</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s2">"value"</span><span class="o">).</span><span class="nx">split</span><span class="o">(</span><span class="s2">"|"</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">parts</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">REGEXP</span><span class="o">.</span><span class="nx">lastIndex</span> <span class="o">=</span> <span class="m">0</span><span class="o">;</span>
<span class="k">while</span> <span class="o">((</span><span class="nx">m</span> <span class="o">=</span> <span class="nx">REGEXP</span><span class="o">.</span><span class="nx">exec</span><span class="o">(</span><span class="nx">parts</span><span class="o">[</span><span class="m">0</span><span class="o">])))</span> <span class="o">{</span>
<span class="nx">moduleId</span> <span class="o">=</span> <span class="nx">m</span><span class="o">[</span><span class="m">1</span><span class="o">];</span>
<span class="nx">initialState</span> <span class="o">=</span> <span class="nx">m</span><span class="o">[</span><span class="m">2</span><span class="o">];</span>
<span class="nx">module</span> <span class="o">=</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">[</span><span class="nx">moduleId</span><span class="o">];</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">module</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">module</span><span class="o">.</span><span class="nx">initialState</span> <span class="o">=</span> <span class="nx">initialState</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="nx">REGEXP</span><span class="o">.</span><span class="nx">lastIndex</span> <span class="o">=</span> <span class="m">0</span><span class="o">;</span>
<span class="k">while</span> <span class="o">((</span><span class="nx">m</span> <span class="o">=</span> <span class="nx">REGEXP</span><span class="o">.</span><span class="nx">exec</span><span class="o">(</span><span class="nx">parts</span><span class="o">[</span><span class="m">1</span><span class="o">])))</span> <span class="o">{</span>
<span class="nx">moduleId</span> <span class="o">=</span> <span class="nx">m</span><span class="o">[</span><span class="m">1</span><span class="o">];</span>
<span class="nx">currentState</span> <span class="o">=</span> <span class="nx">m</span><span class="o">[</span><span class="m">2</span><span class="o">];</span>
<span class="nx">module</span> <span class="o">=</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">[</span><span class="nx">moduleId</span><span class="o">];</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">module</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span> <span class="o">=</span> <span class="nx">currentState</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">parts</span><span class="o">.</span><span class="nx">length</span> <span class="o">></span> <span class="m">2</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">G</span><span class="o">.</span><span class="nx">_fqstates</span> <span class="o">=</span> <span class="nx">parts</span><span class="o">[</span><span class="m">2</span><span class="o">].</span><span class="nx">split</span><span class="o">(</span><span class="s2">","</span><span class="o">);</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">A</span><span class="o">.</span><span class="nx">ie</span><span class="o">)</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isUndefined</span><span class="o">(</span><span class="nx">DM</span><span class="o">)</span> <span class="o">||</span> <span class="nx">DM</span> <span class="o"><</span> <span class="m">8</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// IE < 8 or IE8 in quirks mode or IE7 standards mode</span>
<span class="c"></span> <span class="nx">_checkIframeLoaded</span><span class="o">();</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="c">// IE8 in IE8 standards mode</span>
<span class="c"></span> <span class="nx">Y</span><span class="o">.</span><span class="nx">on</span><span class="o">(</span><span class="s2">"hashchange"</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">hash</span> <span class="o">=</span> <span class="nx">_getHash</span><span class="o">();</span>
<span class="nx">_handleFQStateChange</span><span class="o">(</span><span class="nx">hash</span><span class="o">);</span>
<span class="nx">_storeStates</span><span class="o">();</span>
<span class="o">},</span> <span class="nb">window</span><span class="o">);</span>
<span class="nx">G</span><span class="o">.</span><span class="nx">ready</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="nx">H</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">EV_HISTORY_READY</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="c">// Start the thread that will have the responsibility to</span>
<span class="c"></span> <span class="c">// periodically check whether a navigate operation has been</span>
<span class="c"></span> <span class="c">// requested on the main window. This will happen when</span>
<span class="c"></span> <span class="c">// YAHOO.util.History.navigate has been called or after</span>
<span class="c"></span> <span class="c">// the user has hit the back/forward button.</span>
<span class="c"></span>
<span class="c">// On Safari 1.x and 2.0, the only way to catch a back/forward</span>
<span class="c"></span> <span class="c">// operation is to watch history.length... We basically exploit</span>
<span class="c"></span> <span class="c">// what I consider to be a bug (history.length is not supposed</span>
<span class="c"></span> <span class="c">// to change when going back/forward in the history...) This is</span>
<span class="c"></span> <span class="c">// why, in the following thread, we first compare the hash,</span>
<span class="c"></span> <span class="c">// because the hash thing will be fixed in the next major</span>
<span class="c"></span> <span class="c">// version of Safari. So even if they fix the history.length</span>
<span class="c"></span> <span class="c">// bug, all this will still work!</span>
<span class="c"></span> <span class="nx">counter</span> <span class="o">=</span> <span class="nx">WH</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span>
<span class="c">// On Gecko and Opera, we just need to watch the hash...</span>
<span class="c"></span> <span class="nx">hash</span> <span class="o">=</span> <span class="nx">_getHash</span><span class="o">();</span>
<span class="nx">setInterval</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">state</span><span class="o">,</span> <span class="nx">newHash</span><span class="o">,</span> <span class="nx">newCounter</span><span class="o">;</span>
<span class="nx">newHash</span> <span class="o">=</span> <span class="nx">_getHash</span><span class="o">();</span>
<span class="nx">newCounter</span> <span class="o">=</span> <span class="nx">WH</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">newHash</span> <span class="o">!==</span> <span class="nx">hash</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">hash</span> <span class="o">=</span> <span class="nx">newHash</span><span class="o">;</span>
<span class="nx">counter</span> <span class="o">=</span> <span class="nx">newCounter</span><span class="o">;</span>
<span class="nx">_handleFQStateChange</span><span class="o">(</span><span class="nx">hash</span><span class="o">);</span>
<span class="nx">_storeStates</span><span class="o">();</span>
<span class="o">}</span> <span class="k">else</span> <span class="k">if</span> <span class="o">(</span><span class="nx">newCounter</span> <span class="o">!==</span> <span class="nx">counter</span> <span class="o">&&</span> <span class="nx">A</span><span class="o">.</span><span class="nx">webkit</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">hash</span> <span class="o">=</span> <span class="nx">newHash</span><span class="o">;</span>
<span class="nx">counter</span> <span class="o">=</span> <span class="nx">newCounter</span><span class="o">;</span>
<span class="nx">state</span> <span class="o">=</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_fqstates</span><span class="o">[</span><span class="nx">counter</span> <span class="o">-</span> <span class="m">1</span><span class="o">];</span>
<span class="nx">_handleFQStateChange</span><span class="o">(</span><span class="nx">state</span><span class="o">);</span>
<span class="nx">_storeStates</span><span class="o">();</span>
<span class="o">}</span>
<span class="o">},</span> <span class="m">50</span><span class="o">);</span>
<span class="nx">G</span><span class="o">.</span><span class="nx">ready</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="nx">H</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">EV_HISTORY_READY</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="nx">H</span> <span class="o">=</span> <span class="o">{</span>
<span class="c">/**</span>
<span class="c"> * Registers a new module.</span>
<span class="c"> * @method register</span>
<span class="c"> * @param {string} moduleId Non-empty string uniquely identifying the</span>
<span class="c"> * module you wish to register.</span>
<span class="c"> * @param {string} initialState The initial state of the specified</span>
<span class="c"> * module corresponding to its earliest history entry.</span>
<span class="c"> * @return {History.Module} The newly registered module</span>
<span class="c"> */</span>
<span class="nx">register</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">moduleId</span><span class="o">,</span> <span class="nx">initialState</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">module</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">moduleId</span><span class="o">)</span> <span class="o">||</span> <span class="nx">L</span><span class="o">.</span><span class="nx">trim</span><span class="o">(</span><span class="nx">moduleId</span><span class="o">)</span> <span class="o">===</span> <span class="s2">""</span> <span class="o">||</span> <span class="o">!</span><span class="nx">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">initialState</span><span class="o">))</span> <span class="o">{</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nb">Error</span><span class="o">(</span><span class="nx">E_MISSING_OR_INVALID_ARG</span><span class="o">);</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">[</span><span class="nx">moduleId</span><span class="o">])</span> <span class="o">{</span>
<span class="c">// The module seems to have already been registered.</span>
<span class="c"></span> <span class="k">return</span><span class="o">;</span>
<span class="o">}</span>
<span class="c">// Note: A module CANNOT be registered once the browser history</span>
<span class="c"></span> <span class="c">// utility has been initialized. We could relax this in the future,</span>
<span class="c"></span> <span class="c">// but that would mean that some states may be lost once the user</span>
<span class="c"></span> <span class="c">// leaves the page and then comes back to it.</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">G</span><span class="o">.</span><span class="nx">ready</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">"All modules must be registered before initializing the browser history utility"</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"history"</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="c">// Make sure the strings passed in do not contain our separators "," and "|"</span>
<span class="c"></span> <span class="nx">moduleId</span> <span class="o">=</span> <span class="nx">encode</span><span class="o">(</span><span class="nx">moduleId</span><span class="o">);</span>
<span class="nx">initialState</span> <span class="o">=</span> <span class="nx">encode</span><span class="o">(</span><span class="nx">initialState</span><span class="o">);</span>
<span class="nx">module</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">H</span><span class="o">.</span><span class="nx">Module</span><span class="o">(</span><span class="nx">moduleId</span><span class="o">,</span> <span class="nx">initialState</span><span class="o">);</span>
<span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">[</span><span class="nx">moduleId</span><span class="o">]</span> <span class="o">=</span> <span class="nx">module</span><span class="o">;</span>
<span class="k">return</span> <span class="nx">module</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Initializes the Browser History Manager. Call this method</span>
<span class="c"> * from a script block located right after the opening body tag.</span>
<span class="c"> * @method initialize</span>
<span class="c"> * @param {string|HTML Element} stateField <input type="hidden"> used</span>
<span class="c"> * to store application states. Must be in the static markup.</span>
<span class="c"> * @param {string|HTML Element} historyIFrame IFrame used to store</span>
<span class="c"> * the history (only required for IE6/7)</span>
<span class="c"> * @public</span>
<span class="c"> */</span>
<span class="nx">initialize</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">stateField</span><span class="o">,</span> <span class="nx">historyIFrame</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">tagName</span><span class="o">,</span> <span class="nx">type</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">G</span><span class="o">.</span><span class="nx">ready</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// The browser history utility has already been initialized.</span>
<span class="c"></span> <span class="k">return</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span>
<span class="nx">stateField</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">stateField</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">stateField</span><span class="o">)</span> <span class="o">{</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nb">Error</span><span class="o">(</span><span class="nx">E_MISSING_OR_INVALID_ARG</span><span class="o">);</span>
<span class="o">}</span>
<span class="nx">tagName</span> <span class="o">=</span> <span class="nx">stateField</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s2">"tagName"</span><span class="o">).</span><span class="nx">toUpperCase</span><span class="o">();</span>
<span class="nx">type</span> <span class="o">=</span> <span class="nx">stateField</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s2">"type"</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">tagName</span> <span class="o">!==</span> <span class="s2">"TEXTAREA"</span> <span class="o">&&</span> <span class="o">(</span><span class="nx">tagName</span> <span class="o">!==</span> <span class="s2">"INPUT"</span> <span class="o">||</span> <span class="nx">type</span> <span class="o">!==</span> <span class="s2">"hidden"</span> <span class="o">&&</span> <span class="nx">type</span> <span class="o">!==</span> <span class="s2">"text"</span><span class="o">))</span> <span class="o">{</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nb">Error</span><span class="o">(</span><span class="nx">E_MISSING_OR_INVALID_ARG</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">// IE < 8 or IE8 in quirks mode or IE7 standards mode</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">A</span><span class="o">.</span><span class="nx">ie</span> <span class="o">&&</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isUndefined</span><span class="o">(</span><span class="nx">DM</span><span class="o">)</span> <span class="o">||</span> <span class="nx">DM</span> <span class="o"><</span> <span class="m">8</span><span class="o">))</span> <span class="o">{</span>
<span class="nx">historyIFrame</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">historyIFrame</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">historyIFrame</span> <span class="o">||</span> <span class="nx">historyIFrame</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'tagName'</span><span class="o">).</span><span class="nx">toUpperCase</span><span class="o">()</span> <span class="o">!==</span> <span class="s2">"IFRAME"</span><span class="o">)</span> <span class="o">{</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nb">Error</span><span class="o">(</span><span class="nx">E_MISSING_OR_INVALID_ARG</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">A</span><span class="o">.</span><span class="nx">opera</span> <span class="o">&&</span> <span class="o">!</span><span class="nx">L</span><span class="o">.</span><span class="nx">isUndefined</span><span class="o">(</span><span class="nx">WH</span><span class="o">.</span><span class="nx">navigationMode</span><span class="o">))</span> <span class="o">{</span>
<span class="c">// Disable Opera's fast back/forward navigation mode and puts</span>
<span class="c"></span> <span class="c">// it in compatible mode. This makes anchor-based history</span>
<span class="c"></span> <span class="c">// navigation work after the page has been navigated away</span>
<span class="c"></span> <span class="c">// from and re-activated, at the cost of slowing down</span>
<span class="c"></span> <span class="c">// back/forward navigation to and from that page.</span>
<span class="c"></span> <span class="nx">WH</span><span class="o">.</span><span class="nx">navigationMode</span> <span class="o">=</span> <span class="s2">"compatible"</span><span class="o">;</span>
<span class="o">}</span>
<span class="nx">G</span><span class="o">.</span><span class="nx">_stateField</span> <span class="o">=</span> <span class="nx">stateField</span><span class="o">;</span>
<span class="nx">G</span><span class="o">.</span><span class="nx">_historyIFrame</span> <span class="o">=</span> <span class="nx">historyIFrame</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="s2">"domready"</span><span class="o">,</span> <span class="nx">_initialize</span><span class="o">);</span>
<span class="k">return</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Stores a new entry in the browser history by changing the state of a registered module.</span>
<span class="c"> * @method navigate</span>
<span class="c"> * @param {string} module Non-empty string representing your module.</span>
<span class="c"> * @param {string} state String representing the new state of the specified module.</span>
<span class="c"> * @return {boolean} Indicates whether the new state was successfully added to the history.</span>
<span class="c"> * @public</span>
<span class="c"> */</span>
<span class="nx">navigate</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">moduleId</span><span class="o">,</span> <span class="nx">state</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">states</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">moduleId</span><span class="o">)</span> <span class="o">||</span> <span class="o">!</span><span class="nx">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">state</span><span class="o">))</span> <span class="o">{</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nb">Error</span><span class="o">(</span><span class="nx">E_MISSING_OR_INVALID_ARG</span><span class="o">);</span>
<span class="o">}</span>
<span class="nx">states</span> <span class="o">=</span> <span class="o">{};</span>
<span class="nx">states</span><span class="o">[</span><span class="nx">moduleId</span><span class="o">]</span> <span class="o">=</span> <span class="nx">state</span><span class="o">;</span>
<span class="k">return</span> <span class="nx">H</span><span class="o">.</span><span class="nx">multiNavigate</span><span class="o">(</span><span class="nx">states</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Stores a new entry in the browser history by changing the state</span>
<span class="c"> * of several registered modules in one atomic operation.</span>
<span class="c"> * @method multiNavigate</span>
<span class="c"> * @param {object} states Associative array of module-state pairs to set simultaneously.</span>
<span class="c"> * @return {boolean} Indicates whether the new state was successfully added to the history.</span>
<span class="c"> * @public</span>
<span class="c"> */</span>
<span class="nx">multiNavigate</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">states</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">newStates</span> <span class="o">=</span> <span class="o">[],</span> <span class="nx">fqstate</span><span class="o">,</span> <span class="nx">globalStateChanged</span> <span class="o">=</span> <span class="kc">false</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">G</span><span class="o">.</span><span class="nx">ready</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">"The browser history utility has not been initialized"</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"history"</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="nx">Y</span><span class="o">.</span><span class="nb">Object</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">,</span> <span class="k">function</span> <span class="o">(</span><span class="nx">module</span><span class="o">,</span> <span class="nx">moduleId</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">state</span><span class="o">,</span> <span class="nx">decodedModuleId</span> <span class="o">=</span> <span class="nx">decode</span><span class="o">(</span><span class="nx">moduleId</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="nb">Object</span><span class="o">.</span><span class="nx">owns</span><span class="o">(</span><span class="nx">states</span><span class="o">,</span> <span class="nx">decodedModuleId</span><span class="o">))</span> <span class="o">{</span>
<span class="c">// The caller did not wish to modify the state of this</span>
<span class="c"></span> <span class="c">// module. We must however include it in fqstate!</span>
<span class="c"></span> <span class="nx">state</span> <span class="o">=</span> <span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span><span class="o">;</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="nx">state</span> <span class="o">=</span> <span class="nx">encode</span><span class="o">(</span><span class="nx">states</span><span class="o">[</span><span class="nx">decodedModuleId</span><span class="o">]);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">state</span> <span class="o">!==</span> <span class="nx">module</span><span class="o">.</span><span class="nx">upcomingState</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">module</span><span class="o">.</span><span class="nx">upcomingState</span> <span class="o">=</span> <span class="nx">state</span><span class="o">;</span>
<span class="nx">globalStateChanged</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="nx">newStates</span><span class="o">.</span><span class="nx">push</span><span class="o">(</span><span class="nx">moduleId</span> <span class="o">+</span> <span class="s2">"="</span> <span class="o">+</span> <span class="nx">state</span><span class="o">);</span>
<span class="o">});</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">globalStateChanged</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// Nothing changed, so don't do anything.</span>
<span class="c"></span> <span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
<span class="o">}</span>
<span class="nx">fqstate</span> <span class="o">=</span> <span class="nx">newStates</span><span class="o">.</span><span class="nx">join</span><span class="o">(</span><span class="s2">"&"</span><span class="o">);</span>
<span class="c">// IE < 8 or IE8 in quirks mode or IE7 standards mode</span>
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">A</span><span class="o">.</span><span class="nx">ie</span> <span class="o">&&</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isUndefined</span><span class="o">(</span><span class="nx">DM</span><span class="o">)</span> <span class="o">||</span> <span class="nx">DM</span> <span class="o"><</span> <span class="m">8</span><span class="o">))</span> <span class="o">{</span>
<span class="k">return</span> <span class="nx">_updateIFrame</span><span class="o">(</span><span class="nx">fqstate</span><span class="o">);</span>
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
<span class="c">// Known bug: On Safari 1.x and 2.0, if you have tab browsing</span>
<span class="c"></span> <span class="c">// enabled, Safari will show an endless loading icon in the</span>
<span class="c"></span> <span class="c">// tab. This has apparently been fixed in recent WebKit builds.</span>
<span class="c"></span> <span class="c">// One work around found by Dav Glass is to submit a form that</span>
<span class="c"></span> <span class="c">// points to the same document. This indeed works on Safari 1.x</span>
<span class="c"></span> <span class="c">// and 2.0 but creates bigger problems on WebKit. So for now,</span>
<span class="c"></span> <span class="c">// we'll consider this an acceptable bug, and hope that Apple</span>
<span class="c"></span> <span class="c">// comes out with their next version of Safari very soon.</span>
<span class="c"></span> <span class="nx">WL</span><span class="o">.</span><span class="nx">hash</span> <span class="o">=</span> <span class="nx">fqstate</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">A</span><span class="o">.</span><span class="nx">webkit</span><span class="o">)</span> <span class="o">{</span>
<span class="c">// The following two lines are only useful for Safari 1.x</span>
<span class="c"></span> <span class="c">// and 2.0. Recent nightly builds of WebKit do not require</span>
<span class="c"></span> <span class="c">// that, but unfortunately, it is not easy to differentiate</span>
<span class="c"></span> <span class="c">// between the two. Once Safari 2.0 departs the A-grade</span>
<span class="c"></span> <span class="c">// list, we can remove the following two lines...</span>
<span class="c"></span> <span class="nx">G</span><span class="o">.</span><span class="nx">_fqstates</span><span class="o">[</span><span class="nx">WH</span><span class="o">.</span><span class="nx">length</span><span class="o">]</span> <span class="o">=</span> <span class="nx">fqstate</span><span class="o">;</span>
<span class="nx">_storeStates</span><span class="o">();</span>
<span class="o">}</span>
<span class="k">return</span> <span class="kc">true</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Returns the current state of the specified module.</span>
<span class="c"> * @method getCurrentState</span>
<span class="c"> * @param {string} moduleId Non-empty string representing your module.</span>
<span class="c"> * @return {string} The current state of the specified module.</span>
<span class="c"> * @public</span>
<span class="c"> */</span>
<span class="nx">getCurrentState</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">moduleId</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">module</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">moduleId</span><span class="o">))</span> <span class="o">{</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nb">Error</span><span class="o">(</span><span class="nx">E_MISSING_OR_INVALID_ARG</span><span class="o">);</span>
<span class="o">}</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">G</span><span class="o">.</span><span class="nx">ready</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">"The browser history utility has not been initialized"</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"history"</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="nx">module</span> <span class="o">=</span> <span class="nx">G</span><span class="o">.</span><span class="nx">_modules</span><span class="o">[</span><span class="nx">moduleId</span><span class="o">];</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">module</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">"No such registered module: "</span> <span class="o">+</span> <span class="nx">moduleId</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"history"</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">return</span> <span class="nx">decode</span><span class="o">(</span><span class="nx">module</span><span class="o">.</span><span class="nx">currentState</span><span class="o">);</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Returns the state of a module according to the URL fragment</span>
<span class="c"> * identifier. This method is useful to initialize your modules</span>
<span class="c"> * if your application was bookmarked from a particular state.</span>
<span class="c"> * @method getBookmarkedState</span>
<span class="c"> * @param {string} moduleId Non-empty string representing your module.</span>
<span class="c"> * @return {string} The bookmarked state of the specified module.</span>
<span class="c"> * @public</span>
<span class="c"> */</span>
<span class="nx">getBookmarkedState</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">moduleId</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">m</span><span class="o">,</span> <span class="nx">i</span><span class="o">,</span> <span class="nx">h</span><span class="o">;</span>
<span class="k">if</span> <span class="o">(!</span><span class="nx">L</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">moduleId</span><span class="o">))</span> <span class="o">{</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nb">Error</span><span class="o">(</span><span class="nx">E_MISSING_OR_INVALID_ARG</span><span class="o">);</span>
<span class="o">}</span>
<span class="c">// Use location.href instead of location.hash which is already</span>
<span class="c"></span> <span class="c">// URL-decoded, which creates problems if the state value</span>
<span class="c"></span> <span class="c">// contained special characters...</span>
<span class="c"></span> <span class="nx">h</span> <span class="o">=</span> <span class="nx">WL</span><span class="o">.</span><span class="nx">href</span><span class="o">;</span>
<span class="nx">i</span> <span class="o">=</span> <span class="nx">h</span><span class="o">.</span><span class="nx">indexOf</span><span class="o">(</span><span class="s2">"#"</span><span class="o">);</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">i</span> <span class="o">>=</span> <span class="m">0</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">h</span> <span class="o">=</span> <span class="nx">h</span><span class="o">.</span><span class="nx">substr</span><span class="o">(</span><span class="nx">i</span> <span class="o">+</span> <span class="m">1</span><span class="o">);</span>
<span class="nx">REGEXP</span><span class="o">.</span><span class="nx">lastIndex</span> <span class="o">=</span> <span class="m">0</span><span class="o">;</span>
<span class="k">while</span> <span class="o">((</span><span class="nx">m</span> <span class="o">=</span> <span class="nx">REGEXP</span><span class="o">.</span><span class="nx">exec</span><span class="o">(</span><span class="nx">h</span><span class="o">)))</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">m</span><span class="o">[</span><span class="m">1</span><span class="o">]</span> <span class="o">===</span> <span class="nx">moduleId</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span> <span class="nx">decode</span><span class="o">(</span><span class="nx">m</span><span class="o">[</span><span class="m">2</span><span class="o">]);</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
<span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
<span class="o">},</span>
<span class="c">/**</span>
<span class="c"> * Returns the value of the specified query string parameter.</span>
<span class="c"> * This method is not used internally by the Browser History Manager.</span>
<span class="c"> * However, it is provided here as a helper since many applications</span>
<span class="c"> * using the Browser History Manager will want to read the value of</span>
<span class="c"> * url parameters to initialize themselves.</span>
<span class="c"> * @method getQueryStringParameter</span>
<span class="c"> * @param {string} paramName Name of the parameter we want to look up.</span>
<span class="c"> * @param {string} queryString Optional URL to look at. If not specified,</span>
<span class="c"> * this method uses the URL in the address bar.</span>
<span class="c"> * @return {string} The value of the specified parameter, or null.</span>
<span class="c"> * @public</span>
<span class="c"> */</span>
<span class="nx">getQueryStringParameter</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">paramName</span><span class="o">,</span> <span class="nx">url</span><span class="o">)</span> <span class="o">{</span>
<span class="k">var</span> <span class="nx">m</span><span class="o">,</span> <span class="nx">q</span><span class="o">,</span> <span class="nx">i</span><span class="o">;</span>
<span class="nx">url</span> <span class="o">=</span> <span class="nx">url</span> <span class="o">||</span> <span class="nx">WL</span><span class="o">.</span><span class="nx">href</span><span class="o">;</span>
<span class="nx">i</span> <span class="o">=</span> <span class="nx">url</span><span class="o">.</span><span class="nx">indexOf</span><span class="o">(</span><span class="s2">"?"</span><span class="o">);</span>
<span class="nx">q</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">url</span><span class="o">.</span><span class="nx">substr</span><span class="o">(</span><span class="nx">i</span> <span class="o">+</span> <span class="m">1</span><span class="o">)</span> <span class="o">:</span> <span class="nx">url</span><span class="o">;</span>
<span class="c">// Remove the hash if any</span>
<span class="c"></span> <span class="nx">i</span> <span class="o">=</span> <span class="nx">q</span><span class="o">.</span><span class="nx">lastIndexOf</span><span class="o">(</span><span class="s2">"#"</span><span class="o">);</span>
<span class="nx">q</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">q</span><span class="o">.</span><span class="nx">substr</span><span class="o">(</span><span class="m">0</span><span class="o">,</span> <span class="nx">i</span><span class="o">)</span> <span class="o">:</span> <span class="nx">q</span><span class="o">;</span>
<span class="nx">REGEXP</span><span class="o">.</span><span class="nx">lastIndex</span> <span class="o">=</span> <span class="m">0</span><span class="o">;</span>
<span class="k">while</span> <span class="o">((</span><span class="nx">m</span> <span class="o">=</span> <span class="nx">REGEXP</span><span class="o">.</span><span class="nx">exec</span><span class="o">(</span><span class="nx">q</span><span class="o">)))</span> <span class="o">{</span>
<span class="k">if</span> <span class="o">(</span><span class="nx">m</span><span class="o">[</span><span class="m">1</span><span class="o">]</span> <span class="o">===</span> <span class="nx">paramName</span><span class="o">)</span> <span class="o">{</span>
<span class="k">return</span> <span class="nx">decode</span><span class="o">(</span><span class="nx">m</span><span class="o">[</span><span class="m">2</span><span class="o">]);</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="o">};</span>
<span class="c">// Make Y.History an event target</span>
<span class="c"></span> <span class="nx">Y</span><span class="o">.</span><span class="nx">mix</span><span class="o">(</span><span class="nx">H</span><span class="o">,</span> <span class="nx">ET</span><span class="o">.</span><span class="nx">prototype</span><span class="o">);</span>
<span class="nx">ET</span><span class="o">.</span><span class="nx">call</span><span class="o">(</span><span class="nx">H</span><span class="o">);</span>
<span class="c">/**</span>
<span class="c"> * This class represents a browser history module.</span>
<span class="c"> * @class History.Module</span>
<span class="c"> * @constructor</span>
<span class="c"> * @param id {String} the module identifier</span>
<span class="c"> * @param initialState {String} the module's initial state</span>
<span class="c"> */</span>
<span class="nx">H</span><span class="o">.</span><span class="nx">Module</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">initialState</span><span class="o">)</span> <span class="o">{</span>
<span class="nx">ET</span><span class="o">.</span><span class="nx">call</span><span class="o">(</span><span class="k">this</span><span class="o">);</span>
<span class="c">/**</span>
<span class="c"> * The module identifier</span>
<span class="c"> * @type String</span>
<span class="c"> * @final</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">id</span> <span class="o">=</span> <span class="nx">id</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * The module's initial state</span>
<span class="c"> * @type String</span>
<span class="c"> * @final</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">initialState</span> <span class="o">=</span> <span class="nx">initialState</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * The module's current state</span>
<span class="c"> * @type String</span>
<span class="c"> * @final</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">currentState</span> <span class="o">=</span> <span class="nx">initialState</span><span class="o">;</span>
<span class="c">/**</span>
<span class="c"> * The module's upcoming state. There can be a slight delay between the</span>
<span class="c"> * time a state is changed, and the time a state change is detected.</span>
<span class="c"> * This property allows us to not fire the module state changed event</span>
<span class="c"> * multiple times, making client code simpler.</span>
<span class="c"> * @type String</span>
<span class="c"> * @private</span>
<span class="c"> * @final</span>
<span class="c"> */</span>
<span class="k">this</span><span class="o">.</span><span class="nx">upcomingState</span> <span class="o">=</span> <span class="nx">initialState</span><span class="o">;</span>
<span class="o">};</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">mix</span><span class="o">(</span><span class="nx">H</span><span class="o">.</span><span class="nx">Module</span><span class="o">,</span> <span class="nx">ET</span><span class="o">,</span> <span class="kc">false</span><span class="o">,</span> <span class="kc">null</span><span class="o">,</span> <span class="m">1</span><span class="o">);</span>
<span class="nx">Y</span><span class="o">.</span><span class="nx">History</span> <span class="o">=</span> <span class="nx">H</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=""><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="selected"><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="History.html" title="History">History</a></li>
<li class=""><a href="History.Module.html" title="History.Module">History.Module</a></li>
</ul>
</div>
<div id="fileList" class="module">
<h4>Files</h4>
<ul class="content">
<li class="selected"><a href="history.js.html" title="history.js">history.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": "private", "host": "History", "name": "_checkIframeLoaded", "url": "History.html#method__checkIframeLoaded", "type": "method"}, {"access": "", "host": "History.Module", "name": "currentState", "url": "History.Module.html#property_currentState", "type": "property"}, {"access": "", "host": "History", "name": "getBookmarkedState", "url": "History.html#method_getBookmarkedState", "type": "method"}, {"access": "", "host": "History", "name": "getCurrentState", "url": "History.html#method_getCurrentState", "type": "method"}, {"access": "private", "host": "History", "name": "_getHash", "url": "History.html#method__getHash", "type": "method"}, {"access": "", "host": "History", "name": "getQueryStringParameter", "url": "History.html#method_getQueryStringParameter", "type": "method"}, {"access": "private", "host": "History", "name": "_handleFQStateChange", "url": "History.html#method__handleFQStateChange", "type": "method"}, {"access": "", "host": "History", "name": "history:globalStateChange", "url": "History.html#event_history:globalStateChange", "type": "event"}, {"access": "", "host": "History", "name": "history:moduleStateChange", "url": "History.html#event_history:moduleStateChange", "type": "event"}, {"access": "", "host": "History", "name": "history:ready", "url": "History.html#event_history:ready", "type": "event"}, {"access": "", "host": "History.Module", "name": "id", "url": "History.Module.html#property_id", "type": "property"}, {"access": "private", "host": "History", "name": "_initialize", "url": "History.html#method__initialize", "type": "method"}, {"access": "", "host": "History", "name": "initialize", "url": "History.html#method_initialize", "type": "method"}, {"access": "", "host": "History.Module", "name": "initialState", "url": "History.Module.html#property_initialState", "type": "property"}, {"access": "", "host": "History", "name": "multiNavigate", "url": "History.html#method_multiNavigate", "type": "method"}, {"access": "", "host": "History", "name": "navigate", "url": "History.html#method_navigate", "type": "method"}, {"access": "", "host": "History", "name": "register", "url": "History.html#method_register", "type": "method"}, {"access": "private", "host": "History", "name": "_storeStates", "url": "History.html#method__storeStates", "type": "method"}, {"access": "private", "host": "History.Module", "name": "upcomingState", "url": "History.Module.html#property_upcomingState", "type": "property"}, {"access": "private", "host": "History", "name": "_updateIFrame", "url": "History.html#method__updateIFrame", "type": "method"}];
</script>
</body>
</html>