Change My World by Program

0%

Nuxt.js 教程

为什么要用nuxt.js,主要就是因为它可以服务端渲染(SSR),相比于传统的vue单页应用,将渲染放到服务器这边,性能肯定能得到很大提升,并且首次加载无需加载特别大的资源,且对搜索引擎友好,所以没有什么理由不用它。

目录结构

assets: 资源目录,用于组织未编译的静态资源

components: 组件目录

layouts: 布局目录

middleware: 中间件目录

pages: 页面目录

plugins: 插件目录

static: 插件目录,会被直接映射到根目录下,可以放置favicon.ico/robots.txt等文件

store: 用于组织应用的vuex状态树文件

nuxt.config.js: 个性化配置文件

配置

nuxt.config.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
module.exports = {
mode: 'spa',

/*
** Headers of the page
*/
head: {
title: pkg.name,
meta: [
{ charset: 'utf-8' },
{ name: 'viewport', content: 'width=device-width, initial-scale=1' },
{ hid: 'description', name: 'description', content: 'description' }
],
link: [
{ rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' } // 配置favicon.ico,需要将图片放到static目录下
]
},

/*
** Customize the progress-bar color
*/
loading: { color: '#fff' },

/*
** Global CSS
*/
css: [
{src: '~assets/scss/front.scss'},
],

/*
** Plugins to load before mounting the App
*/
plugins: [
{src: '~/plugins/test', ssr: false},
],

/*
** Nuxt.js modules
*/
modules: [
'@nuxtjs/axios'
],

axios: {
// proxyHeaders: false
proxyHeaders: false,
credentials: false
},

/*
** Build configuration
*/
build: {
/*
** You can extend webpack config here
*/
extend(config, ctx) {
// Run ESLint on save
if (ctx.isDev && ctx.isClient) {
config.module.rules.push({
enforce: 'pre',
test: /\.(js|vue)$/,
loader: 'eslint-loader',
exclude: /(node_modules)/
})
}
}
}
}

API

asyncData

  • 渲染组件之前异步获取数据

fetch

  • 渲染页面之前填充应用的状态树(store)数据,与asyncData方法类似,不同的是它不会设置组件的数据
  • 每次组件加载前被调用(在服务端或切换至目标路由之前)
  • fetch内部是无法使用this获取当前组件实例,因为此时组件还未初始化
  • 为了让获取过程可以异步,需要返回一个PromiseNuxt.js会等这个promise完成后再渲染组件
1
2
3
4
5
6
7
8
9
10
11
12
13
fetch ({ store, params }) {
return axios.get('http://my-api/stars')
.then((res) => {
store.commit('setStars', res.data)
}
)
}

// 或者使用async的方式简化一下
async fetch ({ store, params }) {
let { data } = await axios.get('http://my-api/stars')
store.commit('setStars', data)
}
TroubleShooting
  • 让组件不在服务端渲染而是在客户端渲染: 可以给组件加一个<no-ssr></no-ssr>包围,但是注意它只能一次包含一个组件,不能多个
  • *The client-side rendered virtual DOM tree is not matching server-rendered content. * 出现这个error,解决方法同上
  • 不生效: 可能是因为其包含的组件里面有槽,例如我在使用vue-infinite-loading的时候错误地在组件上加了slot="append"属性,导致<no-ssr>不生效,导致该组件既没在服务端渲染,也没在客户端渲染。
坚持原创技术分享,谢谢支持

欢迎关注我的其它发布渠道