Nuxt.js之自动路由原理

Nuxt.js 是一个基于 Vue.js 的通用应用框架。集成了Vue 二、Vue-Router、 Vuex、Vue-Meta,用于开发完整而强大的 Web 应用。vue

它的特性有服务端渲染、强大的路由功能,支持异步数据、HTML头部标签管理等。

今天主要介绍的就是Nuxt的特性之一,强大的路由功能。nuxt.js会根据pages目录结构自动生成vue-router模块的路由配置。

nuxt源码地址: https://github.com/nuxt/nuxt....node

建议打开源码跟着文章的步骤看,第一次写,文中有任何错误或者表述不清的地方,欢迎批评指正。webpack


首先介绍下nuxt路由的使用

nuxt会根据pages下的文件自动生成路由并引入,支持vue-router的基础路由,动态路由,嵌套路由等。基础路由很简单,须要注意的是,在使用动态路由时,须要建立对应的如下划线做为前缀的 Vue文件或目录git

例如:github

pages/
--| users/
-----| _id.vue
--| index.vue

Nuxt.js 生成对应的路由配置表为:web

router: {
  routes: [{
           name: 'index',
           path: '/',
           component: 'pages/index.vue'
          },
          {
           name: 'users-id',
           path: '/users/:id?',
           component: 'pages/users/_id.vue'
          }]
        }

生成的动态路由, users-id 的路由路径带有 :id? 参数,表示该路由是可选的。若是你想将它设置为必选的路由,须要在 users/_id 目录内建立一个 index.vue 文件。vue-router

其次须要注意的是在使用嵌套路由时,须要在pages下添加一个 同名的Vue 文件,用来存放子视图组件。npm

例如:json

pages/
--| users/
-----| _id.vue 
-----| index.vue  
--| users.vue

Nuxt.js 生成对应的路由配置表为:服务器

router: {
   routes: [{
      path: '/users',
      component: 'pages/users.vue',
         children: [{
          path: '',
          component: 'pages/users/index.vue',
          name: 'users'
         },
         {
          path: ':id',
          component: 'pages/users/_id.vue',
          name: 'users-id'
         }]
     }]
 }

接下来看为何要这么写,包括怎么自动生成路由的原理。

  • 第一步

从npm run dev 提及,package.json 中,npm run dev 运行以后的命令是

dev : "PORT=3004backpack dev"

ps: Backpack是Node.js项目的简约的构建系统,在这里它自定义了一个配置backpack.config.js扩展webpack,backpack dev命令是以开发模式运行webpack。

  • 第二步

再看自定义的backpack.config.js,返回了server文件下的index.js

clipboard.png

  • 第三步

再查看index.js,在这里它搭建了服务器端口号,读取了nuxt.config文件,而且初始化了nuxt类。引入了node module中nuxt的Nuxt, Builder

clipboard.png

  • 第四步

如今能够去nuxt的源码看具体是怎么自动生成路由的了
在builder.js中,对全部文件进行打包,其中有一步就是构建路由

generateRoutesAndFiles, 它引入了glob库对page下的文件进行遍历,并进行了字符串的处理,最后将全部的vue文件地址,整个的项目地址和pages做为参数传给createRoutes 函数

clipboard.png

  • 第五步

再看createRoutes函数具体作了什么 (common/utils.js)
在createRoutes函数中对传过来的全部文件地址进行遍历,再对每个文件地址字符串处理,以中划线进行拼接。以此做为route.name

clipboard.png
再用lodash库对routes进行查找,这里就能够看出为何使用嵌套路由要在同路径下再加一个同名的vue文件,它的判断条件就是在routes中找到 name:route.name的集合

若是有嵌套路由,暂时route.path为空,没有嵌套路由就直接以'/'拼接route.path,这里就能够看到动态路由的合成原理,若是是动态路由,route.path将会以 : 替换 _ ,末尾加上 ?

clipboard.png
将route.name和route.path都放入routes中,进行排序,路径短的先放入,最后调用cleanChildrenRoutes函数,对嵌套路由进行处理。

至此对routes的path 和name的命名的处理已经结束。

  • 第六步

再回到build.js中, 打包完后会生成模版文件,routes.js

在模版文件route.js中, 实例了项目的路由

并引入了路由组件,在引入时,将组件命名为下划线加上组件的hash值并去重引入

clipboard.png这样就是一个完整的自动生成路由的过程。

相关文章
相关标签/搜索