X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/c930e9176a5a85509c5b0230e2bff5c22a591432..10a866c12701c0a0afd0ac85dcdcf32a421514ac:/docs/source/History.html?ds=sidebyside
diff --git a/docs/source/History.html b/docs/source/History.html
index 8a42ef18..99630ecb 100644
--- a/docs/source/History.html
+++ b/docs/source/History.html
@@ -1,5 +1,6 @@
+
The source code
@@ -15,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("#");
@@ -30,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();
@@ -52,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;
@@ -118,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) {
@@ -142,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});
}
@@ -164,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 {