summaryrefslogtreecommitdiff
path: root/lib/dojo/hash.js
diff options
context:
space:
mode:
Diffstat (limited to 'lib/dojo/hash.js')
-rw-r--r--lib/dojo/hash.js243
1 files changed, 2 insertions, 241 deletions
diff --git a/lib/dojo/hash.js b/lib/dojo/hash.js
index e7f6a400f..b39080176 100644
--- a/lib/dojo/hash.js
+++ b/lib/dojo/hash.js
@@ -4,244 +4,5 @@
see: http://dojotoolkit.org/license for details
*/
-
-if(!dojo._hasResource["dojo.hash"]){ //_hasResource checks added by build. Do not use _hasResource directly in your code.
-dojo._hasResource["dojo.hash"] = true;
-dojo.provide("dojo.hash");
-
-
-//TODOC: where does this go?
-// summary:
-// Methods for monitoring and updating the hash in the browser URL.
-//
-// example:
-// dojo.subscribe("/dojo/hashchange", context, callback);
-//
-// function callback (hashValue){
-// // do something based on the hash value.
-// }
-
-(function(){
- dojo.hash = function(/* String? */ hash, /* Boolean? */ replace){
- // summary:
- // Gets or sets the hash string.
- // description:
- // Handles getting and setting of location.hash.
- // - If no arguments are passed, acts as a getter.
- // - If a string is passed, acts as a setter.
- // hash:
- // the hash is set - #string.
- // replace:
- // If true, updates the hash value in the current history
- // state instead of creating a new history state.
- // returns:
- // when used as a getter, returns the current hash string.
- // when used as a setter, returns the new hash string.
-
- // getter
- if(!arguments.length){
- return _getHash();
- }
- // setter
- if(hash.charAt(0) == "#"){
- hash = hash.substring(1);
- }
- if(replace){
- _replace(hash);
- }else{
- location.href = "#" + hash;
- }
- return hash; // String
- };
-
- // Global vars
- var _recentHash, _ieUriMonitor, _connect,
- _pollFrequency = dojo.config.hashPollFrequency || 100;
-
- //Internal functions
- function _getSegment(str, delimiter){
- var i = str.indexOf(delimiter);
- return (i >= 0) ? str.substring(i+1) : "";
- }
-
- function _getHash(){
- return _getSegment(location.href, "#");
- }
-
- function _dispatchEvent(){
- dojo.publish("/dojo/hashchange", [_getHash()]);
- }
-
- function _pollLocation(){
- if(_getHash() === _recentHash){
- return;
- }
- _recentHash = _getHash();
- _dispatchEvent();
- }
-
- function _replace(hash){
- if(_ieUriMonitor){
- if(_ieUriMonitor.isTransitioning()){
- setTimeout(dojo.hitch(null,_replace,hash), _pollFrequency);
- return;
- }
- var href = _ieUriMonitor.iframe.location.href;
- var index = href.indexOf('?');
- // main frame will detect and update itself
- _ieUriMonitor.iframe.location.replace(href.substring(0, index) + "?" + hash);
- return;
- }
- location.replace("#"+hash);
- !_connect && _pollLocation();
- }
-
- function IEUriMonitor(){
- // summary:
- // Determine if the browser's URI has changed or if the user has pressed the
- // back or forward button. If so, call _dispatchEvent.
- //
- // description:
- // IE doesn't add changes to the URI's hash into the history unless the hash
- // value corresponds to an actual named anchor in the document. To get around
- // this IE difference, we use a background IFrame to maintain a back-forward
- // history, by updating the IFrame's query string to correspond to the
- // value of the main browser location's hash value.
- //
- // E.g. if the value of the browser window's location changes to
- //
- // #action=someAction
- //
- // ... then we'd update the IFrame's source to:
- //
- // ?action=someAction
- //
- // This design leads to a somewhat complex state machine, which is
- // described below:
- //
- // s1: Stable state - neither the window's location has changed nor
- // has the IFrame's location. Note that this is the 99.9% case, so
- // we optimize for it.
- // Transitions: s1, s2, s3
- // s2: Window's location changed - when a user clicks a hyperlink or
- // code programmatically changes the window's URI.
- // Transitions: s4
- // s3: Iframe's location changed as a result of user pressing back or
- // forward - when the user presses back or forward, the location of
- // the background's iframe changes to the previous or next value in
- // its history.
- // Transitions: s1
- // s4: IEUriMonitor has programmatically changed the location of the
- // background iframe, but it's location hasn't yet changed. In this
- // case we do nothing because we need to wait for the iframe's
- // location to reflect its actual state.
- // Transitions: s4, s5
- // s5: IEUriMonitor has programmatically changed the location of the
- // background iframe, and the iframe's location has caught up with
- // reality. In this case we need to transition to s1.
- // Transitions: s1
- //
- // The hashchange event is always dispatched on the transition back to s1.
- //
-
- // create and append iframe
- var ifr = document.createElement("iframe"),
- IFRAME_ID = "dojo-hash-iframe",
- ifrSrc = dojo.config.dojoBlankHtmlUrl || dojo.moduleUrl("dojo", "resources/blank.html");
-
- if(dojo.config.useXDomain && !dojo.config.dojoBlankHtmlUrl){
- console.warn("dojo.hash: When using cross-domain Dojo builds,"
- + " please save dojo/resources/blank.html to your domain and set djConfig.dojoBlankHtmlUrl"
- + " to the path on your domain to blank.html");
- }
-
- ifr.id = IFRAME_ID;
- ifr.src = ifrSrc + "?" + _getHash();
- ifr.style.display = "none";
- document.body.appendChild(ifr);
-
- this.iframe = dojo.global[IFRAME_ID];
- var recentIframeQuery, transitioning, expectedIFrameQuery, docTitle, ifrOffline,
- iframeLoc = this.iframe.location;
-
- function resetState(){
- _recentHash = _getHash();
- recentIframeQuery = ifrOffline ? _recentHash : _getSegment(iframeLoc.href, "?");
- transitioning = false;
- expectedIFrameQuery = null;
- }
-
- this.isTransitioning = function(){
- return transitioning;
- };
-
- this.pollLocation = function(){
- if(!ifrOffline) {
- try{
- //see if we can access the iframe's location without a permission denied error
- var iframeSearch = _getSegment(iframeLoc.href, "?");
- //good, the iframe is same origin (no thrown exception)
- if(document.title != docTitle){ //sync title of main window with title of iframe.
- docTitle = this.iframe.document.title = document.title;
- }
- }catch(e){
- //permission denied - server cannot be reached.
- ifrOffline = true;
- console.error("dojo.hash: Error adding history entry. Server unreachable.");
- }
- }
- var hash = _getHash();
- if(transitioning && _recentHash === hash){
- // we're in an iframe transition (s4 or s5)
- if(ifrOffline || iframeSearch === expectedIFrameQuery){
- // s5 (iframe caught up to main window or iframe offline), transition back to s1
- resetState();
- _dispatchEvent();
- }else{
- // s4 (waiting for iframe to catch up to main window)
- setTimeout(dojo.hitch(this,this.pollLocation),0);
- return;
- }
- }else if(_recentHash === hash && (ifrOffline || recentIframeQuery === iframeSearch)){
- // we're in stable state (s1, iframe query == main window hash), do nothing
- }else{
- // the user has initiated a URL change somehow.
- // sync iframe query <-> main window hash
- if(_recentHash !== hash){
- // s2 (main window location changed), set iframe url and transition to s4
- _recentHash = hash;
- transitioning = true;
- expectedIFrameQuery = hash;
- ifr.src = ifrSrc + "?" + expectedIFrameQuery;
- ifrOffline = false; //we're updating the iframe src - set offline to false so we can check again on next poll.
- setTimeout(dojo.hitch(this,this.pollLocation),0); //yielded transition to s4 while iframe reloads.
- return;
- }else if(!ifrOffline){
- // s3 (iframe location changed via back/forward button), set main window url and transition to s1.
- location.href = "#" + iframeLoc.search.substring(1);
- resetState();
- _dispatchEvent();
- }
- }
- setTimeout(dojo.hitch(this,this.pollLocation), _pollFrequency);
- };
- resetState(); // initialize state (transition to s1)
- setTimeout(dojo.hitch(this,this.pollLocation), _pollFrequency);
- }
- dojo.addOnLoad(function(){
- if("onhashchange" in dojo.global && (!dojo.isIE || (dojo.isIE >= 8 && document.compatMode != "BackCompat"))){ //need this IE browser test because "onhashchange" exists in IE8 in IE7 mode
- _connect = dojo.connect(dojo.global,"onhashchange",_dispatchEvent);
- }else{
- if(document.addEventListener){ // Non-IE
- _recentHash = _getHash();
- setInterval(_pollLocation, _pollFrequency); //Poll the window location for changes
- }else if(document.attachEvent){ // IE7-
- //Use hidden iframe in versions of IE that don't have onhashchange event
- _ieUriMonitor = new IEUriMonitor();
- }
- // else non-supported browser, do nothing.
- }
- });
-})();
-
-}
+//>>built
+define("dojo/hash",["./_base/kernel","require","./_base/connect","./_base/lang","./ready","./_base/sniff"],function(_1,_2,_3,_4,_5,_6){_1.hash=function(_7,_8){if(!arguments.length){return _9();}if(_7.charAt(0)=="#"){_7=_7.substring(1);}if(_8){_a(_7);}else{location.href="#"+_7;}return _7;};var _b,_c,_d,_e=_1.config.hashPollFrequency||100;function _f(str,_10){var i=str.indexOf(_10);return (i>=0)?str.substring(i+1):"";};function _9(){return _f(location.href,"#");};function _11(){_3.publish("/dojo/hashchange",[_9()]);};function _12(){if(_9()===_b){return;}_b=_9();_11();};function _a(_13){if(_c){if(_c.isTransitioning()){setTimeout(_4.hitch(null,_a,_13),_e);return;}var _14=_c.iframe.location.href;var _15=_14.indexOf("?");_c.iframe.location.replace(_14.substring(0,_15)+"?"+_13);return;}location.replace("#"+_13);!_d&&_12();};function _16(){var ifr=document.createElement("iframe"),_17="dojo-hash-iframe",_18=_1.config.dojoBlankHtmlUrl||_2.toUrl("./resources/blank.html");if(_1.config.useXDomain&&!_1.config.dojoBlankHtmlUrl){console.warn("dojo.hash: When using cross-domain Dojo builds,"+" please save dojo/resources/blank.html to your domain and set djConfig.dojoBlankHtmlUrl"+" to the path on your domain to blank.html");}ifr.id=_17;ifr.src=_18+"?"+_9();ifr.style.display="none";document.body.appendChild(ifr);this.iframe=_1.global[_17];var _19,_1a,_1b,_1c,_1d,_1e=this.iframe.location;function _1f(){_b=_9();_19=_1d?_b:_f(_1e.href,"?");_1a=false;_1b=null;};this.isTransitioning=function(){return _1a;};this.pollLocation=function(){if(!_1d){try{var _20=_f(_1e.href,"?");if(document.title!=_1c){_1c=this.iframe.document.title=document.title;}}catch(e){_1d=true;console.error("dojo.hash: Error adding history entry. Server unreachable.");}}var _21=_9();if(_1a&&_b===_21){if(_1d||_20===_1b){_1f();_11();}else{setTimeout(_4.hitch(this,this.pollLocation),0);return;}}else{if(_b===_21&&(_1d||_19===_20)){}else{if(_b!==_21){_b=_21;_1a=true;_1b=_21;ifr.src=_18+"?"+_1b;_1d=false;setTimeout(_4.hitch(this,this.pollLocation),0);return;}else{if(!_1d){location.href="#"+_1e.search.substring(1);_1f();_11();}}}}setTimeout(_4.hitch(this,this.pollLocation),_e);};_1f();setTimeout(_4.hitch(this,this.pollLocation),_e);};_5(function(){if("onhashchange" in _1.global&&(!_6("ie")||(_6("ie")>=8&&document.compatMode!="BackCompat"))){_d=_3.connect(_1.global,"onhashchange",_11);}else{if(document.addEventListener){_b=_9();setInterval(_12,_e);}else{if(document.attachEvent){_c=new _16();}}}});return _1.hash;}); \ No newline at end of file
generated by cgit v1.2.3 (git 2.25.1) at 2024-06-03 01:25:08 +0000