Ajax局部页面刷新和history的坑

原文地址：http://www.chanjar.me/blog/2014/12/17/ajax-ju-bu-ye-mian-shua-xin-he-history/

ajax在现代网站已经得到非常普遍地应用，主要的好处大家都知道（异步加载数据，不用刷新整个浏览器，更小的数据传输尺寸）。对于那些老网站或者老项目来说全盘改造成ajax并不现实，于是就有了“局部页面刷新”这个解决方案。 如果不知道“局部页面刷新”是何物请看这里，这里和这里。

在我们的项目里，将原来的iframe或者frame统统替换成了时髦的div，然后修改了页面上所有发起请求的地方，把响应内容jQuery.load到div里。 于是乎原来老旧的网站变成了一个时髦的基于ajax的网站，每个页面传输的数据量变小了，再也不用解决令人头疼的:

1. 为了消除滚动条让iframe自适应大小
2. 如何访问parent window变量的问题 (还有如何访问parent的parent的parent… window变量的问题)
3. 如何访问child iframe里的变量的问题了 (还有如何访问child的child的child… iframe里的变量的问题)。

因为大家永远都在同一个window里，而且div本身就会根据内容自动撑大。但是等等！浏览器怎么不能后退了？

我们的那个项目是一个满大街可见的XX管理信息系统，这种系统最常见的布局就是左侧一个树形菜单区域， 右侧是一个功能区域，功能区域里有一个查询条件区域（里面有个查询按钮），还有一个空白的区域用来显示查询结果，同时是用户操作数据的地方（比如form表单）。 在iframe时代，上面讲到的4个区域都是一个iframe，这也就意味着我们可以有很变态的后退能力。 当然了一般来说用户最常用的就是对操作区域做后退动作，比如查询一下，选择一条记录点击修改，看到form表单， 修改一下，在点击保存前后悔了，点击浏览器的后退，回到查询结果页面。

但是在引入了ajax后无法后退了，因为ajax请求不会记录到浏览器历史里，历史都没有了自然就无法后退了。

好在Html5的History API能够帮助我们解决问题。我们可以人为的使用history.pushState来人造历史信息， 并且通过监听popstate事件来知道用户点击了浏览器后退或前进按钮，然后将页面元素还原到历史上的某个状态。 关于Html5 History API的相关信息可以看这里。

下面是我们遇到的一些坑：

陷阱1：重复执行js脚本

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

// 点击查询按钮的时候人为构造一个浏览器历史 $('#some-button').click(function() { $(targetSelector).load(url); history.pushState({ container : targetSelector, content : $(targetSelector).html() }, null, url); }); // 当浏览器后退后者前进的时候，我们把当时的结果重新加载到container里来 window.addEventListener('popstate', function() { var state = history.state $(state.container).html(state.content); })

一切看上去都OK，直到…我们发现局部页面刷新所获得的结果里包含了操作dom元素的js。

当遇到这种情况时会发生很奇妙的现象，history state.content是已经加载完毕+js执行后的结果， 当我们重新还原的时候，我们会把这个结果加载出来，并且又会执行一遍js。如果这个js是一个添加dom的动作 那么在后退的时候你会看到这个重复的dom元素。

我们想过跟踪哪些dom元素是被js修改过的来避免这个问题，但是…这是不现实的。

陷阱2：无法还原到最初状态

前面的方案因为load的内容里可能有js脚本所以有严重缺陷，于是我们换了个思路，history里保存responseText，而不是已经load好后的东西。

1 2 3 4 5 6 7 8 9 10 11

// 点击查询按钮的时候人为构造一个浏览器历史 $('#some-button').click(function() { $(targetSelector).load(url, function(responseText) { history.pushState({ container : targetSelector, content : responseText }, null, url); }); }); // popstate事件的处理方式一样

但是仍然遇到了这么一个问题，如果这个targetDiv原来是有内容的，而这个内容不是通过ajax局部页面刷新而来， 而是用户一进入这个页面就已经有的，比如使用服务器端的模板引擎生成的页面，那么在它加载完html片段后就无法回退了。 因为它的内容一开始就不在history里（事实上浏览器自己产生的history是没有state的），这样就形成了退无可退的局面。

如果你想，我们只要保存这个container原来的内容不就行了，当后退的时候我们直接恢复它原来的内容，但是请看陷阱1

不过当发生退无可退的情况时，我们认为已经退回到了第一次进入页面的状态，这个时候我们刷新整个页面就行了。

陷阱3：多个并列的container

陷阱2的解决方案实际上是基于container之间是属于嵌套关系或者就一个container的情况的。如果是这种情况就不行了：

有A和B两个container，点击某个按钮刷新了A的内容（产生历史），然后在点击某个按钮刷新的B的按钮（产生历史）， 按照用户的预想情况，第一次后退还原B原来的内容，第二次后退还原A原来的内容。 但实际上，第一次后退无法还原B的内容（陷阱2），第二次后退页面刷新了（一切恢复最初的样子）。

如果B是嵌套在A里的就无所谓了，第一次后退的时候获得的是A的state，根据A的state还原A的内容的时候顺便把B也还原了， 第二次后退页面刷新，把A也还原了。

而且根据陷阱1所讲，我们也不能在history里存储A或者B里原来的内容。

解决办法：对于这种操作就不要记录历史了。

陷阱4：看到过时页面

我们在History state里存的是当时load时的responseText，当我们后退的时候看到的是过时的页面，比如我们原先查询结果里看到有A记录， 然后我们跳转到其他页面里，然后再后退到查询结果页面看到A记录还在，但是这个A记录很可能只是一个幽灵，在数据库里早就已经不存在了。 如果我们这个时候再对A记录操作就有出现错误。

解决办法是我们在history state里保存url已经相关的参数，当popstate的时候重新发起请求就行了，这样一来的话也减少了history所存储的数据量。

1 2 3 4 5 6 7 8 9 10 11 12 13 14

// 这里只给get请求的例子，post的原理也差不多 $('#some-button').click(function() { $(targetSelector).load(url, function(responseText) { history.pushState({ container : targetSelector, url : url }, null, url); }); }); window.addEventListener('popstate', function() { var state = history.state; $(state.container).load(state.url); });

陷阱5：无法精确还原dom对象的状态

不论是保存responseText还是保存url请求参数，都无法在浏览器后退的时候精确还原dom对象的状态，比如我在IE6里有个这样的特性， 你在某个页面勾选了某个checkbox，然后跳转到一个新的页面然后再后退，那个checkbox还是处于勾选状态，这个在利用ajax局部页面刷新里 是完全做不到的，想到用户和我说以前后退的时候那个勾还在现在勾没有了，不解决这个BUG就不验收的事情时才想到iframe的好啊。

所以如果要精确还原dom对象的状态，得在history.pushState的时候自行把相关信息保存下来，在popstate的时候用到这些信息并还原dom。

事实上即使用了iframe也并不是所有的浏览器会还原dom对象状态，看这篇文章。

总结

1. 不要轻易从iframe切换到ajax局部页面刷新
2. 要自己控制那些ajax局部页面刷新纪录历史，哪些不记录，有些时候可能还需要replaceState，不要想当然的把所有请求都记录历史
3. 把代码改造成ajax局部页面刷新只是第一步，还需要对整个网站、应用的UI做规划和设计，关于这个问题不存在通用的解决方案

参考资料

• MANIPULATING HISTORY FOR FUN & PROFIT
• Session history and navigation
• Manipulating the browser history