如何封装Vue Element的table表格组件
作者:豫见陈公子
在封装Vue组件时,我依旧会交叉使用函数式组件的方式来实现。关于函数式组件,我们可以把它想像成组件里的一个函数,入参是渲染上下文(render context),返回值是渲染好的HTML(VNode)。它比较适用于外层组件仅仅是对内层组件的一次逻辑封装,而渲染的模板结构变化扩展不多的情况,且它一定是无状态、无实例的,无状态就意味着它没有created、mounted、updated等Vue的生命周期函数,无实例就意味着它没有响应式数据data和this上下文。
我们先来一个简单的Vue函数式组件的例子吧,然后照着这个例子来详细介绍一下。
export default { functional: true, props: {}, render(createElement, context) { return createElement('span', 'hello world') } }
Vue提供了一个functional开关,设置为true后,就可以让组件变为无状态、无实例的函数式组件。因为只是函数,所以渲染的开销相对来说较小。
函数式组件中的Render函数,提供了两个参数createElement和context,我们先来了解下第一个参数createElement。
createElement说白了就是用来创建虚拟DOM节点VNode的。它接收三个参数,第一个参数可以是DOM节点字符串,也可以是一个Vue组件,还可以是一个返回字符串或Vue组件的函数;第二个参数是一个对象,这个参数是可选的,定义了渲染组件所需的参数;第三个参数是子级虚拟节点,可以是一个由createElement函数创建的组件,也可以是一个普通的字符串如:'hello world',还可以是一个数组,当然也可以是一个返回字符串或Vue组件的函数。
createElement有几点需要注意:
- createElement第一个参数若是组件,则第三个参数可省略,即使写上去也无效;
- render函数在on事件中可监听组件$emit发出的事件
- 在2.3.0之前的版本中,如果一个函数式组件想要接收prop,则props选项是必须的。在2.3.0或以上的版本中,你可以省略props选项,组件上所有的attribute都会被自动隐式解析为prop。
函数式组件中Render的第二个参数是context上下文,data、props、slots、children以及parent都可以通过context来访问。
在2.5.0及以上版本中,如果你使用了单文件组件,那么基于模板的函数式组件可以这样声明:<template functional></template>, 但是如果Vue组件中的render函数存在,则Vue构造函数不会从template选项或通过el选项指定的挂载元素中提取出的HTML模板编译渲染函数,也就是说一个组件中templete和render函数不能共存,如果一个组件中有了templete,即使有了render函数,render函数也不会执行,因为template选项的优先级比render选项的优先级高。
到这里,Vue函数式组件介绍的就差不多了,我们就来看看Element的表格组件是如何通过函数式组件来实现封装的吧。
效果图:
1、所封装的table组件:
<template> <div> <el-table :data="cfg.data" style="width: 100%" v-on="cfg.on" v-bind="attrs" v-loading="loading"> <el-table-column v-if="cfg.hasCheckbox" v-bind="selectionAttrs" type="selection" width="55" label="xx" /> <el-table-column v-for="n in cfg.headers" :prop="n.prop" :label="n.label" :key="n.prop" v-bind="{...columnAttrs, ...n.attrs}"> <template slot-scope="{row}"> <slot :name="n.prop" :row="row"><Cell :config="n" :data="row" /></slot> </template> </el-table-column> </el-table> <el-pagination class="pagination" v-if="showPage" layout="total, sizes, prev, pager, next, jumper" :page-sizes="[2, 3, 6, 11]" :page-size="page.size" :total="page.total" :current-page="page.page" @current-change="loadPage" @size-change="sizeChange" /> </div> </template> <script> import Cell from './cell' export default { components: { Cell, }, props: { config: Object, }, data(){ return { loading: true, columnAttrs: { align: 'left', resizable: false, }, cfg: { on: this.getTableEvents(), attrs: { border: true, stripe: true, }, data: [], ...this.config, }, page: { size: this.config.size || 10, page: 1, total: 0, }, checked: [], } }, created(){ this.load(); }, computed: { selectionAttrs(){ let {selectable, reserveSelection = false} = this.config || {}, obj = {}; // checkBox是否可以被选中 if(selectable && typeof selectable == 'function'){ Object.assign(obj, { selectable, }) } //reserve-selection仅对type=selection的列有效,类型为Boolean,为true则会在数据更新之后保留之前选中的数据(需指定 row-key) if(reserveSelection){ Object.assign(obj, { 'reserve-selection': reserveSelection, }) } return obj; }, attrs(){ let {config: {spanMethod, rowKey}, cfg: {attrs}} = this; // 合并单元格 - spanMethod是父组件传过来的合并单元格的方法,请参照element合并单元格 if(spanMethod && typeof spanMethod == 'function'){ Object.assign(attrs, { 'span-method': spanMethod, }) } // 表格跨页选中,需要设置row-key和reserve-selection,reserve-selection只能且必须设置在type为selection的el-table-column上 if(rowKey && typeof rowKey == 'function'){ Object.assign(attrs, { 'row-key': rowKey, }) } return attrs; }, showPage(){ let {size, total} = this.page; return size < total; }, }, methods: { getTableEvents(){ let {hasCheckbox = false} = this.config || {}, events = {}, _this = this; if(hasCheckbox){ // 绑定事件 Object.assign(events, { 'selection-change'(v){ _this.checked = v; }, }); } return events; }, // 获取勾选的行 getChecked(){ return this.checked; }, // 请求数据 load(p = {}){ let { size, page } = this.page, {loadData = () => Promise.resolve({})} = this.config; this.loading = true; // 这里loadData的参数在初始化时只有分页所需的page和size,至于接口需要的其他参数,是在父组件的loadData中传递 loadData({...p, page, size}).then(({data, total}) => { this.cfg.data = data; this.page.page = page; this.page.total = total; this.loading = false; }); }, loadPage(index){ this.page.page = index this.load(); }, sizeChange(size){ this.page.size = size this.load(); }, // 一般在点击查询按钮或局部刷新表格列表时,可调用此方法,如果不传参数,则默认从第一页开始 reload(p = {}){ this.page.page = 1 this.load(p); }, }, } </script>
2、汇总表格每一列的cell.js:
import * as Components from './components'; let empty = '-' export default { props: { config: Object, data: Object, }, functional: true, render: (h, c) => { let {props: {config = {}, data = {}}} = c, {prop, type = 'Default'} = config, value = data[prop] || config.value, isEmpty = value === '' || value === undefined; return isEmpty ? h(Components.Default, {props: {value: empty}}) : h(Components[type], {props: {value, empty, data, ...config}}); } }
3、本次封装将每一列的渲染单独分开成多个vue组件,最后再合并在一个components.js文件中一起进行匹配。
1)整合文件components.js:
import Date from './Date'; import Default from './Default'; import Currency from './Currency'; import Enum from './Enum'; import Action from './Action'; import Link from './Link'; import Format from './Format'; import Popover from './Popover'; export { Default, Date, Currency, Enum, Action, Link, Format, Popover, }
2)日期列Date.vue
<template functional> <span>{{props.value | date(props.format)}}</span> </template>
3)默认列Default.vue
<template functional> <span>{{props.value}}</span> </template>
4)金额千分位列Currency.vue
<template functional> <span>{{props.value | currency}}</span> </template>
5)映射列Enum.js
let mapIdAndKey = list => list.reduce((c, i) => ({...c, [i.key]: i}), {}); let STATUS = { order: mapIdAndKey([ { id: 'draft', key: 'CREATED', val: '未提交', }, { id: 'pending', key: 'IN_APPROVAL', val: '审批中', }, { id: 'reject', key: 'REJECT', val: '审批驳回', }, { id: 'refuse', key: 'REFUSE', val: '审批拒绝', }, { id: 'sign', key: 'CONTRACT_IN_SIGN', val: '合同签署中', }, { id: 'signDone', key: 'CONTRACT_SIGNED', val: '合同签署成功', }, { id: 'lendDone', key: 'LENDED', val: '放款成功', }, { id: 'lendReject', key: 'LOAN_REJECT', val: '放款驳回', }, { id: 'cancel', key: 'CANCEL', val: '取消成功', }, { id: 'inLend', key: 'IN_LOAN', val: '放款审批中', }, ]), monitor: mapIdAndKey([ { key: '00', val: '未监控', }, { key: '01', val: '监控中', }, ]), } export default { functional: true, render(h, {props: {value, Enum, empty}, parent}){ let enums = Object.assign({}, STATUS, parent.$store.getters.dictionary), {name = '', getVal = (values, v) => values[v]} = Enum, _value = getVal(enums[name], value); if( _value === undefined) return h('span', _value === undefined ? empty : _value); let {id, val} = _value; return h('span', {staticClass: id}, [h('span', val)]); } }
6)操作列Action.js
const getAcitons = (h, value, data) => { let result = value.filter(n => { let {filter = () => true} = n; return filter.call(n, data); }); return result.map(a => h('span', {class: 'btn', on: {click: () => a.click(data)}, key: a.prop}, a.label)) } export default { functional: true, render: (h, {props: {value, data}}) => { return h('div', {class: 'action'}, getAcitons(h, value, data)) }, }
7)带有可跳转链接的列Link.vue
<template> <router-link :to="{ path, query: params }">{{value}}</router-link> </template> <script> export default { props: { data: Object, value: String, query: { type: Function, default: () => { return { path: '', payload: {} } } }, }, computed: { // 路由path path(){ const { path } = this.query(this.data) return path }, params(){ const { payload } = this.query(this.data) return payload }, }, } </script>
8)自定义想要展示的数据格式Format.vue
<template functional> <div v-html="props.format(props.value, props.data)" /> </template>
9)当内容过多需要省略并在鼠标移入后弹出一个提示窗显示全部内容的列Popover.vue
<template functional> <el-popover placement="top-start" width="300" trigger="hover" popper-class="popover" :content="props.value"> <span slot="reference" class="popover-txt">{{props.value}}</span> </el-popover> </template> <style scoped> .popover-txt{ overflow:hidden; text-overflow:ellipsis; white-space:nowrap; display: block; cursor: pointer; } </style>
从以上代码中可以看出,我既使用了基于render函数类型的函数式组件也使用了基于模板的函数式组件,主要是为了在封装时的方便,毕竟使用render这个最接近编译器的函数还是有点麻烦的,不如基于模板的函数式组件来的方便。
4、使用封装后的表格table组件
1)不使用插槽:
<template> <div style="margin: 20px;"> <el-button type="primary" v-if="excelExport" @click="download">获取勾选的表格数据</el-button> <Table :config="config" ref="table" /> </div> </template> <script> import Table from '@/components/table' export default { components: { Table, }, data() { return { config: { headers: [ {prop: 'contractCode', label: '业务编号', attrs: {width: 200, align: 'center'}}, {prop: 'payeeAcctName', label: '收款账户名', type: 'Link', query: row => this.query(row), attrs: {width: 260, align: 'right'}}, {prop: 'tradeAmt', label: '付款金额', type: 'Currency'}, {prop: 'status', label: '操作状态', type: 'Enum', Enum: {name: 'order'}}, {prop: 'statistic', label: '预警统计', type: 'Format', format: val => this.format(val)}, //自定义展示自己想要的数据格式 {prop: 'reason', label: '原因', type: 'Popover'}, {prop: 'payTime', label: '付款时间', type: "Date", format: 'yyyy-MM-dd hh:mm:ss'}, //不设置format的话,日期格式默认为yyyy/MM/dd {prop: 'monitorStatus', label: '当前监控状态', type: 'Enum', Enum: {name: 'monitor'}}, ].concat(this.getActions()), //通过接口获取列表数据 - 这里的参数p就是子组件传过来的包含分页的参数 loadData: p => request.post('permission/list', {...this.setParams(), ...p}), hasCheckbox: true, selectable: this.selectable, reserveSelection: false, rowKey: row => row.id, }, status: "01", permission: ["handle", "pass", "refuse", "reApply", 'export'] } }, computed: { handle() { return this.permission.some(n => n == "handle"); }, pass() { return this.permission.some(n => n == "pass"); }, reject() { return this.permission.some(n => n == "reject"); }, refuse() { return this.permission.some(n => n == "refuse"); }, excelExport(){ return this.permission.some(n => n == "handle") && this.permission.some(n => n == "export"); }, }, methods: { getActions(){ return {prop: 'action', name: '操作', type: "Action", value: [ {label: "查看", click: data => {console.log(data)}}, {label: "办理", click: data => {}, filter: ({status}) => status == 'CREATED' && this.handle}, {label: "通过", click: data => {}, filter: ({status}) => status == 'PASS' && this.pass}, {label: "驳回", click: data => {}, filter: ({status}) => status == 'REJECT' && this.reject}, {label: "拒绝", click: data => {}, filter: ({status}) => status == 'CREATED' && this.refuse}, ]} }, setParams(){ return { name: '测试', status: '01', type: 'CREATED', } }, query(row){ return { path: '/otherElTable', // 路由path payload: { id: row.id, type: 'link' } } }, format(val){ let str = ''; val.forEach(t => { str += '<span style="margin-right:5px;">' + t.total + '</span>'; }) return str; }, selectable({status}){ return status == "REFUSE" ? false : true }, download(){ console.log(this.$refs.table.getChecked()) }, }, }; </script> <style> .action span{margin-right:10px;color:#359C67;cursor: pointer;} </style>
2)使用插槽:
<Table :config="config" ref="table"> <template #statistic="{row}"> <div v-html="loop(row.statistic)"></div> </template> <template #payeeAcctName="{row}"> {{row.payeeAcctName}} </template> <template #tradeAmt="{row}"> {{row.tradeAmt | currency}} </template> <template v-slot:reason="{row}"> <template v-if="!row.reason">-</template> <el-popover v-else placement="top-start" width="300" trigger="hover" popper-class="popover" :content="row.reason"> <span slot="reference" class="popover-txt">{{row.reason}}</span> </el-popover> </template> <template #payTime="{row}"> {{row.payTime | date('yyyy-MM-dd hh:mm:ss')}} </template> <template #customize="{row}"> {{customize(row.customize)}} </template> <template #opt="{row}"> <div class="action"> <span>查看</span> <span v-if="row.status == 'CREATED' && handle">办理</span> <span v-if="row.status == 'PASS' && pass">通过</span> <span v-if="row.status == 'REJECT' && reject">驳回</span> <span v-if="row.status == 'REFUSE' && refuse">拒绝</span> </div> </template> </Table> <script> import Table from '@/components/table' export default { components: { Table, }, data(){ return { config: { headers: [ {prop: 'contractCode', label: '业务编号', attrs: {width: 200, align: 'center'}}, {prop: 'payeeAcctName', label: '收款账户名', attrs: {width: 260, align: 'right'}}, {prop: 'tradeAmt', label: '付款金额'}, {prop: 'status', label: '操作状态', type: 'Enum', Enum: {name: 'order'}}, {prop: 'statistic', label: '预警统计'}, {prop: 'payTime', label: '付款时间'}, {prop: 'reason', label: '原因'}, {prop: 'monitorStatus', label: '当前监控状态', type: 'Enum', Enum: {name: 'monitor'}}, {prop: 'customize', label: '自定义展示', type: 'Format', format: val => this.customize(val)}, {prop: 'opt', label: '操作'}, ], loadData: () => Promise.resolve({ data: [ {id: 1, contractCode: '', payeeAcctName: '中国银行上海分行', tradeAmt: '503869.265', status: '00', payTime: 1593585652530, statistic:[ {level: 3, total: 5}, {level: 2, total: 7}, {level: 1, total: 20}, {level: 0, total: 0} ], customize: ['中国', '上海', '浦东新区'] }, {id: 2, contractCode: 'GLP-YG-B3-1111', payeeAcctName: '中国邮政上海分行', tradeAmt: '78956.85', status: 'CREATED', payTime: 1593416718317, reason: 'Popover的属性与Tooltip很类似,它们都是基于Vue-popper开发的,因此对于重复属性,请参考Tooltip的文档,在此文档中不做详尽解释。', }, {id: 3, contractCode: 'HT1592985730310', payeeAcctName: '招商银行上海支行', tradeAmt: '963587123', status: 'PASS', payTime: 1593420950772, monitorStatus: '01'}, {id: 4, contractCode: 'pi239', payeeAcctName: '广州物流有限公司', tradeAmt: '875123966', status: 'REJECT', payTime: 1593496609363}, {id: 5, contractCode: '0701001', payeeAcctName: '建设银行上海分账', tradeAmt: '125879125', status: 'REFUSE', payTime: 1593585489177}, ], }), }, permission: ["handle", "pass", "refuse", "reApply", 'export'], } }, computed: { handle() { return this.permission.some(n => n == "handle"); }, pass() { return this.permission.some(n => n == "pass"); }, reject() { return this.permission.some(n => n == "reject"); }, refuse() { return this.permission.some(n => n == "refuse"); }, excelExport(){ return this.permission.some(n => n == "handle") && this.permission.some(n => n == "export"); }, }, methods: { query(row){ return { path: '/otherElTable', // 路由path payload: { id: row.id, type: 'link' } } }, loop(val){ if(!val) return '-' let str = ''; val.forEach(t => { str += '<span style="margin-right:5px;">' + t.total + '</span>'; }) return str; }, customize(v){ return v ? v[0] + v[1] + v[2] : '-' } } } </script>
在两个不太相同的使用方式中,第一种是不基于插槽实现的,第二种是基于插槽实现的。通过两种方式的对比,可以看出在第二种使用方式中,但凡是使用了插槽的列,在headers数组中其已经不再定义type字段了,即使定义了type,它也不起作用,起作用的是插槽,而且也不再使用concat去拼接一个操作列了,操作列也是通过插槽来渲染的,只是如果很多列都通过插槽的形式实现,私心觉得页面看起来就不那么整洁了。
多说一句,既然我们已经对大部分场景的实现进行了封装,那么大家在使用时就没必要再通过插槽的形式去多此一举了,尽量保持页面的整洁。如果你实在觉得在headers数组后边再concat一个操作列的方式有点别扭,那么就只需将操作列通过插槽的形式去实现就OK了。本博客中提到的插槽实现形式,只是为了给大家多一种选择而已。
最后,关于金额千分位和时间戳格式化的实现,这里就不再贴代码了,可自行实现。
最近又想了一下封装的这个table组件,想着说在原来封装的基础上还有没有其他的实现方法,比如我不想在原来定义的headers数组后边再concat一个操作列,再比如表格的某一列的数据处理方法不包含在我们之前所封装的那些方法当中,或者说作为第一次使用这个table组件的前端开发人员,我不太习惯你的那种写法,那我可不可以在你封装的基础上自己写一些处理方法呢,答案是可以的,当然我们说既然已经封装好了组件,那么大家就按照一个套路来,省时又省力,何乐而不为呢?但有一说一,我们本着学习的态度,本着艺多不压身的出发点来看的话,多学多思考多动手,总归是有益于进步的。只是在实际的开发过程中,我们尽量要选择一种封装方式,然后大家一起遵守这个约定就好了。
其实说了这么多废话,这次变更也是没有多大力度的,只是在原来封装的基础上增加了插槽而已。看过本篇博客的你一定还记得我封装的代码中有一段专门用来处理每一列数据的代码吧:
<Cell :config="n" :data="row" />
对,就是它。对于它,我不想再多说了,上边已经做了介绍了。本次变更,我们主要用到的是插槽。
插槽这个API,VUE的官网和网上的各种文章介绍已经讲的很清楚了,它大概分为:默认插槽(也有人管它叫匿名插槽)、具名插槽和作用域插槽。关于它们的介绍,请自行查阅官网或网上的各种文章资料。本次变更主要用到的就是具名插槽和作用域插槽。具名插槽,顾名思义就是带有名称的插槽,我们本次封装所使用的插槽的名称来自于table的每一列的prop。作用域插槽在本次封装中的作用主要就是通过子组件的插槽向父组件传值,其实现形式有点类似于vue父组件向子组件传值,只不过两者的接收值的方式不同。总之此次变更实现起来还是很简单的,就是在<Cell :config="n" :data="row" />
的外边再包一层具名插槽就可以了。
<slot :name="n.prop" :row="row"><Cell :config="n" :data="row" /></slot>
就酱。
接下来,我们就可以回答上边我们提出的那些问题了。来看答案:
<Table :config="config" ref="table"> <template #payTime="{row}"> {{row.payTime | date('yyyy-MM-dd hh:mm:ss')}} </template> <template #customize="{row}"> {{customize(row.customize)}} </template> <template #opt="{row}"> <div class="action"> <span>查看</span> <span v-if="row.status == 'CREATED' && handle">办理</span> <span v-if="row.status == 'PASS' && pass">通过</span> <span v-if="row.status == 'REJECT' && reject">驳回</span> <span v-if="row.status == 'REFUSE' && refuse">拒绝</span> </div> </template> </Table>
以上就是对某些特殊情况,而你又不想使用我最开始封装的那些方法来实现,那么可以,我就再为你提供一个其他的“特殊服务”。这里要注意,如果你使用插槽来自己渲染数据,那么在headers数组中,你需要提供表格头部的渲染,而不需要再加入type字段即可。
比如最开始渲染表格的日期列时我们是这么写的:
{prop: 'payTime', label: '付款时间', type: "Date", format: 'yyyy-MM-dd hh:mm:ss'}
那么如果你使用插槽来自己渲染数据,这里的写法就要变成了这样:
{prop: 'payTime', label: '付款时间'}
还有之前我们定义操作列是在headers数组的后边再concat了一个数组,如果你使用插槽来自己渲染数据,那么就不需要再concat一个数组了,而是在headers数组中再加一个{prop: 'opt', label: '操作'}
就可以了。
其实,这次变更说的是在原来的基础上重新包装了一层插槽,那么对于那些不需要我们自行处理数据,只需直接展示接口返回的数据的情况,我们在使用这个封装的table组件时也不需要进行什么特殊处理,更不需要像上边使用插槽那样去定义,只要还是跟之前一样在headers数组中正常定义就可以了。因为插槽嘛,你不定义具名插槽,也不定义默认插槽,那么插槽中显示的就是包裹在插槽标签slot中的<Cell :config="n" :data="row" />
明白了吧。
多说一句,你说我不想使用插槽去处理日期、金额千分位这些列,那么你依旧可以根据上边我介绍的插槽的原理,在headers数组中依旧这样定义就OK了:
{prop: 'tradeAmt', label: '付款金额', type: 'Currency'}, {prop: 'payTime', label: '付款时间', type: "Date"},
写到这里,其实我想说,即使加上了插槽,那么对之前的那些使用方法来说,基本没啥影响,你该怎么用还怎么用,我只是给你提供了更多的选择而已。
如果你实在不想用插槽,想保持页面的整洁,那你在<Cell :config="n" :data="row" />这段代码的外面包裹不包裹一层插槽都无所谓,直接使用上文中我介绍的第一种使用方法就可以了。
作者:小坏
以上就是如何封装Vue Element的table表格组件的详细内容,更多关于封装Vue Element的table表格组件的资料请关注脚本之家其它相关文章!