搭建Nuxt项目(搭配Element UI、axios)

使用Nuxt

Nuxt.js文档:https://zh.nuxtjs.org/guide/

开始

初始化Nuxt项目

npx create-nuxt-app <项目名>

// or

yarn create nuxt-app <项目名>

运行

npm run dev

路由

基础路由

Nuxt.js依据 pages 目录结构自动生成 vue-router 模块的路由配置。

举例, pages 如下:

pages/
--| user/
-----| index.vue
-----| one.vue
--| index.vue

那么,Nuxt.js 自动生成的路由配置如下:

router: {
  routes: [
    {
      name: 'index',
      path: '/',
      component: 'pages/index.vue'
    },
    {
      name: 'user',
      path: '/user',
      component: 'pages/user/index.vue'
    },
    {
      name: 'user-one',
      path: '/user/one',
      component: 'pages/user/one.vue'
    }
  ]
}

路由传参

由于在Nuxt.js中,不需要配置 vue-router ,路由配置完全依赖 pages 目录的结构。所以传参时也不例外。

vue-router 中,通过 path: '/route/:param' 定义参数,而在Nuxt.js中,通过 _ 为前缀命名的Vue文件或目录。

通过 $route.params.参数名 取到参数值。

layout

在项目中,通常有一些组件,可以被多个页面复用,如 header、footer、nav 等,这些组件可以共同组成一个布局。

在Nuxt项目结构中,有 /layouts 文件夹,在这个文件夹中写布局文件。通常是引入 /components 里的组件,再加上 <nuxt />

举例:

<template>
  <div class="mLayout">
    <m-header />
    <!-- 这个是“坑”,使用了这个布局文件的页面生成的内容,将出现在下面的这个“坑”里面 -->
    <nuxt />
  </div>
</template>

<script>
// 需要注意的一个小细节 在Nuxt项目中 ~ 代表根目录
import mHeader from '~/components/mHeader.vue'

export default {
  components: {
    'm-header': mHeader
  }
}
</script>

在项目中使用Element-UI

安装element-ui

npm i element-ui -S

创建ElementUI.js

/plugins 文件夹下面,创建 ElementUI.js 文件。

import Vue from 'vue'
import ElementUI from 'element-ui'
Vue.use(ElementUI)

在nuxt.config.js中添加配置

css: [
  'element-ui/lib/theme-chalk/index.css'
],
plugins: [
  // ssr: true表示这个插件只在服务端起作用
  {src: '~/plugins/ElementUI', ssr: true }
],
build: {
  // 防止element-ui被多次打包
  vendor: ['element-ui']
}

在项目中使用axios

安装axios

npm i axios -S

创建axios.js

/plugins 文件夹下面,创建 axios.js 文件。

import axios from 'axios'

// 设置baseURL
axios.defaults.baseURL = 'http://localhost:3301'

// 创建axios对象,暴露
export default axios.create()

在nuxt.config.js中添加配置

防止重复打包

build: {
  vendor: ['axios']
}

使用

在项目的任意一个Vue文件中,引入生成了的axios对象:

import axios from '~/plugins/axios'

如果没有事先创建axios.js,也可以直接引入axios模块来使用:

import axios from 'axios'

先创建axios.js,生成axios对象的好处是,可以做一些配置,如baseURL等。

SEO优化

全局

修改 nuxt.config.js 配置文件,项目生成的每一个 html 文件的 <head> 中都会加入此配置。

  head: {
    // title: pkg.name,
    title: '想被百度垂青的标题',
    meta: [
      { charset: 'utf-8' },
      { name: 'viewport', content: 'width=device-width, initial-scale=1' },
      { hid: 'description', name: 'description', content: pkg.description },
      // 其它那些是本来就有的,加上的内容在这里
      {
        name: 'keywords',
        content:
          '很多个很多个关键词很多个很多个关键词很多个很多个关键词'
      }
    ],
    link: [{ rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }]
  },

局部

某个 Vue 文件中:

<script>
export default {
  layout: 'mLayout',
  // SEO优化
  head () {
    return {
      title: '标题',
      meta: [
        {
          name: 'keywords',
          content: '很多个很多个关键词很多个很多个关键词很多个很多个关键词'
        }
      ]
    }
  }
}
</script>

马克Eslint的一个小坑

在Nuxt项目中,个人出现了Eslint抽风的情况,报了诸如 Attribute "for" should be on a new line vue/max-attributes-per-line 的error,并且eslint不能正确地格式化代码。

解决

修改 .eslintrc.js 文件的配置,在 rules 中加上以下配置,就不会报错了。

'vue/max-attributes-per-line': [
  2,
  {
    singleline: 1,
    multiline: {
      max: 1,
      allowFirstLine: true
    }
  }
]



上一篇:vue 答案


下一篇:安全,轻松的Axios与Nuxt.js集成