Vue 2.x 实战之后台管理系统开发
Posted 创业男生
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Vue 2.x 实战之后台管理系统开发相关的知识,希望对你有一定的参考价值。
2. 开发前须知
我的后台管理系统项目运用了如下框架/插件:
- Vue 2.x —— 项目所使用的 js 框架,我所使用的版本是:2.1.10
- vue-router 2 —— Vue 2.x 配套路由,我所使用的版本是:2.3.0
- Element —— UI 框架,饿了么出品,我所使用的版本是:1.2.8
- Echarts —— 图表插件,百度出品,我所使用的版本是:3.4.0
3. 构建项目框架
准备
对于大陆用户,建议将 npm 的注册表源设置为国内的镜像,如 淘宝 NPM 镜像,可以大幅提升安装速度。
运行如下语句即可使用淘宝镜像:
npm install -g cnpm --registry=https://registry.npm.taobao.org
使用方法为:将 npm
改为 cnpm
示例:npm install
=> cnpm install
安装
根据 官方指南 执行如下命令行语句:
# 安装 vue
$ cnpm install vue
# 全局安装 vue-cli,该工具提供开箱即用的构建工具配置
$ cnpm install --global vue-cli
# 创建一个基于 webpack 模板的新项目 my-project(项目名称)
$ vue init webpack my-project
# 进入项目目录
$ cd my-project
# 安装依赖
$ cnpm install
# 运行项目(不需要使用到下载功能时,没有必要使用 cnpm)
$ cnpm run dev
# 或者(效果一样)
$ npm run dev
安装 vue-cli webpack 模板
在
Use ESLint to lint your code? (Y/n)
这一项,如果不打算使用语法检测,可以直接选择n
,如果决定安装但是又暂时不想启用,后文有如何禁用的说明。
这时你的浏览器会自动打开 localhost:8080
页面,说明项目环境搭建成功,我们已经有了一个基于 webpack 模板的项目框架。
模板项目
可能遇到的问题
问题:
运行 npm run dev
后报错:
To use this template, you must update following to modules:
npm: 2.15.1 should be >= 3.0.0
遇到这个问题说明你的 nodejs 版本也不高,因此最好更新 node 版本及 npm 版本。
解决:
- 升级 node 的话直接重新安装一个新版本,安装包 这里 下载。
- 升级 npm 的话可以直接运行命令行语句:
参考:node 安装及 npm 升级方法cnpm install [email protected] -g
项目结构
#
备注项为 webpack 模板内置。##
备注项为按照个人喜好新增的文件夹/文件。
.
├── build/ # webpack config files / webpack 配置文件
│ └── ...
├── config/
│ ├── index.js # main project config / 项目主要配置
│ └── ...
├── src/ # 主要的项目开发文件都在这个目录下:
│ ├── main.js # app entry file / 应用入口文件
│ ├── App.vue # main app component / App 父组件
│ ├── components/ # ui components / 可复用的 ui 组件
│ │ └── ...
│ ├── assets/ # module assets (processed by webpack) / 模块资源(经过 webpack 处理,如文件合并,图片压缩等)
│ │ └── ...
│ ├── page/ ## 以页面为单位的 .vue 文件
│ │ ├── index.vue ## 一级 router-view,顶部导航栏和左侧侧边导航栏
│ │ ├── 404.vue ## 404 页面
│ │ ├── menu1/ ## 二级 router-view,导航切换后的页面内容
│ │ │ └── ...
│ │ └── menu2/ ## 按照菜单项创建文件夹对文件进行组织管理
│ │ └── ...
│ └── router/
│ └── index.js # 路由配置文件
├── static/ # pure static assets (directly copied) / 纯静态资源(直接拷贝使用,不经过 webpack 处理)
├── .babelrc # babel config
├── .eslintrc.js # eslint config
├── .editorconfig # editor config
├── index.html # index.html template
├── package.json # build scripts and dependencies
└── ...
相关文档
官网安装指南
vue-cli
vuejs-templates: webpack
4. 框架/插件使用
可能遇到的问题
问题:
当你随便写了一点代码然后点击保存后,浏览器中会显示如下报错信息:
Eslint 报错
那是因为项目默认开启了 Eslint 功能,代码编写不规范就会报错。
解决:
可以这样禁用 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
直接注释掉相关规则就可以了。
Element
npm 安装 Element:
cnpm i element-ui -S
引入 Element:
官方文档:引入 Element
可以完整引入也可以按需引入,为了项目的大小考虑,还是选择按需引入比较好。
按照官方的使用说明做,就能成功将 Element 引入项目,这里就不照搬文档了。
在根据官方指南安装了 babel-plugin-component 并修改了 .babelrc 文件后,针对 按需引入 的方式举个例子:
#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>
从上面的代码段中可以看出,我们需要引入三个组件:el-dropdown
,el-dropdown-menu
和 el-dropdown-item
。
#2 引入组件
在 main.js 中写入以下内容:
// 引入组件
import { Dropdown, DropdownMenu, DropdownItem } from ‘element-ui‘ // 使用驼峰方式书写组件名即可
// 使用组件
Vue.use(Dropdown)
Vue.use(DropdownMenu)
Vue.use(DropdownItem)
按需引入 Element 组件
完整组件列表以 components.json 为准,也可以查看 项目地址\node_modules\element-ui\lib
目录下的文件(文件名即组件名)。
Echarts
参考文档:在 webpack 中使用 ECharts
npm 安装 ECharts:
cnpm install echarts --save
引入 ECharts:
全部引入:
var echarts = require(‘echarts‘); // 默认使用 require(‘echarts‘) 得到的是已经加载了所有图表和组件的 ECharts 包,因此体积会比较大
// 基于准备好的dom,初始化echarts实例
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‘);
// 引入提示框和标题组件
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){
// 基于准备好的dom,初始化echarts实例
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>
可以按需引入的模块列表见 github.com/ecomfe/echa…
jQuery
有些人可能还无法离开 jQuery 的使用(例如我,不过建议是如果使用了 vue 进行开发,就没有必要使用 jQuery 了),并且也已经习惯了使用 Ajax(目前官方推荐的异步请求库为 Axios,vue-resource 已经停止更新维护)。
要想全局使用 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
相关文档/文章:
ESLint
Element
ECharts
jquery 配置参考
Vue框架引入JS库的正确姿势
原文链接:https://juejin.im/post/58f3799ca22b9d006cfa8d81
以上是关于Vue 2.x 实战之后台管理系统开发的主要内容,如果未能解决你的问题,请参考以下文章
vue+element ui+腾讯云开发打造会员管理系统之实战教程系统登录
「免费开源」基于Vue和Quasar的前端SPA项目crudapi后台管理系统实战之EXCEL数据导入
「免费开源」基于Vue和Quasar的前端SPA项目crudapi后台管理系统实战之文件上传
「免费开源」基于Vue和Quasar前端SPA项目crudapi后台管理系统实战之数据库逆向