Element UI
官网:https://element.eleme.cn/#/zh-CN
GitHub:https://github.com/ElemeFE/element
1、什么是ElementUI?
Element
饿了么前端出品的一套 基于 Vue 2.0 的桌面端组件库,可用来构建中大型后台管理项目
1.1、搭建elementUI脚手架(vue-admin-template)
# Clone project
git clone https://github.com/PanJiaChen/vue-admin-template.git
# Install dependencies
npm install
# Serve with hot reload at localhost:9528
npm run dev
# Build for production with minification
npm run build
# Build for production and view the bundle analyzer report
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
....
BASE_API: '"http://10.211.5.3:7300/mock/5af314a4c612420d0d7650c7"',
....
修改后发现无法登录上vue-admin-templates,原因是修改了BASE_API,需要在自己的Easy-mock中修改验证
(2) easy-mock添加登陆认证模拟数据 地址: /user/login
提交方式:post
内容:
{
"code": 20000,
"data": {
"roles": ["admin"],
"role": ["admin"],
"name": "admin",
"avatar": "https://wpimg.wallstcn.com/f778738c‐e4f8‐4870‐b634‐56703b4acafe.gif"
}
}
(3) 添加返回用户信息url模拟数据 地址:/user/info
提交方式:get
内容:
{
"code": 20000,
"data": {
"roles": ["admin"],
"role": ["admin"],
"name": "admin",
"avatar": "https://wpimg.wallstcn.com/f778738c‐e4f8‐4870‐b634‐56703b4acafe.gif"
}
}
此时又可以登录上vue-admin-template,且成功与自己的easy-mock对接上了。
2.elementUI的table组件,实现列表展示
(1) 在src/api/下创建gathering.js,书写代码:
import request from '@/utils/request'
export default{
getList(){
return request({
url:'/gathering/gathering',
method:'get'
});
}
}
导入request模块实际上是对ajax的封装(在utils/request.js中),上述的url和method即为请求的url和method
(2) 在views/table中创建 gathering.vue
vue主要分为视图区<template>、逻辑区/代码区<script>(用于控制视图区的显示)
<template>
<el-table :data="list" border style="width: 100%">
<el-table-column prop="id" label="活动ID" width="180"></el-table-column>
<el-table-column prop="name" label="活动名称" width="180"></el-table-column>
<el-table-column prop="sponsor" label="主办方" width="180"></el-table-column>
<el-table-column prop="address" label="活动地址" width="180"></el-table-column>
<el-table-column prop="starttime" label="开始日期" width="180"></el-table-column>
<el-table-column prop="endtime" label="结束日期" width="180"></el-table-column>
</el-table>
</template>
<script>
//将我们刚才书写的gathering.js导入到该vue中,并声明其作为变量gatheringApi
import gatheringApi from '@/api/gathering'
export default {
data() {
return {
list: []
}
},
created() {
this.fetchData()
},
methods: {
fetchData() {
gatheringApi.getList().then(response => {
this.list = response.data
})
}
}
}
</script>
(3) 修改router/index.js中的path和import('@/views/table/gathering') 其中path为访问路径,import为views文件夹中的table文件夹中的gathering.vue文件
{
path: '/gathering',
component: Layout,
children: [{
path: 'index',
name: 'Form',
component: () => import('@/views/table/gathering'),
meta: { title: '活动管理', icon: 'form' }
}]
}
(4) reload工程 : npm run dev
(5) plus:如果此时你在开发者工具中能正常接收数据,但是无法显示,考虑easy-mock中的接口设置,返回值是否为20000等。
{
"code": 20000,
"flag": true,
"message": "@string",
"data|10": [{
"id": "@string",
"name": "@cword(8,12)",
"summary": "@cword(20,40)",
"detail": "@cword(20,40)",
"sponsor": "@string",
"image": "@image",
"starttime": "@date",
"endtime": "@date",
"address": "@county(true)",
"enrolltime": "@date",
"state": "@string",
"city": "@string"
}]
}
3.使用pagination实现分页
我们已经通过表格组件完成了列表的展示,接下来需要使用分页组件完成分页功能
- 一般对于分页,都需要前端传递给后端两个参数:①当前页码 ②每页显示条数
由于笔者项目中用到了Easy Mock,所以我们第一步应该修改Easy Mock中的接口,产生更真实的模拟数据
(1)修改接口/gathering/gathering/search/{page}/{size} method:POST
(2)在gathering.js中添加新方法search,page当前页码,size每页显示条数,searchMap查询条件
参考返回数据结构:
<script>
import gatheringApi from '@/api/gathering'
export default {
data() {
return {
total: 0 , //总记录数
list: [],
currentPage: 1, //初始值为1
pageSize: 10, //每页显示条数
searchMap: {} //查询条件
}
},
created() {
this.fetchData()
},
methods: {
fetchData() {
gatheringApi.search(this.currentPage,this.pageSize,this.searchMap).then(response => {
this.list = response.data.rows
this.total = response.data.total
})
}
}
}
</script>
此时js部分(逻辑处理层)我们已经完成,参考官方文档:完成分页组件UI层
plus:@代表调用的方法,当每页显示个数和当前页码改变时会调用方法fetchData,:name代表属性
<el-pagination
@size-change="fetchData"
@current-change="fetchData"
:current-page="currentPage"
:page-sizes="[5, 10, 20]"
:page-size="10"
layout="total, sizes, prev, pager, next, jumper"
:total="total">
</el-pagination>
plus:如果加入该<el-pagination>到<template>中报错,考虑在<template>下添加一个<div>标签,因为<template>下只能有一个标签加入后即只有一个<div>标签,否则将存在<el-table>标签和<el-pagination>标签,故报错。
4. 使用分页+条件查询
image需求:在分页列表的基础上实现条件查询功能【使用到了表单控件、文本输入控件、日期输入控件、行内表单等】
总体template代码:
<template>
<div>
<br/>
<el-form :inline="true">
<el-form-item label="活动名称">
<el-input v-model="searchMap.name"></el-input>
</el-form-item>
<el-form-item label="活动日期">
<el-date-picker v-model="searchMap.starttime_1" type="date" placeholder="选择开始日期">
</el-date-picker>
<el-date-picker v-model="searchMap.starttime_2" type="date" placeholder="选择结束日期">
</el-date-picker>
</el-form-item>
<el-button @click="fetchData()" type="primary">查询</el-button>
</el-form>
......
</div>
</template>
5-6. 弹出窗口、消息提示、select下拉框
需求:界面中加入"新增"按钮,点击弹出编辑窗口,点击“修改”按钮,关闭窗口并刷新表格,弹出提示(成功或失败)
-
涉及知识点:dialog组件、$message、switch开关、textarea文本域、form表单、select下拉框等
-
参考官方文档:http://element-cn.eleme.io/#/zh-CN/component/dialog (如何调出窗口并关闭窗口)
plus:注意!需要在return内部声明一个实体对象,用于存储表单数据 ,如:renturn{ pojo:{} }
(省略了一部分代码)新增city.js,并导出(参考gathering.js)。在gathering.vue中导入city,并在打开视图时就加载城市:
created() {
this.fetchData()
cityApi.getList().then(response => {
this.cityList = response.data
})
}
不要忘记在return中加入city这个实体对象,否则为空报错。如return{ cityList:[] }
<template>视图层代码:
<el-dialog title="编辑" :visible.sync="dialogFormVisible">
<el-form :model="form" label-width="100px">
<el-form-item label="活动名称" :label-width="formLabelWidth">
<el-input v-model="pojo.name" placeholder="活动名称"></el-input>
</el-form-item>
<el-form-item label="基本地址" :label-width="formLabelWidth">
<el-input v-model="pojo.address" placeholder="基本地址"></el-input>
</el-form-item>
<el-form-item label="开始日期" :label-width="formLabelWidth">
<el-date-picker v-model="pojo.starttime" type="date" placeholder="选择开始日期">
</el-date-picker>
</el-form-item>
<el-form-item label="截至日期" :label-width="formLabelWidth">
<el-date-picker v-model="pojo.endtime" type="date" placeholder="选择截至日期">
</el-date-picker>
</el-form-item>
<el-form-item label="报名截止" :label-width="formLabelWidth">
<el-date-picker v-model="pojo.enrolltime" type="date" placeholder="选择截至日期">
</el-date-picker>
</el-form-item>
<el-form-item label="活动详情" :label-width="formLabelWidth">
<el-input v-model="pojo.detail" type="textarea" :rows="3" placeholder="请输入内容"></el-input>
</el-form-item>
<el-form-item label="选择城市">
<el-select v-model="pojo.city" placeholder="请选择城市">
<el-option v-for="item in cityList" :key="item.value" :label="item.name" :value="item.id">
</el-option>
</el-select>
</el-form-item>
<el-form-item label="是否可见">
<el-switch v-model="pojo.status" active-value="1" inactive-value="0" ></el-switch>
</el-form-item>
<el-form-item>
<el-button type="primary">保存</el-button>
<el-button type="primary" @click="dialogFormVisible = false">关闭</el-button>
</el-form-item>
</el-form>
</el-dialog>
当我们点击保存按钮的时候,则触发几个动作:①弹出消息提示框(消息内容来自于响应体中的message) ②判断消息状态是否为true,为true则刷新列表(调用之前的刷新列表方法) ③关闭窗口(设置dialogVisible = false),主要代码如下:
<template>
...
<el-form-item>
<el-button type="primary" @click="handlerSave()">保存</el-button>
<el-button type="primary" @click="dialogFormVisible = false">关闭</el-button>
</el-form-item>
...
</template>
<script>
...
methods:{
handlerSave(){
gatheringApi.save(this.pojo).then(response => {
alert(response.message)
if(response.flag){ //如果成功
this.fetchData(); //刷新列表
}
})
this.dialogFormVisible=false //关闭窗口
}
}
...
</script>
7、在列表显示页面右侧执行修改操作
需求:在表格的操作列增加"修改"按钮,点击修改按钮弹出窗口并显示数据,点击保存按钮保存 修改并刷新表格。
需求分析:在点击修改按钮时候,首先需要打开窗口(修改dialogVisible = true),其次获取点击的数据行id,根据该id查询数据并回显,在点击保存按钮时候,执行上面所讲的保存操作。
由于我们使用Easy-Mock模拟数据,我们首先需要修改根据id查询数据的
(1)修改easymock接口/gathering/gathering/{id} (GET)
(2)修改src/api/gathering.js,增加方法定义
findById(id) {
return request({
url: `/gathering/gathering/${id}`,
method: 'get'
})
}
(3)修改src/views/table/gathering.vue的js脚本部分,新增handleEdit()方法
handleEdit(id){
this.dialogFormVisible=true //打开窗口
gatheringApi.findById(id).then(response=>{
if(response.flag){
this.pojo=response.data
}
})
}
(4)在表格table中增加模板列 ,模板列中防止修改按钮,调用handleEdit方法
<el-table-column label="操作" width="100">
<template slot-scope="scope">
<el-button @click="handleEdit(scope.row.id)" type="text" size="small">修改</el-button>
</template>
</el-table-column>
- fixed="right"的作用是定义此列为右固定列slot-scope用于指定当前行的上下文。
- 使用scope.row可以获取行对象,此处我们需要获得当前行的id,故使用scope.row.id
iview UI
官网:https://www.iviewui.com/
GitHub:https://github.com/iview/iview
iView
是一套基于Vue.js
的开源UI
组件库,主要服务于PC
界面的中后台产品,比如某产品的运营平台、数据监控平台、管理平台等,从工程配置、到样式布局,甚至后面规划的业务套件,是一整套的解决方案,所以它可能不太适合一些to C
的产品,比如 QQ空间 这类的。
注意:2019年10月起正式将iView更名为View UI
特性
- 丰富的组件和功能,满足绝大部分网站场景
- 提供开箱即用的管理员系统和高阶组件库,极大程度地节省开发成本
- 提供专业,优质的一对一技术支持
- 友好的API,自由灵活地使用空间
- 细致,漂亮的UI
- 事无巨细的文档
- 可自定义主题
因为 iView 目前是在 webpack 下使用的,所以你可以使用 webpack 丰富的插件和个性化配置。iView 也是使用了 ES2015 开发。iView 一个最大的特点,就是我们从使用者和场景出发来设计 API,这点后面会重点讲到。它的文档也是相当详细,每个功能都配有详细说明和实例代码,直接复制就可以使用,我们也计划在明年启动英文文档翻译计划。在开发组件时,我们阅读了很多已有组件库的代码,取长补短,实现代码的高质量。
版本及兼容
目前
iView
可以直接通过npm
安装,很快将发布一个重要版本 0.9.7,在这个版本中,我们对大部分组件的UI
进行了调整和优化,也丰富了很多组件的功能。由于Vue
本身原因(这里不展开),iView
只能兼容到IE9+
,表现最好的是Chrome
、Safari
、Firefox
,有些功能和动画不能在IE
下得到兼容。这也和使用场景有关,一般to B
的产品,我们可以要求客户去使用高级浏览器。
计划
下图为1.x的计划
24栅格系统
iView
借鉴了Bootstrap
和Ant.Design
的栅格系统,支持每行最多容纳 24 列的布局,栅格系统对高级浏览器支持Flex
布局,包括Flex
对齐、Flex
排列、Flex
顺序,也支持栅格的排序、偏移、间隔。友好栅格系统对页面的拆分布局起到了关键作用,你可能不用再写任何布局代码就可以轻松使用栅格完成你的需求,而且它很精准。
事无巨细的文档
iView 在文档编写上也是做到了事无巨细(由于文档用了一套相对重的方案来实现实例和代码的友好分离,故目前没有将文档开源,我们会在明年实现一个更好地提交文档bug及翻译的方案),每个组件的每个功能都有非常详细的说明,包括像哪些参数需要.sync使用,一些隐藏的功能、可能遇到的坑等等,同时每个 demo 都有完整的代码示例,一键复制,粘贴后就可以直接看到效果。API 也按照 props、events、slot 三部分拆分,避免混合说明遗漏和阅读不便利。iView 的文档是目前所有同类文档里最为详细的,也受到了很多开发者的好评,所以我们仍会在文档开发的工作上保持高产出。
高质量,功能丰富
分页组件 Page:
分页组件从功能上借鉴了 Ant.Design,支持智能折叠页码(页码过多时,会左右折叠)、页码快进(点击···会快进或快退5页)、切换每页显示条数、电梯,同时还有迷你模式(支持所以普通模式的功能)和简介模式。
选择器组件 Select
与浏览器原生不同的是,首先 UI 统一而且很好看,这是大部分模拟 select 的主要原因,其次功能更加强大,支持单选、多选,键盘的快捷操作,还支持搜索、自定义模板、分组,以及大中小三种尺寸(iView 很多表单类组件都提供了不同的尺寸),在单选时还可以清空选项。
对比
使用率(npm 平均下载频率,组件数量,star, issue…)
npm 下载次数 以及issue
目前明显未解决bug遗留数量 ,
这个应该跟生态也有关系, 用element 的人多,发现bug 的几率更大,其次是iview 里面有很多issue 写明是UI组件的问题 但未标明是确切的bug
以上对比 其实可以看出, element 开发者团队规模大于iview 团队,其结果就是 无论是提交代码频率, 发布版本数量 都比iview 更强!
截止2017/6/17 最新支持组件对比
(PS 这个是直接看的 官方文档上面的组件列表 ,不代表最后结果)
结论 ,element 生态更好,使用频率远超过iview ,element开发团队实力更强,一些小众组件上各有所长 整体iview 更丰富(时间轴,加载进度条,气泡卡片 ,BackTop,图钉)
API风格
通过使用平率最高的 form table 日历 select 等比较两者
对应代码
明显感觉 iview 的api 更加简洁,在生成类似表格 下拉框这些较复杂的组件时 , iview 的方式类似于antdesign , 好处是直接传数据进去,在内部实现了模板生成,高效 快捷。 而element 则是用到到v-for vue指令结合的方式去生成,批量生成元素。
表格 操作列 自定义渲染的时 ,iview 使用的是 vue的 render 函数, element 直接在template 中插入对应模板
表格分页都需要 引入分页组件 配合使用
日历组件对比
两者api 总体比较 ,iview 要比element 简洁许多。 饿了么更侧重于在template里直接去渲染模板
- 思想上 个人觉得iview偏向react, element 更vue
- 表单校验 两者都使用同一款插件 async-validator 校验方式一样
项目优化角度
首屏优化,第三方组件库依赖过大 会给首屏加载带来很大的压力,一般解决方式是 按需求引入组件element-ui 根据官方说明 现需要引入 babel-plugin-component 插件 做相关配置 然后直接在组件目录 注册全局组件
iview 按需求加载 这里感觉官方给的文档不是很详细
主题
iview
本身提供了一套主题可供选择,除此之外 自定义主题
-
方法一:
官方推荐,前提条件是使用webpack
新建一个.less 文件 , 先在less文件中引入官方样式文件 然后在此基础上复写
-
方法二 :
官方提供了 自动编译工具iview-them 来编译。干的事情就是 把自定义的样式和 github仓库最新的样式 通过工具生成一个新的样式文件。
element-ui
如果只替换颜色 ,可以使用 在线主题生成工具在线编辑颜色, 生成element-ui 主题 直接下载 再引入
-
深度定制主题
官方提供了 主题生成工具 element-them
执行命令 初始化得到一个配置文件 ,修改相关配置 经过编译得到 得到相关主题文件 再通过babel 插件引入
双方都提供了专门的工具用于深度定制主题,综合比较 iview 更加简单,element 主题定制需要配合 babel做一些预编译 ,以及步骤更多 显得更加复杂
过渡动画
- element 有内置过渡动画 使得组件的切换变化 更具动感
- iview 更为中规中矩
对设计人员
- element 提供了 Sketch 和 Axure 工具 对设计人员友好
- iview 没有提供
网友评论