关于hashchangebroker和statehashable的补充文档
作者:
url hash:url中#号后面那段,通常用来定位到html页面中某一锚点。因为hash变化页面不会刷新,所以在ajax应用中用hash来存储脚本运行状态,例如gmail的做法。
jquery hash change event plugin: Internet Explorer 8, Firefox 3.6+, 和Chrome 5+里,已经提供了window.onhashchange事件,但是在老版本的浏览器中并没有这个事件,这个插件通过定时器判断hash是否产生了变化,以便在老版本的浏览器重提供hashchange事件。
hashchangebroker:之前写了这个jquery extend,提供了四个方法:
$.hashchangebroker.subscrib(fragName, handler)
订阅fragName对应的hash段落变化,并转发给指定的handler。
url hash由若干个frag组成,一个frag格式为:[fragName]:[state]。fragName为自定义hash状态名称。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方法之后。
statehashable:提供这个widget是希望可以比较方便的将控件的状态发布到url hash,并获取控件对应的hash frag的state变化,触发相应的statechange事件。
用法$(dom).statehashable();调用此方法后,给dom对象增加了hashchange事件。当statehashable对象发现控件对应的hash frag变化后,会触发dom对象的hashchange事件。
使用方法:
$(dom).bind("hashchange",function(e,stateObj){
//判断stateObj的状态,还原dom到对应的状态
});
应在更改dom状态的方法中增加statechange的事件触发,statehashable对象会捕捉该事件,并调用hashchangebroker的changeFrag方法,修改hash。statechange触发示例:
$(dom).trigger("statechange",[stateName,stateValue]);