Skip to content
登录后刷题更便捷

前端路由的实现

难度:

不管是 react-router 还是 vue-router 他们都是基于前端路由的一次拓展和封装,我们不想单纯地讲 vue 或者 react 的路由,我们就以最本质的前端路由进行分析.

前言

前端路由是现代 SPA 应用必备的功能,每个现代前端框架都有对应的实现,例如 vue-router、react-router。

我们不想探究 vue-router 或者 react-router 们的实现,因为不管是哪种路由无外乎用兼容性更好的 hash 实现或者是 H5 History 实现,与框架几个只需要做相应的封装即可。

提前声明: 我们没有对传入的参数进行及时判断而规避错误,也没有考虑兼容性问题,仅仅对核心方法进行了实现.

1.hash 路由

hash 路由一个明显的标志是带有#,我们主要是通过监听 url 中的 hash 变化来进行路由跳转。

hash 的优势就是兼容性更好,在老版 IE 中都有运行,问题在于 url 中一直存在#不够美观,而且 hash 路由更像是 Hack 而非标准,相信随着发展更加标准化的History API会逐步蚕食掉 hash 路由的市场。

1.1 初始化 class

我们用Class关键字初始化一个路由.

js
class Routers {
  constructor() {
    // 以键值对的形式储存路由
    this.routes = {};
    // 当前路由的URL
    this.currentUrl = "";
  }
}

1.2 实现路由 hash 储存与执行

在初始化完毕后我们需要思考两个问题:

  1. 将路由的 hash 以及对应的 callback 函数储存
  2. 触发路由 hash 变化后,执行对应的 callback 函数
js
class Routers {
  constructor() {
    this.routes = {};
    this.currentUrl = "";
  }
  // 将path路径与对应的callback函数储存
  route(path, callback) {
    this.routes[path] = callback || function () {};
  }
  // 刷新
  refresh() {
    // 获取当前URL中的hash路径
    this.currentUrl = location.hash.slice(1) || "/";
    // 执行当前hash路径的callback函数
    this.routes[this.currentUrl]();
  }
}

1.3 监听对应事件

那么我们只需要在实例化Class的时候监听上面的事件即可.

js
class Routers {
  constructor() {
    this.routes = {};
    this.currentUrl = "";
    this.refresh = this.refresh.bind(this);
    window.addEventListener("load", this.refresh, false);
    window.addEventListener("hashchange", this.refresh, false);
  }

  route(path, callback) {
    this.routes[path] = callback || function () {};
  }

  refresh() {
    this.currentUrl = location.hash.slice(1) || "/";
    this.routes[this.currentUrl]();
  }
}

2.增加回退功能

上一节我们只实现了简单的路由功能,没有我们常用的回退前进功能,所以我们需要进行改造。

2.1 实现后退功能

我们在需要创建一个数组history来储存过往的 hash 路由例如/blue,并且创建一个指针currentIndex来随着后退前进功能移动来指向不同的 hash 路由。

js
class Routers {
  constructor() {
    // 储存hash与callback键值对
    this.routes = {};
    // 当前hash
    this.currentUrl = "";
    // 记录出现过的hash
    this.history = [];
    // 作为指针,默认指向this.history的末尾,根据后退前进指向history中不同的hash
    this.currentIndex = this.history.length - 1;
    this.refresh = this.refresh.bind(this);
    this.backOff = this.backOff.bind(this);
    window.addEventListener("load", this.refresh, false);
    window.addEventListener("hashchange", this.refresh, false);
  }

  route(path, callback) {
    this.routes[path] = callback || function () {};
  }

  refresh() {
    this.currentUrl = location.hash.slice(1) || "/";
    // 将当前hash路由推入数组储存
    this.history.push(this.currentUrl);
    // 指针向前移动
    this.currentIndex++;
    this.routes[this.currentUrl]();
  }
  // 后退功能
  backOff() {
    // 如果指针小于0的话就不存在对应hash路由了,因此锁定指针为0即可
    this.currentIndex <= 0
      ? (this.currentIndex = 0)
      : (this.currentIndex = this.currentIndex - 1);
    // 随着后退,location.hash也应该随之变化
    location.hash = `#${this.history[this.currentIndex]}`;
    // 执行指针目前指向hash路由对应的callback
    this.routes[this.history[this.currentIndex]]();
  }
}

我们看起来实现的不错,可是出现了 Bug,在后退的时候我们往往需要点击两下。

问题在于,我们每次在后退都会执行相应的 callback,这会触发refresh()执行,因此每次我们后退,history中都会被push新的路由 hash,currentIndex也会向前移动,这显然不是我们想要的。

Js
  refresh() {
    this.currentUrl = location.hash.slice(1) || '/';
    // 将当前hash路由推入数组储存
    this.history.push(this.currentUrl);
    // 指针向前移动
    this.currentIndex++;
    this.routes[this.currentUrl]();
  }

我们每次点击后退,对应的指针位置和数组被打印出来

2.2 完整实现 hash Router

我们必须做一个判断,如果是后退的话,我们只需要执行回调函数,不需要添加数组和移动指针。

Js
class Routers {
  constructor() {
    // 储存hash与callback键值对
    this.routes = {};
    // 当前hash
    this.currentUrl = '';
    // 记录出现过的hash
    this.history = [];
    // 作为指针,默认指向this.history的末尾,根据后退前进指向history中不同的hash
    this.currentIndex = this.history.length - 1;
    this.refresh = this.refresh.bind(this);
    this.backOff = this.backOff.bind(this);
    // 默认不是后退操作
    this.isBack = false;
    window.addEventListener('load', this.refresh, false);
    window.addEventListener('hashchange', this.refresh, false);
  }

  route(path, callback) {
    this.routes[path] = callback || function() {};
  }

  refresh() {
    this.currentUrl = location.hash.slice(1) || '/';
    if (!this.isBack) {
      // 如果不是后退操作,且当前指针小于数组总长度,直接截取指针之前的部分储存下来
      // 此操作来避免当点击后退按钮之后,再进行正常跳转,指针会停留在原地,而数组添加新hash路由
      // 避免再次造成指针的不匹配,我们直接截取指针之前的数组
      // 此操作同时与浏览器自带后退功能的行为保持一致
      if (this.currentIndex < this.history.length - 1)
        this.history = this.history.slice(0, this.currentIndex + 1);
      this.history.push(this.currentUrl);
      this.currentIndex++;
    }
    this.routes[this.currentUrl]();
    console.log('指针:', this.currentIndex, 'history:', this.history);
    this.isBack = false;
  }
  // 后退功能
  backOff() {
    // 后退操作设置为true
    this.isBack = true;
    this.currentIndex <= 0
      ? (this.currentIndex = 0)
      : (this.currentIndex = this.currentIndex - 1);
    location.hash = `#${this.history[this.currentIndex]}`;
    this.routes[this.history[this.currentIndex]]();
  }
}

前进的部分就不实现了,思路我们已经讲得比较清楚了,可以看出来,hash 路由这种方式确实有点繁琐,所以 HTML5 标准提供了 History API 供我们使用。

3. HTML5 新路由方案

3.1 History API

我们可以直接在浏览器中查询出 History API 的方法和属性。

当然,我们常用的方法其实是有限的,如果想全面了解可以去 MDN 查询History API 的资料

我们只简单看一下常用的 API

Js
window.history.back();       // 后退
window.history.forward();    // 前进
window.history.go(-3);       // 后退三个页面

history.pushState用于在浏览历史中添加历史记录,但是并不触发跳转,此方法接受三个参数,依次为:

state:一个与指定网址相关的状态对象,popstate事件触发时,该对象会传入回调函数。如果不需要这个对象,此处可以填null
title:新页面的标题,但是所有浏览器目前都忽略这个值,因此这里可以填null
url:新的网址,必须与当前页面处在同一个域。浏览器的地址栏将显示这个网址。

history.replaceState方法的参数与pushState方法一模一样,区别是它修改浏览历史中当前纪录,而非添加记录,同样不触发跳转。

popstate事件,每当同一个文档的浏览历史(即 history 对象)出现变化时,就会触发 popstate 事件。

需要注意的是,仅仅调用pushState方法或replaceState方法 ,并不会触发该事件,只有用户点击浏览器倒退按钮和前进按钮,或者使用 JavaScript 调用backforwardgo方法时才会触发。

另外,该事件只针对同一个文档,如果浏览历史的切换,导致加载不同的文档,该事件也不会触发。

以上 API 介绍选自history 对象,可以点击查看完整版,我们不想占用过多篇幅来介绍 API。

3.2 新标准下路由的实现

上一节我们介绍了新标准的 History API,相比于我们在 Hash 路由实现的那些操作,很显然新标准让我们的实现更加方便和可读。

所以一个 mini 路由实现起来其实很简单

Js
class Routers {
  constructor() {
    this.routes = {};
    // 在初始化时监听popstate事件
    this._bindPopState();
  }
  // 初始化路由
  init(path) {
    history.replaceState({path: path}, null, path);
    this.routes[path] && this.routes[path]();
  }
  // 将路径和对应回调函数加入hashMap储存
  route(path, callback) {
    this.routes[path] = callback || function() {};
  }

  // 触发路由对应回调
  go(path) {
    history.pushState({path: path}, null, path);
    this.routes[path] && this.routes[path]();
  }
  // 监听popstate事件
  _bindPopState() {
    window.addEventListener('popstate', e => {
      const path = e.state && e.state.path;
      this.routes[path] && this.routes[path]();
    });
  }
}

小结

我们大致探究了前端路由的两种实现方法,在没有兼容性要求的情况下显然符合标准的 History API 实现的路由是更好的选择。

想更深入了解前端路由实现可以阅读vue-router 代码,除去开发模式代码、注释和类型检测代码,核心代码并不多,适合阅读。

内容仅供参考,难免有不恰当的地方,如果有问题欢迎及时反馈
部分内容来自网络,如果不慎侵犯您的权益,请联系我们,以便及时删除侵权内容