基于 element-ui 快速构建 vue 项目

创建工程

注意:命令行都要以管理员模式运行

  1. 创建一个名为 hello-vue 的工程 

    vue init webpack hello-vue

     

     

  2. 安装依赖,我们需要安装 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 为该命令的缩写

  3. 把没有用的初始化东西删掉(与 hello 相关的)

  4. 在 src 目录下创建文件夹 router 及 views

源码目录解释:

  • assets:用于存放资源文件

  • components:用于存放 Vue 功能组件

  • views:用于存放 Vue 视图组件

  • router:用于存放 vue-router 配置

vue 实战,快速上手_ios

创建登陆页面

创建首页视图,在 views 目录下创建一个名为 Main.vue 的视图组件

<template>
    <h1>首页</h1>
</template>
​
<script>
    export default {
        name: "Main"
    }
</script>
​
<style scoped>
​
</style>
​

 

创建登录页视图,在 views 目录下创建一个名为 Login.vue 的视图组件,其中 el-* 的元素为 ElementUI 的组件

vue 实战,快速上手_ios_02vue 实战,快速上手_ios_03

<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>

View Code

 

创建路由,在 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 中各段动态路径也按照某种结构对应嵌套的各层组件,例如:

vue 实战,快速上手_嵌套_04

  1. 用户信息组件,在 views/user 目录下创建 UserProfile.vue 的视图组件

    <template>
        <h1>个人信息</h1>
    </template>
    ​
    <script>
        export default {
            name: "UserProfile"
        }
    </script>
    ​
    <style scoped>
    ​
    </style>

     

  2. 用户列表组件,在 views/user 目录下创建一个名为 UserList.vue 的视图组件

    <template>
        <h1>用户列表页</h1>
    </template>
    ​
    <script>
        export default {
            name: "UserList"
        }
    </script>
    ​
    <style scoped>
    ​
    </style>

     

  3. 配置嵌套路由,修改 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 数组配置,用于在该组件下设置嵌套路由

  4. 修改首页视图,我们修改 Main.vue 视图组件,此处使用了 ElementUI 布局容器组件,代码如下:

    vue 实战,快速上手_ios_02vue 实战,快速上手_ios_03

    <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>

    View Code

     

路由模式与 404

路由模式有两种:

修改路由配置如下:

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 时组件实例

在钩子函数中使用异步请求

  1. 安装 axios 

    npm install --save axios vue-axios

     

  2. main.js 引用 axios

    import axios from 'axios'
    import VueAxios from 'vue-axios'
    ​
    Vue.use(VueAxios, axios)
    ​

     

  3. 在项目中使用 axios

    getData: function () {
      this.axios.get("http://localhost:8080/static/mock/data.json").then(res => {
        console.log(res);
      })
    }