快捷導(dǎo)航

詳解Vue基于 Nuxt.js 實(shí)現(xiàn)服務(wù)端渲染（SSR）

更新時間：2018年04月05日 11:02:40 作者：WiseWrong

直接使用 Vue 構(gòu)建前端單頁面應(yīng)用，頁面源碼時只有簡單的幾行 html，這并不利于網(wǎng)站的 SEO，這時候就需要服務(wù)端渲染，本篇文章主要介紹了詳解Vue基于 Nuxt.js 實(shí)現(xiàn)服務(wù)端渲染（SSR），具有一定的參考價值，感興趣的小伙伴們可以參考一下

直接使用 Vue 構(gòu)建前端單頁面應(yīng)用，頁面源碼時只有簡單的幾行 html，這并不利于網(wǎng)站的 SEO，這時候就需要服務(wù)端渲染

2016 年 10 月 25 日，zeit.co 背后的團(tuán)隊(duì)對外發(fā)布了一個 React 的服務(wù)端渲染應(yīng)用框架 Next.js

幾小時后，一個基于 Vue.js 的服務(wù)端渲染應(yīng)用框架應(yīng)運(yùn)而生，與 Next.js 異曲同工，這就是Nuxt.js

一、快速模板

在已經(jīng)安裝了 vue-cli 的前提下，可以快速創(chuàng)建一個 nuxt 的項(xiàng)目模板

vue init nuxt-community/starter-template MyProject

其中 MyProject 是項(xiàng)目文件夾名稱，可自定義

通過 npm install （似乎用 yarn install 更順利）安裝依賴之后，可以直接 npm run dev 在 開發(fā)環(huán)境 啟動項(xiàng)目

默認(rèn)啟動的地址為 http://localhost:3000/，可以在 package.json 中添加以下配置來修改主機(jī)端口號

 "config": {
  "nuxt": {
   "host": "0.0.0.0",
   "port": "7788"
  }
 },

開發(fā)完成后執(zhí)行 npm run build 打包代碼，最后 npm start 啟動服務(wù)

二、重要目錄

生成的項(xiàng)目目錄如下

大部分文件夾名稱 都是 nuxt 默認(rèn)保留的，不可修改

其中比價比較關(guān)鍵的目錄有三個：

1. components 組件目錄

一般用來存放 非頁面級別 的組件，如 header、footer 等公共組件

該目錄下的組件具有常規(guī) vue 組件的方法和特性，不會被 nuxt.js 擴(kuò)展特性

2. layouts 布局目錄

可以修改該目錄下的 default.vue 來修改默認(rèn)布局

<template>
 <div>
  <my-header></my-header>
  <nuxt/>
  <my-footer></my-footer>
 </div>
</template>

其中 <nuxt/> 是必需的，頁面的主體內(nèi)容會顯示在這里（類似于根節(jié)點(diǎn)的 <router-view/>）

此外還可以在目錄下新增 error.vue 作為錯誤頁面，具體的寫法可以參考官方文檔

3. pages 頁面目錄

用于存放頁面級別的組件，nuxt 會根據(jù)該目錄下的頁面結(jié)構(gòu)生成路由

比如上圖中的頁面結(jié)構(gòu)，會生成這樣的路由配置：

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'
    },
    { //定義帶參數(shù)的動態(tài)路由，需要創(chuàng)建對應(yīng)的以下劃線作為前綴的 Vue 文件或目錄
     path: ':id',
     component: 'pages/classroom/_id.vue',
     name: 'classroom-id'
    }
   ]
  }
 ]
}

此外，該目錄下的 vue 組件還具備一些 Nuxt.js 提供的特殊功能特性

其中 asyncData 方法比較常用，支持異步數(shù)據(jù)處理

這個方法會在 頁面組件 每次加載之前被調(diào)用，然后獲取數(shù)據(jù)并返回給當(dāng)前組件

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 方法的第一個參數(shù)為上下文對象 context，具體屬性可以查看這里

由于asyncData方法是在組件初始化前被調(diào)用的，所以在方法內(nèi)是沒有辦法通過 this 來引用組件的實(shí)例對象

三、使用插件

如果項(xiàng)目中還需要引入其他的第三方插件，可以直接在頁面中引入，這樣在打包的時候，會將插件打包到頁面對應(yīng)的 js 里面

但要是別的頁面也引入了同樣的插件，就會重復(fù)打包。如果沒有需要分頁打包的需求，這時候可以配置 plugins

以 element-ui 為例，在安裝了 element-ui 之后，在 plugins 目錄下創(chuàng)建 elementUI.js

然后在根目錄的 nuxt.config.js 中添加配置項(xiàng) build.vendor 和 plugins

 build: {
  vendor: ['~/plugins/elementUI.js']
 },
 plugins: [
  {src: '~/plugins/elementUI.js'},
 ]

這里的 plugins 屬性用來配置 vue.js 插件，也就是 可以用 Vue.user() 方法 的插件

默認(rèn)只需要 src 屬性，另外還可以配置 ssr: false，讓該文件只在客戶端被打包引入

如果是像 axios 這種第三方（不能 use）插件，只需要在 plugins 目錄下創(chuàng)建 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 狀態(tài)樹

如果在 store 目錄下創(chuàng)建了 index.js，nuxt.js 會根據(jù)該目錄下的文件創(chuàng)建 Vuex 狀態(tài)樹

// 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 內(nèi)置引用了 vuex 模塊，不需要額外安裝

上面的代碼中，我在 actions 中寫了一個 loadAboutMeInfo() 方法，用來請求 /api/about 接口

然后在 about.vue 頁面中調(diào)用

// 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>

成果演示：