关于hashchangebroker和statehashable的补充文档

dly · 发表于 2011-9-12 15:24:29

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]);

关于hashchangebroker和statehashable的补充文档

相关帖子