基于 element-ui 快速构建 vue 项目
创建工程
注意:命令行都要以管理员模式运行
-
创建一个名为 hello-vue 的工程
vue init webpack hello-vue
-
安装依赖,我们需要安装 vue-router、element-ui、sass-loader 和 node-sass 四个插件
# 进入工程目录 cd hello-vue # 安装 vue-router npm install vue-router --save-dev # 安装 element-ui npm i element-ui -S # 安装依赖 npm install # 安装 SASS 加载器 cnpm install sass-loader node-sass --save-dev # 启动测试 npm run dev
npm 命令解释:
-
npm install moduleName:安装模块到项目目录下
-
npm install -g moduleName:-g 的意思是将模块安装到全局,具体安装到那个位置要看 npm config prefix 的位置
-
npm install --save moduleName:--save的意思是将模块安装到项目目录下,并在 package 文件的 dependencies 节点写入依赖,-S 为该命令的缩写
-
npm install --save-dev moduleName:--save-dev 的意思是将模块安装到项目目录下,并在 package 文件的 dependencies 节点写入依赖,-D 为该命令的缩写
-
-
把没有用的初始化东西删掉(与 hello 相关的)
-
在 src 目录下创建文件夹 router 及 views
源码目录解释:
-
assets:用于存放资源文件
-
components:用于存放 Vue 功能组件
-
views:用于存放 Vue 视图组件
-
router:用于存放 vue-router 配置
创建登陆页面
创建首页视图,在 views 目录下创建一个名为 Main.vue 的视图组件
<template> <h1>首页</h1> </template> ? <script> export default { name: "Main" } </script> ? <style scoped> ? </style> ?
创建登录页视图,在 views 目录下创建一个名为 Login.vue 的视图组件,其中 el-* 的元素为 ElementUI 的组件
<template> <div> <el-form ref="loginForm" :model="form" :rules="rules" label-width="80px" class="login-box"> <h3 class="login-title">欢迎登录</h3> <el-form-item label="账号" prop="username"> <el-input type="text" aria-placeholder="请输入账号" v-model="form.username"/> </el-form-item> <el-form-item label="密码" prop="password"> <el-input type="password" aria-placeholder="请输入密码" v-model="form.password"/> </el-form-item> <el-form-item> <el-button type="primary" @click="onSubmit(‘loginForm‘)">登录</el-button> </el-form-item> </el-form> ? <el-dialog title="温馨提示" :visible.sync="dialogVisible" width="30%" :before-close="handleClose"> <span>请输入账号和密码</span> <span slot="footer" class="dialog-footer"> <el-button type="primary" @click="dialogVisible = false">确定</el-button> </span> </el-dialog> </div> </template> ? <script> export default { name: "Login", data() { return { form: { username: ‘‘, password: ‘‘, }, ? //表单验证,需要在 el-form-item 元素中增加 prop 属性 rules: { username: [ {required: true, message: ‘账号不能为空‘, trigger: ‘blur‘} ], password: [ {required: true, message: ‘密码不能为空‘, trigger: ‘blur‘} ] }, ? //对话框显示和隐藏 dialogVisible: false } }, methods: { onSubmit(formName) { //为表单绑定验证功能 this.$refs[formName].validate((valid) => { if (valid) { // 使用 vue-router 路由到指定页面,该方式成为编程式导航 this.$router.push(‘/main‘); } else { this.dialogVisible = true; return false } }); }, handleClose: function () { console.log(‘HandleClose‘, ‘空函数‘); }, } } </script> ? <style lang="scss" scoped> .login-box { border: 1px solid #DCDFE6; width: 350px; margin: 180px auto; padding: 35px 35px 15px 35px; border-radius: 5px; -webkit-border-radius: 5px; -moz-border-radius: 5px; box-shadow: 0 0 25px #909399; } ? .login-title { text-align: center; margin: 0 auto 40px auto; color: #303133; } </style>
创建路由,在 router 目录下创建 index.js
作为 vue-router 路由配置文件
import Vue from "vue"; import VueRouter from "vue-router"; ? import Main from "../views/Main"; import Login from "../views/Login"; ? Vue.use(VueRouter) ? ? export default new VueRouter({ routes: [ { path: ‘/login‘, component: Login }, { path: ‘/main‘, component: Main }, ] })
修改 src 下的 main.js 文件
import Vue from ‘vue‘ import App from ‘./App‘ ? import router from ‘./router‘ ? //导入 elementUI import ElementUI from ‘element-ui‘ import ‘element-ui/lib/theme-chalk/index.css‘ ? Vue.config.productionTip = false ? //安装路由 Vue.use(router) //安装 elementUI Vue.use(ElementUI) ? new Vue({ el: ‘#app‘, router, //启用路由 render: h => h(App) // 启用ElementUI })
修改 App.vue 组件
<template> <div id="app"> <router-view></router-view> </div> </template> ? <script> export default { name: ‘App‘, } </script> ? <style> ? </style>
测试:在浏览器打开 http://localhost:8080/#/login
如果出现错误,可能是因为 sass-loader 的版本过高导致的编译错误,需要回退版本(推荐7.3.1),将 package.json 文件里面的 "sass-loader" 的版本改成 7.3.1 然后重新 cnpm inistall
即可
嵌套路由
嵌套路由又称子路由,在实际应用中,通常由多层嵌套的组件组合而成。同样的,URL 中各段动态路径也按照某种结构对应嵌套的各层组件,例如:
-
用户信息组件,在 views/user 目录下创建 UserProfile.vue 的视图组件
<template> <h1>个人信息</h1> </template> ? <script> export default { name: "UserProfile" } </script> ? <style scoped> ? </style>
-
用户列表组件,在 views/user 目录下创建一个名为 UserList.vue 的视图组件
<template> <h1>用户列表页</h1> </template> ? <script> export default { name: "UserList" } </script> ? <style scoped> ? </style>
-
配置嵌套路由,修改 router 目录下 index.js 路由配置文件,代码如下
import Vue from "vue"; import VueRouter from "vue-router"; ? import Main from "../views/Main"; import Login from "../views/Login"; ? //嵌套路由组件 import UserProfile from "../views/user/UserProfile"; import UserList from "../views/user/UserList"; ? Vue.use(VueRouter) ? ? export default new VueRouter({ routes: [ { //登录页 path: ‘/login‘, component: Login }, { //首页 path: ‘/main‘, component: Main, children: [ //配置嵌套路由 {path: ‘/user/profile‘, component: UserProfile}, {path: ‘/user/list‘, component: UserList}, ] }, ] })
说明:主要在路由配置中增加了 children 数组配置,用于在该组件下设置嵌套路由
-
修改首页视图,我们修改 Main.vue 视图组件,此处使用了 ElementUI 布局容器组件,代码如下:
<template> <div> <el-container> <el-aside width="200px"> <el-menu :default-openeds="[‘1‘]"> <el-submenu index="1"> <template slot="title"><i class="el-icon-caret-right">用户管理</i></template> <el-menu-item-group> <el-menu-item index="1-1"> <router-link to="/user/profile">个人信息</router-link> </el-menu-item> <el-menu-item index="1-2"> <router-link to="/user/list">用户列表</router-link> </el-menu-item> </el-menu-item-group> </el-submenu> <el-submenu index="2"> <template slot="title"><i class="el-icon-caret-right">内容管理</i></template> <el-menu-item-group> <el-menu-item index="2-1">分类管理</el-menu-item> <el-menu-item index="2-2">内容列表</el-menu-item> </el-menu-item-group> </el-submenu> </el-menu> </el-aside> ? <el-container> <el-header style="text-align: right;font-size: 12px"> <el-dropdown> <i class="el-icon-setting" style="margin-right: 15px"></i> <el-dropdown-menu slot="dropdown"> <el-dropdown-item>个人信息</el-dropdown-item> <el-dropdown-item>退出登录</el-dropdown-item> </el-dropdown-menu> </el-dropdown> </el-header> ? <el-main> <router-view/> </el-main> </el-container> </el-container> </div> </template> ? <script> export default { name: "Main" } </script> ? <style lang="scss" scoped> .el-header { background-color: #B3C0D1; color: #333; line-height: 60px; } ? .el-aside { color: #333; } </style>
路由模式与 404
路由模式有两种:
-
hash:路径带 # 符号,如:http://localhost:8080/#/login
-
history:路径不带 # 符号,如:http://localhost:8080/login
修改路由配置如下:
export default new VueRouter({ mode: "history", routes: [...] })
处理 404 ,创建一个名为 NotFound.vue 的视图组件,代码如下:
<template> <div> <h1>404!页面走丢了!</h1> </div> </template> ? <script> export default { name: "NotFound" } </script> ? <style scoped> ? </style>
修改路由配置如下:
import NotFound from "../views/NotFound"; ? export default new VueRouter({ mode: "history", routes: [ ... { name: NotFound, path: ‘*‘, component: NotFound } ] })
路由钩子与异步请求
beforeRouteEnter
:在进入路由前执行
beforeRouteLeave
:在离开路由前执行
<template> <div> <h1>个人信息</h1> </div> </template> ? <script> export default { name: "UserProfile", beforeRouteEnter: (to, from, next) => { console.log("进入路由之前执行") next() }, beforeRouteLeave: (to, from, next) => { console.log("离开路由之前执行") next() } } </script> ? <style scoped> ? </style>
参数说明:
to:路由将要跳转的路径信息
from:路由跳转前的路径信息
next:路由控制参数与
-
next():跳入下一个页面
-
next(‘/path‘):跳转到一个新的路由
-
next(false):返回原来的页面
-
next((vm)=>{}):仅在 beforeRouteEnter 中可用,vm 时组件实例
在钩子函数中使用异步请求
-
安装 axios
npm install --save axios vue-axios
-
main.js
引用 axiosimport axios from ‘axios‘ import VueAxios from ‘vue-axios‘ ? Vue.use(VueAxios, axios) ?
-
在项目中使用 axios
getData: function () { this.axios.get("http://localhost:8080/static/mock/data.json").then(res => { console.log(res); }) }