SPA 中前端路由基本原理与实现方式

SPA 前端路由原理与实现方式

通常 SPA 中前端路由有2中实现方式，本文会简单快速总结这两种方法及其实现：

1. 修改 url 中 Hash
2. 利用 H5 中的 history

Hash

我们都知道 url 中可以带有一个 hash， 比如下面 url 中的 page2

https://www.abc.com/index.html#page2

window 对象中有一个事件是 onhashchange，以下几种情况都会触发这个事件：

1. 直接更改浏览器地址，在最后面增加或改变#hash；
2. 通过改变location.href或location.hash的值；
3. 通过触发点击带锚点的链接；
   4）浏览器前进后退可能导致hash的变化，前提是两个网页地址中的hash值不同。

这个事件有 2 个重要的属性：oldURL 和 newURL，分别表示点击前后的 url

<a href="#page2">click mea>
<script type="text/javascript"> window.onhashchange = function(e){ console.log(e.oldURL); //https://www.abc.com/index.html console.log(e.newURL); //https://www.abc.com/index.html#page2 } script>

这样我们可以这样建立一个 DOM

  <nav>
    <a class="item active" href="#page1" data-target="#index">page1a>
    <a class="item" href="#page2" data-target="#info">page2a>
    <a class="item" href="#page3" data-target="#detail">page3a>
    <a class="item" href="#page4" data-target="#show">paga4a>
    <a class="item" href="#page5" data-target="#contact">paga5a>
  nav>
  <div class="container">
    <div class="page active" id="index">
      <h1>This is index pageh1>
    div>
    <div class="page" id="info">
      <h1>This is info pageh1>
    div>
    <div class="page" id="detail">
      <h1>This is detail pageh1>
    div>
    <div class="page" id="show">
      <h1>This is show pageh1>
    div>
    <div class="page" id="contact">
      <h1>This is contact pageh1>
    div>
  div>

为了好看我们加上 css， 比较重要的样式已经在代码里标出来了。

body{ padding:0; margin: 0; }
h1{ margin: 0 0 0 160px; }
nav{ width: 150px; height: 150px; float: left; }
nav a{ display: block; background: #888; border: 1px solid #fff; border-top: none; width: 150px; font-size: 20px; line-height: 30px; text-align: center; color: #333; text-decoration: none; }
.container{ height: 154px; }
/* page 部分比较重要*/
.page{ display: none; }
.page.active{ display: block; }
/* page 部分比较重要*/
nav a.active, .container{ background: #ddd; border-right-color: #ddd; }

重点是下面的 javascript，这里 DOM 操作我们借助 jQuery

  var containers = $('.container');
  var links = $('.item');

  window.onhashchange = function(e){
    var currLink = $('[href="'+ location.hash + '"]').eq(0);
    var target = currLink.attr('data-target');

    currLink.addClass('active').siblings('a.item').removeClass('active');
    $(target).addClass('active').siblings('.page').removeClass('active');
  }

实现的逻辑不难，但是利用 hash 总是没有所谓前端路由的那种味，必然也不是主流方法。同样的效果如果需求简单不考虑兼容性的话，利用 css3 中 target 伪类就可以实现，这不是本文的重点，这里就不展开了。

history

作为一种主流方法，我们下面看看 history 如何实现。

history 其实浏览器历史栈的一个借口，去过只有 back(), forward(), 和 go() 方法实现堆栈跳转。到了 HTML5 ， 提出了 pushState() 方法和 replaceState() 方法，这两个方法可以用来向历史栈中添加数据，就好像 url 变化了一样（过去只有 url 变化历史栈才会变化），这样就可以很好的模拟浏览历史和前进后退了。而现在的前端路由也是基于这个原理实现的。

这里我们先简单认识一下 history：

go(n) 方法接受一个整数参数， n大于0会发生前进 n 个历史栈页面; n小于0会后退 -n 个历史栈页面；

forward() 前进一个页面

back() 后退一个页面

• 以上三个方法会静默失败

pushSate(dataObj, title, url) 方法向历史栈中写入数据，其第一个参数是要写入的数据对象（不大于640kB)，第二个参数是页面的 title, 第三个参数是 url (相对路径)。这里需要说明的有3点：

1. 当 pushState 执行一个浏览器的 url 会发生变化，而页面不会刷新，只有当触发的前进后退等事件浏览器才会刷新；
2. 这里的 url 是受到同源策略限制的，防止恶意脚本模仿其他网站 url 用来欺骗用户。所以当违背同源策略时将会报错;
3. 火狐目前会忽略 title 参数

replaceState(dataObj, title, url) 这个和上一个的区别就在于它不是写入而是替换栈顶记录，其余和 pushState 一模一样

History 还有1个静态只读属性：

History.length：当然历史堆栈长度

• 还有的都是已经废除的老古董了，这里就不提了

了解了这么多，那么可以研究一下如何利用 history 实现一个前端路由了，这里只考虑 javascript 部分，css 部分和上文一致。这里我们修改部分 html:

<a class="item active" href="/page1.html" data-target="#index">page1a>
<a class="item" href="/page2.html" data-target="#info">page2a>
<a class="item" href="/page3.html" data-target="#detail">page3a>
<a class="item" href="/page4/subpage1.html" data-target="#show">paga4-1a>
<a class="item" href="/page5/subpage2.html" data-target="#contact">paga4-2a>

我们修改了 a 标签的 href，这样的链接看上去才不是锚点了，不过这个过程我们要处理比较多的工作。首先为了简单一些，我们的这里仅仅对 .html 或没有扩展名结尾的链接设置前端路由：

// 通过委托的方法组织默认事件
var routerRxp = /\.html$|\/[^.]*$|/;
$(document).click(function(e){
  var href = e.target.getAttribute('href');
  if(href && routrRxp.test(href)){
    e.preventDefault();
  }
});

而后我们在点击时把数据写入历史栈，并控制 class 效果：

$(document).click(function(e){
  var href = e.target.getAttribute('href');

  if(href && routerRxp.test(href)){
    var id = e.target.getAttribute('data-target');
    history.pushState({targetId: id}, 'History demo', href);
    $(id).addClass('active').siblings('.page').removeClass('active');
    e.preventDefault();
  }
});

到这里，链接就可以点击了，但是浏览器的前进后退还不能用，我们加入 onpopstate 事件：

$(window).on('popstate',function(e){
  var id = e.originalEvent.state.targetId;
  $(id).addClass('active').siblings('.page').removeClass('active');
});

这样前进后退就可以用了，但是我们发现这样并不能退回主页，因为我们的主页默认就是 page1 标签页，所以没有为主页添加 state，简单处理就让其自己刷新好啦：

var indexPage = location.href;
$(window).on('popstate',function(e){
  if(location.href === indexPage){
    location.reload();
  }
  var id = e.originalEvent.state.targetId;
  $(id).addClass('active').siblings('.page').removeClass('active');
});

注意，这里不能使用重置 location.href 的方法刷新，那样就不能再前进了。

下面附上 history 方法的完整 js 代码

var indexPage = location.href;
  var routerRxp = /\.html$|\/[^.]*$|/;
  $(document).click(function(e){
    var href = e.target.getAttribute('href');

    if(href && routerRxp.test(href)){
      var id = e.target.getAttribute('data-target');
      history.pushState({targetId: id}, 'History demo', href);
      $(id).addClass('active').siblings('.page').removeClass('active');
      e.preventDefault();
    }
  });

$(window).on('popstate',function(e){
  if(location.href === indexPage){
    location.reload();
  }
  var id = e.originalEvent.state.targetId;
  $(id).addClass('active').siblings('.page').removeClass('active');
});

最后，关于两种方法有一些比较重要的特性总结一下：

1. 有的文章提到“Firfox，Chrome在页面首次打开时都不会触发popstate事件，但是safari会触发该事件”，经实测现在的 safari 不存在这个问题。
2. Mozilla指出，在 popstate 事件中，e.originalEvent.state 属性是存在硬盘里的，触发该事件后读取的历史栈信息是通过 pushState 或 replaceState 写入的才会有值，否则改属性为 null。
3. history.state 和 e.originalEvent.state 异曲同工，而且前者可以在该事件之外任何地方随时使用。
4. 由于 pushSate, onpopstate 属于 H5 的部分，存在一定兼容问题，可以使用 History.js (Github) 的 polyfill 解决这个问题。