详解Vue基于 Nuxt.js 实现服务端渲染(SSR)
直接使用 vue 构建前端单页面应用,页面源码时只有简单的几行 html,这并不利于网站的 seo,这时候就需要服务端渲染
2016 年 10 月 25 日,zeit.co 背后的团队对外发布了一个 react 的服务端渲染应用框架 next.js
几小时后,一个基于 vue.js 的服务端渲染应用框架应运而生,与 next.js 异曲同工,这就是nuxt.js
一、快速模板
在已经安装了 vue-cli 的前提下,可以快速创建一个 nuxt 的项目模板
vue init nuxt-community/starter-template myproject
其中 myproject 是项目文件夹名称,可自定义
通过 npm install (似乎用 yarn install 更顺利) 安装依赖之后,可以直接 npm run dev 在 开发环境 启动项目
默认启动的地址为 http://localhost:3000/,可以在 package.json 中添加以下配置来修改主机端口号
"config": { "nuxt": { "host": "0.0.0.0", "port": "7788" } },
开发完成后执行 npm run build 打包代码,最后 npm start 启动服务
二、重要目录
生成的 如下
大部分文件夹名称 都是 nuxt 默认保留的,不可修改
其中比价比较关键的目录有三个:
1. components 组件目录
一般用来存放 非页面级别 的组件,如 header、footer 等公共组件
该目录下的组件具有常规 vue 组件的方法和特性,不会被 nuxt.js 扩展特性
2. layouts 布局目录
可以修改该目录下的 default.vue 来修改默认布局
<template> <div> <my-header></my-header> <nuxt/> <my-footer></my-footer> </div> </template>
其中 <nuxt/> 是必需的,页面的主体内容会显示在这里 (类似于根节点的 <router-view/>)
此外还可以在目录下新增 error.vue 作为错误页面,具体的写法可以参考官方文档
3. pages 页面目录
用于存放页面级别的组件,nuxt 会根据该目录下的页面结构生成
比如上图中的页面结构,会生成这样的路由配置:
router: { routes: [ { name: 'index', path: '/', component: 'pages/index.vue' }, { name: 'about', path: '/about', component: 'pages/about.vue' }, { name: 'classroom', path: '/classroom', component: 'pages/classroom.vue', children: [ { path: 'student', component: 'pages/classroom/student.vue', name: 'student' }, { //定义带参数的动态路由,需要创建对应的以下划线作为前缀的 vue 文件或目录 path: ':id', component: 'pages/classroom/_id.vue', name: 'classroom-id' } ] } ] }
此外,该目录下的 vue 组件还具备一些 nuxt.js 提供的特殊功能特性
其中 asyncdata 方法比较常用,支持异步数据处理
这个方法会在 页面组件 每次加载之前被调用,然后获取数据并返回给当前组件
asyncdata ({ params, error }) { return axios.get(`api/posts/${params.id}`) .then((res) => { return { name: res.data.name} }) .catch((e) => { error({ statuscode: 404, message: 'not found' }) }) }
asyncdata 方法的第一个参数为上下文对象 context,具体属性可以 查看这里
由于asyncdata方法是在组件初始化前被调用的,所以在方法内是没有办法通过 this 来引用组件的实例对象
三、使用插件
如果项目中还需要引入其他的第三方插件,可以直接在页面中引入,这样在打包的时候,会将插件打包到页面对应的 js 里面
但要是别的页面也引入了同样的插件,就会重复打包。如果没有需要分页打包的需求,这时候可以配置 plugins
以 element-ui 为例,在安装了 element-ui 之后,在 plugins 目录下创建 elementui.js
然后在根目录的 nuxt.config.js 中添加配置项 build.vendor 和 plugins
build: { vendor: ['~/plugins/elementui.js'] }, plugins: [ {src: '~/plugins/elementui.js'}, ]
这里的 plugins 属性用来配置 vue.js 插件,也就是 可以用 vue.user() 方法 的插件
默认只需要 src 属性,另外还可以配置 ssr: false,让该文件只在客户端被打包引入
如果是像 axios 这种第三方 (不能 use) 插件,只需要在 plugins 目录下创建 axios.js
// axios.js import vue from 'vue' import axios from 'axios' const service = axios.create({ baseurl: '/api' }) vue.prototype.$ajax = axios export default service
然后在 build.vendor 中添加配置 (不需要配置 plugins)
build: { vendor: ['~/plugins/axios.js'] }
这样在打包的时候,就会把 axios 打包到 vendor.js 中
四、vuex 状态树
如果在 store 目录下创建了 index.js,nuxt.js 会根据该目录下的文件创建 vuex 状态树
// store/index.js import vue from 'vue' import vuex from 'vuex' import axios from '~/plugins/axios.js'; vue.use(vuex) const store = () => new vuex.store({ state: { author: 'wisewrong', info: '' }, mutations: { setinfo (state, val) { state.info = val } }, actions: { loadaboutmeinfo ({commit, state}) { return axios.get(`/about`) .then(res => { console.log('ajax is success') console.log(res.data.info) commit('setinfo', res.data.info) }) .catch(err => { console.log('error') }) } } }) export default store
nuxt.js 内置引用了 vuex 模块,不需要额外安装
上面的代码中,我在 actions 中写了一个 loadaboutmeinfo() 方法,用来请求 /api/about 接口
然后在 about.vue 页面中调用
// about.vue <template> <section class="container"> <div> <img src="~/assets/about.png" alt=""> </div> <h1>{{$store.state.info}}</h1> </section> </template> <script> export default { fetch({ store }) { return store.dispatch('loadaboutmeinfo') }, name: 'about', data () { return {} } } </script>
成果演示:
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
上一篇: 实例讲解vue源码架构
下一篇: Vue.js实现的购物车功能详解