Vue实战笔记(一) 引入Ant Design

Ant Design 是一个很好用的前端组件库，里面包含有很多基础组件，能极大提高我们的开发效率

下面先贴出官方文档，里面的介绍已经十分全面和详细，大家遇到的很多问题都可以在上面找到答案

假设现在我们已经用 vue-cli 3 工具创建了一个 Vue 项目，然后怎么在项目中引入 Ant Design 呢？

首先介绍一下 vue-cli 3 默认生成的目录结构，关于 vue-cli 3 的具体使用可以参考我的另一篇文章

+ demo+ node_modules（存放第三方模块）+ public（存放静态文件）- favicon.ico（图标）- index.html （页面模板）+ src（我们自己写的文件一般放在这个文件夹下）+ assets（存放资源文件）+ components（存放公共组件）+ router.js（路由管理：Router）+ store.js （状态管理：Vuex）+ views（存放视图组件）- App.vue（页面入口文件）- main.js（程序入口文件）- package.json（项目配置文件）- package-lock.json（项目配置文件）- babel.config.js（babel 配置文件）- README.md（项目说明文档）- ...（其它配置文件）

1、安装 Ant Design

npm 是 Node 的包管理工具，我们可以通过 npm 安装 Ant Design

加上 --save 选项，可以同时将配置写入 package.json 的 dependencies 字段（生产环境依赖）

npm install --save ant-design-vue

2、引入 Ant Design

在 Vue 中引入 Ant Design 有两种方式，分别是全部引入和局部引入，下面将会逐一介绍

（1）全部引入

在 main.js 中引入并注册全部组件，即可在其它页面中直接使用全部组件

// main.jsimport Vue from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'// 新增代码：引入全部组件及样式
import Antd from 'ant-design-vue'
import 'ant-design-vue/dist/antd.css'// 新增代码：注册全部组件
Vue.use(Antd)new Vue({router,store,render: h => h(App)
}).$mount('#app')

采用这种引入方式，不管是否使用到的组件，都会全部加载进来，显然不是一个好的办法

（2）局部引入

在 main.js 中引入并注册特定组件，在其它页面中只可使用特定组件

// main.jsimport Vue from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'// 新增代码：引入特定组件及样式
import {Button
} from 'ant-design-vue'
import 'ant-design-vue/lib/button/style'// 新增代码：注册特定组件
Vue.component(Button.name, Button)new Vue({router,store,render: h => h(App)
}).$mount('#app')

采用这种引入方式，可以保证只引入需要的组件（按需引入）

但每引入一个组件，都要手动将其对应的样式文件同时引入，未免过于麻烦

babel-plugin-import 插件可以辅助完成这个工作，首先安装 babel-plugin-import 插件

加上 --save-dev 选项，同时将配置写入 package.json 的 devDependencies 字段（开发环境依赖）

npm install --save-dev babel-plugin-import

然后在 babel.config.js 配置插件

module.exports = {presets: ['@vue/cli-plugin-babel/preset'],// 新增代码plugins: [['import',{ libraryName: 'ant-design-vue', libraryDirectory: 'es', style: true }]]
}

接着在 main.js 按需引入组件

// main.jsimport Vue from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'// 新增代码：引入特定组件
// 此时会自动引入对应的样式文件，无需再手动逐一引入
import {Button
} from 'ant-design-vue'// 新增代码：注册特定组件
Vue.component(Button.name, Button)new Vue({router,store,render: h => h(App)
}).$mount('#app')

最后记得使用 npm run serve 重启应用，即可在其它页面中使用特定组件

注意，如果你在使用 vue-cli 3 创建项目时配置了 Less，那么你在运行应用时可能会出现以下错误：

Inline JavaScript is not enabled. Is it set in your options?

这是因为 Webpack 对于 Less-loader 的默认配置不合适所导致的，所以我们需要修改一下配置

在根目录下的项目配置文件 vue.config.js 中添加以下配置项（如果没有这个文件，就自己创建一个）

module.exports = {css: {loaderOptions: {less: {javascriptEnabled: true}}}
}

3、使用 Ant Design

在安装和引入 Ant Design 后，我们就可以在页面使用 Ant Design 中的组件啦

<template><div><a-button type="primary" @click="handleClick">Primary</a-button></div>
</template><script>
export default {methods: {handleClick: function (e) {console.log('click', e)}}
}
</script>

这时，如果你能看到一个蓝色的按钮出现在页面上，就说明已经配置成功

接下来就可以尽情享受 Ant Design 带给你的高效开发体验