1. 導(dǎo)語
下文:Vue 2.x 實(shí)戰(zhàn)之后臺管理系統(tǒng)開發(fā)(二)
該文章將從頭到尾梳理我是如何使用 Vue 2 開發(fā)一個(gè)后臺管理項(xiàng)目的,我會將自己遇到的問題貼出,希望可以幫助到其他人。
2. 開發(fā)前須知
我的后臺管理系統(tǒng)項(xiàng)目運(yùn)用了如下框架/插件:
- Vue 2.x —— 項(xiàng)目所使用的 js 框架,我所使用的版本是:2.1.10
- vue-router 2 —— Vue 2.x 配套路由,我所使用的版本是:2.3.0
- Element —— UI 框架,餓了么出品,我所使用的版本是:1.2.8
- Echarts —— 圖表插件,百度出品,我所使用的版本是:3.4.0
- 對于所使用的框架/插件,盡可能先快速過一遍文檔,這樣可以知道有什么現(xiàn)成的東西可以使用,避免自己做多余的工作。
3. 構(gòu)建項(xiàng)目框架
準(zhǔn)備
對于大陸用戶,建議將 npm 的注冊表源設(shè)置為國內(nèi)的鏡像,如 淘寶 NPM 鏡像,可以大幅提升安裝速度。
運(yùn)行如下語句即可使用淘寶鏡像:
npm install -g cnpm --registry=https://registry.npm.taobao.org
使用方法為:將 npm 改為 cnpm
示例:npm install => cnpm install
安裝
根據(jù) 官方指南 執(zhí)行如下命令行語句:
# 安裝 vue
$ cnpm install vue
# 全局安裝 vue-cli,該工具提供開箱即用的構(gòu)建工具配置
$ cnpm install --global vue-cli
# 創(chuàng)建一個(gè)基于 webpack 模板的新項(xiàng)目 my-project(項(xiàng)目名稱)
$ vue init webpack my-project
# 進(jìn)入項(xiàng)目目錄
$ cd my-project
# 安裝依賴
$ cnpm install
# 運(yùn)行項(xiàng)目(不需要使用到下載功能時(shí),沒有必要使用 cnpm)
$ cnpm run dev
# 或者(效果一樣)
$ npm run dev

在
Use ESLint to lint your code? (Y/n)這一項(xiàng),如果不打算使用語法檢測,可以直接選擇n,如果決定安裝但是又暫時(shí)不想啟用,后文有如何禁用的說明。
這時(shí)你的瀏覽器會自動打開 localhost:8080 頁面,說明項(xiàng)目環(huán)境搭建成功,我們已經(jīng)有了一個(gè)基于 webpack 模板的項(xiàng)目框架。

可能遇到的問題
問題:
運(yùn)行 npm run dev 后報(bào)錯:
To use this template, you must update following to modules:
npm: 2.15.1 should be >= 3.0.0
遇到這個(gè)問題說明你的 nodejs 版本也不高,因此最好更新 node 版本及 npm 版本。
解決:
- 升級 node 的話直接重新安裝一個(gè)新版本,安裝包 這里 下載。
- 升級 npm 的話可以直接運(yùn)行命令行語句:
cnpm install npm@latest -g
項(xiàng)目結(jié)構(gòu)
#備注項(xiàng)為 webpack 模板內(nèi)置。
##備注項(xiàng)為按照個(gè)人喜好新增的文件夾/文件。
.
├── build/ # webpack config files / webpack 配置文件
│ └── ...
├── config/
│ ├── index.js # main project config / 項(xiàng)目主要配置
│ └── ...
├── src/ # 主要的項(xiàng)目開發(fā)文件都在這個(gè)目錄下:
│ ├── main.js # app entry file / 應(yīng)用入口文件
│ ├── App.vue # main app component / App 父組件
│ ├── components/ # ui components / 可復(fù)用的 ui 組件
│ │ └── ...
│ ├── assets/ # module assets (processed by webpack) / 模塊資源(經(jīng)過 webpack 處理,如文件合并,圖片壓縮等)
│ │ └── ...
│ ├── page/ ## 以頁面為單位的 .vue 文件
│ │ ├── index.vue ## 一級 router-view,頂部導(dǎo)航欄和左側(cè)側(cè)邊導(dǎo)航欄
│ │ ├── 404.vue ## 404 頁面
│ │ ├── menu1/ ## 二級 router-view,導(dǎo)航切換后的頁面內(nèi)容
│ │ │ └── ...
│ │ └── menu2/ ## 按照菜單項(xiàng)創(chuàng)建文件夾對文件進(jìn)行組織管理
│ │ └── ...
│ └── router/
│ └── index.js # 路由配置文件
├── static/ # pure static assets (directly copied) / 純靜態(tài)資源(直接拷貝使用,不經(jīng)過 webpack 處理)
├── .babelrc # babel config
├── .eslintrc.js # eslint config
├── .editorconfig # editor config
├── index.html # index.html template
├── package.json # build scripts and dependencies
└── ...
參考:webpack 模板項(xiàng)目結(jié)構(gòu)
相關(guān)文檔
官網(wǎng)安裝指南
vue-cli
vuejs-templates: webpack
4. 框架/插件使用
可能遇到的問題
問題:
當(dāng)你隨便寫了一點(diǎn)代碼然后點(diǎn)擊保存后,瀏覽器中會顯示如下報(bào)錯信息:

那是因?yàn)轫?xiàng)目默認(rèn)開啟了 Eslint 功能,代碼編寫不規(guī)范就會報(bào)錯。
解決:
可以這樣禁用 Eslint:
build/webpack.base.conf.js
module: {
rules: [
// {
// test: /\.(js|vue)$/,
// loader: 'eslint-loader',
// enforce: "pre",
// include: [resolve('src'), resolve('test')],
// options: {
// formatter: require('eslint-friendly-formatter')
// }
// },
{
test: /\.vue$/,
loader: 'vue-loader',
options: vueLoaderConfig
},
...
]
},

直接注釋掉相關(guān)規(guī)則就可以了。
Element
npm 安裝 Element:
cnpm i element-ui -S
引入 Element:
官方文檔:引入 Element
可以完整引入也可以按需引入,為了項(xiàng)目的大小考慮,還是選擇按需引入比較好。
按照官方的使用說明做,就能成功將 Element 引入項(xiàng)目,這里就不照搬文檔了。
在根據(jù)官方指南安裝了 babel-plugin-component 并修改了 .babelrc 文件后,針對 按需引入 的方式舉個(gè)例子:
#1 拷貝需要使用的組件代碼
<el-dropdown>
<span class="el-dropdown-link">
下拉菜單<i class="el-icon-caret-bottom el-icon--right"></i>
</span>
<el-dropdown-menu slot="dropdown">
<el-dropdown-item>黃金糕</el-dropdown-item>
<el-dropdown-item>獅子頭</el-dropdown-item>
<el-dropdown-item>螺螄粉</el-dropdown-item>
<el-dropdown-item disabled>雙皮奶</el-dropdown-item>
<el-dropdown-item divided>蚵仔煎</el-dropdown-item>
</el-dropdown-menu>
</el-dropdown>
從上面的代碼段中可以看出,我們需要引入三個(gè)組件:el-dropdown,el-dropdown-menu 和 el-dropdown-item。
#2 引入組件
在 main.js 中寫入以下內(nèi)容:
// 引入組件
import { Dropdown, DropdownMenu, DropdownItem } from 'element-ui' // 使用駝峰方式書寫組件名即可
// 使用組件
Vue.use(Dropdown)
Vue.use(DropdownMenu)
Vue.use(DropdownItem)

完整組件列表以 components.json 為準(zhǔn),也可以查看 項(xiàng)目地址\node_modules\element-ui\lib 目錄下的文件(文件名即組件名)。
Echarts
參考文檔:在 webpack 中使用 ECharts
npm 安裝 ECharts:
cnpm install echarts --save
引入 ECharts:
全部引入:
var echarts = require('echarts'); // 默認(rèn)使用 require('echarts') 得到的是已經(jīng)加載了所有圖表和組件的 ECharts 包,因此體積會比較大
// 基于準(zhǔn)備好的dom,初始化echarts實(shí)例
var myChart = echarts.init(document.getElementById('main'));
// 繪制圖表
myChart.setOption({
...
});
按需引入:
echarts-line.vue(基于 echarts 的折線圖組件示例)
<template>
<!--需要唯一的 id 來初始化圖表-->
<div class="echarts-line" :id="id">
</div>
</template>
<script>
// 引入 ECharts 主模塊
var echarts = require('echarts/lib/echarts');
// 引入折線圖
require('echarts/lib/chart/line');
// 引入提示框和標(biāo)題組件
require('echarts/lib/component/tooltip');
require('echarts/lib/component/title');
export default {
name: 'echarts-line',
props: {
id: String
},
mounted(){
this.drawLine(this.id);
},
methods: {
drawLine(id){
// 基于準(zhǔn)備好的dom,初始化echarts實(shí)例
var myChart = echarts.init(document.getElementById(id));
// 繪制圖表
myChart.setOption({
title: { text: 'ECharts 入門示例' },
tooltip: {},
xAxis: {
data: ["襯衫","羊毛衫","雪紡衫","褲子","高跟鞋","襪子"]
},
yAxis: {},
series: [{
name: '銷量',
type: 'bar',
data: [5, 20, 36, 10, 10, 20]
}]
});
}
}
}
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style>
.echarts-line {
width: 100%;
height: 320px;
}
</style>
可以按需引入的模塊列表見 https://github.com/ecomfe/echarts/blob/master/index.js
jQuery
有些人可能還無法離開 jQuery 的使用(例如我,不過建議是如果使用了 vue 進(jìn)行開發(fā),就沒有必要使用 jQuery 了),并且也已經(jīng)習(xí)慣了使用 Ajax(目前官方推薦的異步請求庫為 Axios,vue-resource 已經(jīng)停止更新維護(hù))。
要想全局使用 jQuery 的話,可以這樣做:
#1 下載 jquery 文件
將 jquery 文件放于 static 目錄下,如:static/js/jquery-3.0.0.min.js
#2 webpack 配置文件
build/webpack.base.conf.js
...
var webpack = require("webpack") // 1. 確保引入 webpack,后面會用到
module.exports = {
...
resolve: {
extensions: ['.js', '.vue', '.json'],
modules: [
resolve('src'),
resolve('node_modules')
],
alias: {
'vue$': 'vue/dist/vue.common.js',
'src': resolve('src'),
'assets': resolve('src/assets'),
'components': resolve('src/components'),
"jquery": path.resolve(__dirname, '../static/js/jquery-3.0.0.min.js') // 2. 定義別名和插件位置
}
},
plugins: [
// 3. 配置全局使用 jquery
new webpack.ProvidePlugin({
$: "jquery",
jQuery: "jquery",
jquery: "jquery",
"window.jQuery": "jquery"
})
]
}


相關(guān)文檔/文章:
ESLint
Element
ECharts
jquery 配置參考
Vue框架引入JS庫的正確姿勢
5. 總結(jié)
到此為主,所有準(zhǔn)備工作都做好了,可以盡情地開發(fā)頁面內(nèi)容了。
如果對 Vue 或 vue-router 的使用有所疑問,查看官方文檔基本就能將問題解決了。
有空的時(shí)候我再將其他開發(fā)過程中遇到的問題整理出來。