X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/25ef3491bd9ae007ff1fc2b0d7943e6eaaccf775..6e39d509471fe9b4e2660e0d1631b350d0c66f40:/docs/source/History.html diff --git a/docs/source/History.html b/docs/source/History.html index d1fcbd50..99630ecb 100644 --- a/docs/source/History.html +++ b/docs/source/History.html @@ -1,17 +1,12 @@ - - - The source code - - - - - 
/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
- * licensing@extjs.com
- * http://www.extjs.com/license
- */
-
/**
+
+
+      
+  The source code
+    
+    
+
+
+    
/**
  * @class Ext.History
  * @extends Ext.util.Observable
  * History management component that allows you to register arbitrary tokens that signify application
@@ -21,9 +16,10 @@
  * @singleton
  */
 Ext.History = (function () {
-    var iframe, hiddenField;
-    var ready = false;
-    var currentToken;
+    var iframe, hiddenField,
+        ready = false,
+        currentToken,
+        ignoreNext = false;
 
     function getHash() {
         var href = top.location.href, i = href.indexOf("#");
@@ -36,11 +32,14 @@ Ext.History = (function () {
 
     function handleStateChange(token) {
         currentToken = token;
-        Ext.History.fireEvent('change', token);
+        if(!(token == ignoreNext)){
+            Ext.History.fireEvent('change', token);
+        }
+        ignoreNext = false;
     }
 
     function updateIFrame (token) {
-        var html = ['
',token,'
'].join('');
+        var html = ['
',Ext.util.Format.htmlEncode(token),'
'].join('');
         try {
             var doc = iframe.contentWindow.document;
             doc.open();
@@ -58,20 +57,18 @@ Ext.History = (function () {
             return;
         }
 
-        var doc = iframe.contentWindow.document;
-        var elem = doc.getElementById("state");
-        var token = elem ? elem.innerText : null;
-
-        var hash = getHash();
+        var doc = iframe.contentWindow.document,
+            elem = doc.getElementById("state"),
+            token = elem ? elem.innerText : null,
+            hash = getHash();
 
         setInterval(function () {
 
             doc = iframe.contentWindow.document;
             elem = doc.getElementById("state");
 
-            var newtoken = elem ? elem.innerText : null;
-
-            var newHash = getHash();
+            var newtoken = elem ? elem.innerText : null,
+                newHash = getHash();
 
             if (newtoken !== token) {
                 token = newtoken;
@@ -124,14 +121,14 @@ Ext.History = (function () {
          * @property
          */
         iframeId: 'x-history-frame',
-        
+
         events:{},
 
         
/**
          * Initialize the global History instance.
          * @param {Boolean} onReady (optional) A callback function that will be called once the history
          * component is fully initialized.
-         * @param {Object} scope (optional) The callback scope
+         * @param {Object} scope (optional) The scope (this reference) in which the callback is executed. Defaults to the browser window.
          */
         init: function (onReady, scope) {
             if(ready) {
@@ -148,7 +145,20 @@ Ext.History = (function () {
             if (Ext.isIE) {
                 iframe = Ext.getDom(Ext.History.iframeId);
             }
-            this.addEvents('ready', 'change');
+            this.addEvents(
+                
/**
+                 * @event ready
+                 * Fires when the Ext.History singleton has been initialized and is ready for use.
+                 * @param {Ext.History} The Ext.History singleton.
+                 */
+                'ready',
+                
/**
+                 * @event change
+                 * Fires when navigation back or forwards within the local page's history occurs.
+                 * @param {String} token An identifier associated with the page state at that point in its history.
+                 */
+                'change'
+            );
             if(onReady){
                 this.on('ready', onReady, scope, {single:true});
             }
@@ -170,12 +180,15 @@ tabPanel.on('tabchange', function(tabPanel, tab){
          * it will not save a new history step. Set to false if the same state can be saved more than once
          * at the same history stack location (defaults to true).
          */
-        add: function (token, preventDup) {
+        add: function (token, preventDup, suppressEvent) {
             if(preventDup !== false){
                 if(this.getToken() == token){
                     return true;
                 }
             }
+            if(suppressEvent){
+                ignoreNext = token;
+            }
             if (Ext.isIE) {
                 return updateIFrame(token);
             } else {
@@ -207,6 +220,6 @@ tabPanel.on('tabchange', function(tabPanel, tab){
         }
     };
 })();
-Ext.apply(Ext.History, new Ext.util.Observable());

-
+Ext.apply(Ext.History, new Ext.util.Observable());
+ \ No newline at end of file