Vue 2.x 實(shí)戰(zhàn)之后臺管理系統(tǒng)開發(fā)(一)

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)用了如下框架/插件:

  1. Vue 2.x —— 項(xiàng)目所使用的 js 框架,我所使用的版本是:2.1.10
  2. vue-router 2 —— Vue 2.x 配套路由,我所使用的版本是:2.3.0
  3. Element —— UI 框架,餓了么出品,我所使用的版本是:1.2.8
  4. Echarts —— 圖表插件,百度出品,我所使用的版本是:3.4.0
  • 在 UI 框架的選擇上,除了 Element,iView 也不錯,大家可以按需選擇。
  • 對于所使用的框架/插件,盡可能先快速過一遍文檔,這樣可以知道有什么現(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
安裝 vue-cli webpack 模板

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)目框架。

模板項(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

參考:node 安裝及 npm 升級方法

項(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)錯信息:

Eslint 報(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
      },
      ...
    ]
  },
禁用 Eslint

直接注釋掉相關(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-menuel-dropdown-item。

#2 引入組件
在 main.js 中寫入以下內(nèi)容:

// 引入組件
import { Dropdown, DropdownMenu, DropdownItem } from 'element-ui' // 使用駝峰方式書寫組件名即可

// 使用組件
Vue.use(Dropdown)
Vue.use(DropdownMenu)
Vue.use(DropdownItem)
按需引入 Element 組件

完整組件列表以 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"
    })
  ]
}
引入 webpack
配置 jquery

相關(guān)文檔/文章:

ESLint
Element
ECharts
jquery 配置參考
Vue框架引入JS庫的正確姿勢

5. 總結(jié)

到此為主,所有準(zhǔn)備工作都做好了,可以盡情地開發(fā)頁面內(nèi)容了。
如果對 Vuevue-router 的使用有所疑問,查看官方文檔基本就能將問題解決了。
有空的時(shí)候我再將其他開發(fā)過程中遇到的問題整理出來。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容