HTML5 history新特性pushState、replaceState

 

https://developer.mozilla.org/en/DOM/Manipulating_the_browser_history

DOM中的window物件通過window.history方法提供了對瀏覽器歷史記錄的讀取，讓你可以在使用者的訪問記錄中前進和後退。

從HTML5開始，我們可以開始操作這個歷史記錄堆疊。

 

1.History

使用back(),forward(),和go()方法可以在使用者的歷史記錄中前進和後退

前進和後退

後退：

window.history.back();

這個方法會像使用者點選了瀏覽器工具欄上的返回鍵一樣。

同樣的，也可以用以下方法產生使用者前進行為：

window.history.forward();

移動到歷史記錄中特定的位置

你可以使用go()方法從session歷史中載入特定的頁面。

向後移動一頁：

window.history.go(-1);

向前移動一頁：

window.history.go(1);

類似的，你可以前進或者後退多頁。

還可以通過檢查瀏覽器歷史記錄的length屬性來找到歷史記錄堆疊中的頁面總數。

var numberOfEntries = window.history.length;

注意:IE支援向go()方法傳URL引數。

 

2.新增和修改history實體

自Gecko2開始引入 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

HTML5引入了histtory.pushState()和history.replaceState()這兩個方法，他們允許新增和修改history實體。同時，這些方法會和window.onpostate事件一起工作。

使用history.pushState()方法來修改referrer,這種方法可以被用在經過修改狀態後而為xmlhttpRequest物件建立的http header中。這個referrer會是建立XMLHttpRequest 時document的URL。

pushState 用於向 history 新增當前頁面的記錄，而 replaceState 和 pushState 的用法完全一樣，唯一的區別就是它用於修改當前頁面在 history 中的記錄。

例子

假設http://mozilla.org/foo.html頁面執行了一下JS

var stateObj = { foo: "bar" }; history.pushState(stateObj, "page 2", "bar.html");

這種方法將會使url位址列顯示http://mozilla.org/bar.html，但瀏覽器不會載入bar.html頁面，即使這個頁面存在也不會載入。

現在再次假設使用者繼續訪問http://google.com，然後點選後退。這時，url位址列將會，http://mozilla.org/bar.html，頁面會得到popstate事件（chrome），這個狀態物件會包含一個stateObj的copy。這個頁面看起來像foo.html。+

這時，我們再次點選後退，URL將變成http://mozilla.org/foo.html，document將得到另一個popstate事件和為null的state物件。這次的返回動作並沒有改變文件的內容。（也許會過一會嘗試載入…chrome）

pushState方法

pushState()有三個引數:state物件，標題(現在是被忽略，未作處理)，URL(可選)。具體細節：

·        state物件 –state物件是一個JavaScript物件，它關係到由pushState()方法建立出來的新的history實體。用以儲存關於你所要插入到歷史 記錄的條目的相關資訊。State物件可以是任何Json字串。因為firefox會使用使用者的硬碟來存取state物件，這個物件的最大儲存空間為640k。如果大於這個數 值，則pushState()方法會丟擲一個異常。如果確實需要更多的空間來儲存，請使用本地儲存。

·        title—firefox現在回忽略這個引數，雖然它可能將來會被使用上。而現在最安全的使用方式是傳一個空字串，以防止將來的修改。或者可以傳一個簡短的標題來表示state

·        URL—這個引數用來傳遞新的history實體的URL，注意瀏覽器將不會在呼叫pushState()方法後載入這個URL。但也許會過一會嘗試載入這個URL。比如在使用者重啟了瀏覽器後，新的url可以不是絕對路徑。如果是相對路徑，那麼它會相對於現有的url。新的url必須和現有的url同域，否則pushState()將丟擲異常。這個引數是選填的，如果為空，則會被置為document當前的url。

某種意義上來說，呼叫pushState()方法很像設定了window.location = “#foo”,這兩者都會建立和啟用另一個關聯到當前document的history實體，但pushState()另外有一些優點：

l 新的url可以是任何和當前url同域的url，相比之下，如果只設定hash，window.location會保持在同一個document。

l 如果不需要，你可以不修改url。對比而言，設定window.location = “#foo”;僅產生新的history實體，如果你當前的hash不是#foo

l 你可以將任意的資料與你的新history實體關聯。使用基於hash的方法，需要將所有相關的資料編碼為一個短字串。

注意，pushState()方法不會使hashchange時間發生，即使是新舊url只是hash不同。

replaceState()方法

history.replaceState() 用起來很像pushState()，除了replaceState()是用來修改當前的history實體而不是建立一個新的。這個方法有時會很有用，當 你需要對某些使用者行為作反應而更新一個state物件或者當前history實體時，可以使用它來更新state物件或者當前history實體的url。

popstate事件

當history實體被改變時，popstate事件將會發生。如果history實體是有pushState和replaceState方法產生的，popstate事件的state屬性會包含一份來自history實體的state物件的拷貝

詳見window.onpopstate

讀取當前的state

讀取現有state

當頁面載入時，它可能會有一個非空的state物件。這可能發生在當頁面設定一個state物件(使用pushState或者replaceState)之後使用者重啟了瀏覽器。當頁面重新載入，頁面將收到onload事件，但不會有popstate事件。然而，如果你讀取history.state屬性，將在popstate事件發生後得到這個state物件

var currentState = history.state;

Browsers: Tested and Working In

HTML5 Browsers

Chrome 8,9,10
Firefox 4
Safari 5
Opera 11
Safari iOS 4.3
HTML4 Browsers

IE6,7,8,9
Firefox 3
Opera 10
Safari 4
Safari iOS prior to version 4.3