URL Hash:指的是網址中「#」號後方的那段字串,通常用來定位到 HTML 頁面裡的某個錨點。由於 hash 改變時瀏覽器不會重新載入頁面,因此在 Ajax 應用中常被拿來保存腳本的執行狀態,Gmail 就是經典案例。
jQuery hashchange event plugin:在 Internet Explorer 8、Firefox 3.6+ 與 Chrome 5+ 中,瀏覽器已原生提供 window.onhashchange 事件;但在更舊的版本裡並沒有這個事件。此插件透過定時器持續比對 hash 是否改變,藉此在舊版瀏覽器中補上 hashchange 事件的能力。
先前的 jQuery 擴充提供了以下四個方法:
$.hashchangebroker.subscrib(fragName, handler)
訂閱 fragName 對應的 hash 段落變化,並轉發給指定的 handler。url hash 由若干個 frag 組成,每個 frag 的格式為:[fragName]:[state]。其中 fragName 是自行定義的狀態名稱,state 則是經過 base64 編碼的 JSON 字串。handler 僅有一個參數 state,為描述自訂狀態的 JSON 格式字串。
$.hashchangebroker.publish(hash)
此方法應綁定到 window.onhashchange 事件,負責接收 hash、解碼後找出變動的 frag,並轉發給訂閱該 frag 的 handler。
$.hashchangebroker.changeFrag(fragName, state)
此方法由 statehashable 型別呼叫,用來修改 hash 中對應 fragName 的 frag 的 state。
$.hashchangebroker.init()
此方法用於頁面重新載入後取得 hash 並執行 publish。只需在 $(document).ready 中呼叫即可,且應放在所有 subscrib 方法之後。
提供這個 widget 的目的,是希望能夠方便地將控制項的狀態發布到 url hash,並取得控制項對應 frag 的 state 變化,進而觸發相應的 statechange 事件。
用法為 $(dom).statehashable();。呼叫之後,會為該 dom 物件加上 hashchange 事件。當 statehashable 物件偵測到對應的 frag 變化時,便會觸發該 dom 物件的 hashchange 事件。
使用方法:
$(dom).bind("hashchange", function(e, stateObj) {
// 判斷 stateObj 的狀態,將 dom 還原到對應狀態
});
此外,應在變更 dom 狀態的方法中增加 statechange 事件的觸發,statehashable 物件會攔截該事件,並呼叫 hashchangebroker 的 changeFrag 方法來修改 hash。觸發範例:
$(dom).trigger("statechange", [stateName, stateValue]);