logo
搜索
我的图书馆

发文章

发文工具

其他工具

留言交流
搜索
分享

ElementUI快速入门

 15所 2019-10-30

本文主要从几个方面快速入门ElementUI

1、什么是ElementUI ？ 掌握elementUI脚手架搭建

2、掌握elementUI的table组件的使用，实现列表功能

3、掌握elementUI的pagination组件的使用，实现分页功能

4、掌握elementUI的form相关组件的使用，实现条件查询功能

5、掌握elementUI的dialog组件和$message的使用，实现弹出窗口和消息提示功能

6、掌握elementUI的select组件的使用，实现下拉列表功能实现新增数据和修改数据的功能

7、掌握confirm的使用，实现询问框，实现删除功能

1、什么是ElementUI？

Element 饿了么前端出品的一套 基于 Vue 2.0 的桌面端组件库

官网: http://element./#/zh-CN

1.1、搭建elementUI脚手架(vue-admin-template)

  1. # Clone project
  2. git clone https://github.com/PanJiaChen/vue-admin-template.git
  4. # Install dependencies
  5. npm install
  7. # Serve with hot reload at localhost:9528
  8. npm run dev
  10. # Build for production with minification
  11. npm run build
  13. # Build for production and view the bundle analyzer report
  14. npm run build --report

在执行完npm run dev后发现浏览器自动打开了vue-admin-template登录页面，点击登录，此时模板页面就搭建好了。

打开文件夹vue-admin-template，主要的目录结构如下图所示：

1.2 项目初始化调整

1.2.1  关闭语法规范性检查

修改config/index.js ，将useEslint的值改为false。

此配置作用: 是否开启语法检查，语法检查是通过ESLint 来实现的。

我们现在科普一下,什么是ESLint : ESLint 是一个语法规则和代码风格的检查工具，可以用来保证写出语法正确、风格统一的代码。如果我们开启了Eslint , 也就意味着要接受它非常苛刻的语法检查，包括空格不能少些或多些，必须单引不能双引，语句后不可以写 分号等等，这些规则其实是可以设置的。作为初学者，最好先关闭这种校验，否则会浪费很多精力在语法的规范性上。如果以后做真正的企业级开发，建议开启。

1.2.2  国际化设置

打开main.js 找到这句代码

import locale from 'element‐ui/lib/locale/lang/en'

我们将en修改为zn-CN
import locale from 'element‐ui/lib/locale/lang/zh‐CN'

修改后组件都是按照中文的习惯展示

1.2.3  与easy-mock对接

(1)修改config下的dev.env.js中的BASE_API为easy-mock的Base URL

  1. ....
  2. BASE_API: ''http://10.211.5.3:7300/mock/5af314a4c612420d0d7650c7'',
  3. ....

修改后发现无法登录上vue-admin-templates，原因是修改了BASE_API，需要在自己的Easy-mock中修改验证

(2)easy-mock添加登陆认证模拟数据 地址: /user/login
提交方式:post
内容:

  1. {
  2. 'code': 20000,
  3. 'data': {
  4. 'roles': ['admin'],
  5. 'role': ['admin'],
  6. 'name': 'admin',
  7. 'avatar': 'https://wpimg./f778738c‐e4f8‐4870‐b634‐56703b4acafe.gif'
  8. }
  9. }

(3)添加返回用户信息url模拟数据 地址:/user/info
提交方式:get
内容:

  1. {
  2. 'code': 20000,
  3. 'data': {
  4. 'roles': ['admin'],
  5. 'role': ['admin'],
  6. 'name': 'admin',
  7. 'avatar': 'https://wpimg./f778738c‐e4f8‐4870‐b634‐56703b4acafe.gif'
  8. }
  9. }

此时又可以登录上vue-admin-template，且成功与自己的easy-mock对接上了。

2.elementUI的table组件,实现列表展示

(1)在src/api/下创建gathering.js，书写代码：

  1. import request from '@/utils/request'
  2. export default{
  3. getList(){
  4. return request(
  5. {
  6. url:'/gathering/gathering',
  7. method:'get'
  8. }
  9. );
  10. }
  11. }

导入request模块实际上是对ajax的封装(在utils/request.js中)，上述的url和method即为请求的url和method

(2)在views/table中创建 gathering.vue

vue主要分为视图区<template>、逻辑区/代码区<script>(用于控制视图区的显示)

  1. <template>
  2. <el-table :data='list' border style='width: 100%'>
  3. <el-table-column prop='id' label='活动ID' width='180'>
  4. </el-table-column>
  5. <el-table-column prop='name' label='活动名称' width='180'>
  6. </el-table-column>
  7. <el-table-column prop='sponsor' label='主办方' width='180'>
  8. </el-table-column>
  9. <el-table-column prop='address' label='活动地址' width='180'>
  10. </el-table-column>
  11. <el-table-column prop='starttime' label='开始日期' width='180'>
  12. </el-table-column>
  13. <el-table-column prop='endtime' label='结束日期' width='180'>
  14. </el-table-column>
  15. </el-table>
  16. </template>
  18. <script>
  19. //将我们刚才书写的gathering.js导入到该vue中,并声明其作为变量gatheringApi
  20. import gatheringApi from '@/api/gathering'
  21. export default {
  22. data() {
  23. return {
  24. list: []
  25. }
  26. },
  27. created() {
  28. this.fetchData()
  29. },
  30. methods: {
  31. fetchData() {
  32. gatheringApi.getList().then(response => {
  33. this.list = response.data
  34. })
  35. }
  36. }
  37. }
  38. </script>

(3)修改router/index.js中的path和import('@/views/table/gathering')  其中path为访问路径，import为views文件夹中的table文件夹中的gathering.vue文件

  1. {
  2. path: '/gathering',
  3. component: Layout,
  4. children: [
  5. {
  6. path: 'index',
  7. name: 'Form',
  8. component: () => import('@/views/table/gathering'),
  9. meta: { title: '活动管理', icon: 'form' }
  10. }
  11. ]
  12. }

(4)reload工程 ：   npm run dev

(5)plus：如果此时你在开发者工具中能正常接收数据，但是无法显示，考虑easy-mock中的接口设置，返回值是否为20000等。

  1. {
  2. 'code': 20000,
  3. 'flag': true,
  4. 'message': '@string',
  5. 'data|10': [{
  6. 'id': '@string',
  7. 'name': '@cword(8,12)',
  8. 'summary': '@cword(20,40)',
  9. 'detail': '@cword(20,40)',
  10. 'sponsor': '@string',
  11. 'image': '@image',
  12. 'starttime': '@date',
  13. 'endtime': '@date',
  14. 'address': '@county(true)',
  15. 'enrolltime': '@date',
  16. 'state': '@string',
  17. 'city': '@string'
  18. }]
  19. }

3.使用pagination实现分页

我们已经通过表格组件完成了列表的展示，接下来需要使用分页组件完成分页功能

一般对于分页，都需要前端传递给后端两个参数：①当前页码   ②每页显示条数

由于笔者项目中用到了Easy Mock，所以我们第一步应该修改Easy Mock中的接口，产生更真实的模拟数据

(1)修改接口/gathering/gathering/search/{page}/{size} method:POST

(2)在gathering.js中添加新方法search，page当前页码，size每页显示条数，searchMap查询条件

参考返回数据结构：

  1. <script>
  2. import gatheringApi from '@/api/gathering'
  3. export default {
  4. data() {
  5. return {
  6. total: 0 , //总记录数
  7. list: [],
  8. currentPage: 1, //初始值为1
  9. pageSize: 10, //每页显示条数
  10. searchMap: {} //查询条件
  11. }
  12. },
  13. created() {
  14. this.fetchData()
  15. },
  16. methods: {
  17. fetchData() {
  18. gatheringApi.search(this.currentPage,this.pageSize,this.searchMap).then(response => {
  19. this.list = response.data.rows
  20. this.total = response.data.total
  21. })
  22. }
  23. }
  24. }
  25. </script>

此时js部分(逻辑处理层)我们已经完成，参考官方文档完成分页组件UI层：

http://element-cn./#/zh-CN/component/pagination

plus：@代表调用的方法，当每页显示个数和当前页码改变时会调用方法fetchData，:name代表属性

  1. <el-pagination
  2. @size-change='fetchData'
  3. @current-change='fetchData'
  4. :current-page='currentPage'
  5. :page-sizes='[5, 10, 20]'
  6. :page-size='10'
  7. layout='total, sizes, prev, pager, next, jumper'
  8. :total='total'>
  9. </el-pagination>

plus：如果加入该<el-pagination>到<template>中报错，考虑在<template>下添加一个<div>标签，因为<template>下只能有一个标签加入后即只有一个<div>标签，否则将存在<el-table>标签和<el-pagination>标签，故报错。

4. 使用分页+条件查询

需求:在分页列表的基础上实现条件查询功能【使用到了表单控件、文本输入控件、日期输入控件、行内表单等】

总体template代码:

  1. <template>
  2. <div>
  3. <br/>
  4. <el-form :inline='true'>
  5. <el-form-item label='活动名称'>
  6. <el-input v-model='searchMap.name'></el-input>
  7. </el-form-item>
  8. <el-form-item label='活动日期'>
  9. <el-date-picker v-model='searchMap.starttime_1' type='date' placeholder='选择开始日期'>
  10. </el-date-picker>
  11. <el-date-picker v-model='searchMap.starttime_2' type='date' placeholder='选择结束日期'>
  12. </el-date-picker>
  13. </el-form-item>
  14. <el-button @click='fetchData()' type='primary'>查询</el-button>
  15. </el-form>
  17. ......
  19. </div>
  20. </template>

5-6. 弹出窗口、消息提示、select下拉框

需求：界面中加入'新增'按钮，点击弹出编辑窗口，点击“修改”按钮，关闭窗口并刷新表格，弹出提示(成功或失败)

涉及知识点：dialog组件、$message、switch开关、textarea文本域、form表单、select下拉框等

参考官方文档：http://element-cn./#/zh-CN/component/dialog      (如何调出窗口并关闭窗口)

plus：注意！需要在return内部声明一个实体对象，用于存储表单数据 ，如：renturn{ pojo:{} }

(省略了一部分代码)新增city.js，并导出(参考gathering.js)。在gathering.vue中导入city，并在打开视图时就加载城市：

  1. created() {
  2. this.fetchData()
  3. cityApi.getList().then(response => {
  4. this.cityList = response.data
  5. })
  6. }

不要忘记在return中加入city这个实体对象，否则为空报错。如return{ cityList:[] }

<template>视图层代码：

  1. <el-dialog title='编辑' :visible.sync='dialogFormVisible'>
  2. <el-form :model='form' label-width='100px'>
  3. <el-form-item label='活动名称' :label-width='formLabelWidth'>
  4. <el-input v-model='pojo.name' placeholder='活动名称'></el-input>
  5. </el-form-item>
  6. <el-form-item label='基本地址' :label-width='formLabelWidth'>
  7. <el-input v-model='pojo.address' placeholder='基本地址'></el-input>
  8. </el-form-item>
  9. <el-form-item label='开始日期' :label-width='formLabelWidth'>
  10. <el-date-picker v-model='pojo.starttime' type='date' placeholder='选择开始日期'>
  11. </el-date-picker>
  12. </el-form-item>
  13. <el-form-item label='截至日期' :label-width='formLabelWidth'>
  14. <el-date-picker v-model='pojo.endtime' type='date' placeholder='选择截至日期'>
  15. </el-date-picker>
  16. </el-form-item>
  17. <el-form-item label='报名截止' :label-width='formLabelWidth'>
  18. <el-date-picker v-model='pojo.enrolltime' type='date' placeholder='选择截至日期'>
  19. </el-date-picker>
  20. </el-form-item>
  21. <el-form-item label='活动详情' :label-width='formLabelWidth'>
  22. <el-input v-model='pojo.detail' type='textarea' :rows='3' placeholder='请输入内容'></el-input>
  23. </el-form-item>
  24. <el-form-item label='选择城市'>
  25. <el-select v-model='pojo.city' placeholder='请选择城市'>
  26. <el-option v-for='item in cityList' :key='item.value' :label='item.name' :value='item.id'>
  27. </el-option>
  28. </el-select>
  29. </el-form-item>
  30. <el-form-item label='是否可见'>
  31. <el-switch v-model='pojo.status' active-value='1' inactive-value='0' ></el-switch>
  32. </el-form-item>
  33. <el-form-item>
  34. <el-button type='primary'>保存</el-button>
  35. <el-button type='primary' @click='dialogFormVisible = false'>关闭</el-button>
  36. </el-form-item>
  37. </el-form>
  38. </el-dialog>

当我们点击保存按钮的时候，则触发几个动作：①弹出消息提示框(消息内容来自于响应体中的message)  ②判断消息状态是否为true，为true则刷新列表(调用之前的刷新列表方法)  ③关闭窗口(设置dialogVisible = false)，主要代码如下：

  1. <template>
  2. ...
  3. <el-form-item>
  4. <el-button type='primary' @click='handlerSave()'>保存</el-button>
  5. <el-button type='primary' @click='dialogFormVisible = false'>关闭</el-button>
  6. </el-form-item>
  7. ...
  8. </template>
  10. <script>
  11. ...
  12. methods:{
  13. handlerSave(){
  14. gatheringApi.save(this.pojo).then(response => {
  15. alert(response.message)
  16. if(response.flag){         //如果成功
  17. this.fetchData();        //刷新列表
  18. }
  19. })
  20. this.dialogFormVisible=false //关闭窗口
  21. }
  22. }
  23. ...
  24. </script>

7、在列表显示页面右侧执行修改操作

需求：在表格的操作列增加'修改'按钮，点击修改按钮弹出窗口并显示数据，点击保存按钮保存 修改并刷新表格。

需求分析：在点击修改按钮时候，首先需要打开窗口(修改dialogVisible = true)，其次获取点击的数据行id，根据该id查询数据并回显，在点击保存按钮时候，执行上面所讲的保存操作。

由于我们使用Easy-Mock模拟数据，我们首先需要修改根据id查询数据的接口

(1)修改easymock接口/gathering/gathering/{id} (GET)

(2)修改src/api/gathering.js，增加方法定义

  1. findById(id) {
  2. return request({
  3. url: `/gathering/gathering/${id}`,
  4. method: 'get'
  5. })
  6. }

(3)修改src/views/table/gathering.vue的js脚本部分,新增handleEdit()方法

  1. handleEdit(id){
  2. this.dialogFormVisible=true  //打开窗口
  3. gatheringApi.findById(id).then(response=>{
  4. if(response.flag){
  5. this.pojo=response.data
  6. }
  7. })
  8. }

(4)在表格table中增加模板列 ,模板列中防止修改按钮，调用handleEdit方法

  1. <el-table-column
  2. label='操作'
  3. width='100'>
  4. <template slot-scope='scope'>
  5. <el-button @click='handleEdit(scope.row.id)' type='text' size='small'>修改</el-button>
  6. </template>
  7. </el-table-column>

fixed='right'的作用是定义此列为右固定列slot-scope用于指定当前行的上下文。 

使用scope.row可以获取行对象，此处我们需要获得当前行的id，故使用scope.row.id

    本站是提供个人知识管理的网络存储空间，所有内容均由用户发布，不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息，谨防诈骗。如发现有害或侵权内容，请点击一键举报。
    转藏 分享 献花（0）

    来自： 15所 > 《待分类》

    举报/认领

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多