一般情况下通过表格渲染列表后,经常需要对单元格的内容进行格式化,比如格式化数值、字典转换…等,在 vxe-table 支持的格式化有 n 种,不同场景可以选择最优的方式
直接对源数据进行转换,该方式的性能最优,写法相对冗余
<vxe-table :data="tableData">
<vxe-table-column field="name" title="Name">vxe-table-column>
<vxe-table-column field="amount" title="Amount">vxe-table-column>
<vxe-table-column field="sex" title="Sex">vxe-table-column>
<vxe-table-column field="date" title="Date">vxe-table-column>
vxe-table>
export default {
data () {
tableData: [
{name: 'Test1', amount: 1024.7895, sex: '1', date: '2020-01-01T10:30:20.000+0800'},
{name: 'Test2', amount: 512.056, sex: '0', date: '2020-01-02T08:40:30.000+0800'}
]
},
created () {
this.tableData.forEach(item => {
item.amount = item.amount.toFixed(2)
item.sex = item.sex === '1' ? '男' : '女'
item.date = XEUtils.toDateString(item.date, 'yyyy-dd-MM')
})
}
}
通过 formatter 进行数据转换,可以在不改变数据源的情况下自动转换,仅显示为字符串
<vxe-table :data="tableData">
<vxe-table-column field="name" title="Name">vxe-table-column>
<vxe-table-column field="amount" title="Amount">vxe-table-column>
<vxe-table-column field="sex" title="Sex" :formatter="fotmatSex">vxe-table-column>
<vxe-table-column field="date" title="Date" :formatter="formatDate">vxe-table-column>
vxe-table>
export default {
data () {
tableData: [
{name: 'Test1', amount: 1024.7895, sex: '1', date: '2020-01-01T10:30:20.000+0800'},
{name: 'Test2', amount: 512.056, sex: '0', date: '2020-01-02T08:40:30.000+0800'}
]
},
methods: {
fotmatSex ({ cellValue }) {
return cellValue === '1' ? '男' : '女'
},
formatDate ({ cellValue }) {
return XEUtils.toDateString(cellValue, 'yyyy-dd-MM')
}
}
}
针对以上的缺点,那么如果要自定义 HTML 格式呢,这时就可以用插槽来自定义格式
<vxe-table :data="tableData">
<vxe-table-column field="name" title="Name">vxe-table-column>
<vxe-table-column field="amount" title="Amount">vxe-table-column>
<vxe-table-column field="sex" title="Sex">
<template v-slot="{ row }">
<span style="color: red">{{ row.sex === '1' ? '男' : '女' }}span>
template>
vxe-table-column>
<vxe-table-column field="date" title="Date">vxe-table-column>
vxe-table>
export default {
data () {
tableData: [
{name: 'Test1', amount: 1024.7895, sex: '1', date: '2020-01-01T10:30:20.000+0800'},
{name: 'Test2', amount: 512.056, sex: '0', date: '2020-01-02T08:40:30.000+0800'}
]
}
}
模板写得多了,哎,太麻烦,到处都是复制粘贴!全局 formatter 这时就派上用场 了,接着往下瞅瞅
import VXETable from 'vxe-table'
VXETable.formats.add('fotmatSex', ({ cellValue }) => {
return cellValue === '1' ? '男' : '女'
})
VXETable.formats.add('formatDate', ({ cellValue }) => {
return XEUtils.toDateString(cellValue, 'yyyy-dd-MM')
})
<vxe-table :data="tableData">
<vxe-table-column field="name" title="Name">vxe-table-column>
<vxe-table-column field="amount" title="Amount">vxe-table-column>
<vxe-table-column field="sex" title="Sex" formatter="fotmatSex">vxe-table-column>
<vxe-table-column field="date" title="Date" formatter="formatDate">vxe-table-column>
vxe-table>
export default {
data () {
tableData: [
{name: 'Test1', amount: 1024.7895, sex: '1', date: '2020-01-01T10:30:20.000+0800'},
{name: 'Test2', amount: 512.056, sex: '0', date: '2020-01-02T08:40:30.000+0800'}
]
}
}
全局格式化已经可以完美解决问题了,那么如果想要自定义模板也能全局复用呢?没问题的,最强的渲染器就此诞生
先来看一个最简单的 cell-render 单元格渲染器,由于渲染器的功能太多,具体可以去看官方文档
import VXETable from 'vxe-table'
import XEUtils from 'xe-utils'
VXETable.renderer.add('MyDate', {
renderDefault (h, renderOpts, params) {
const { row, column } = params
// 注意:所有渲染的返回格式全部都是个数组
return [
<span>{ XEUtils.toDateString(row[column.property], 'yyyy-dd-MM') }</span>
]
}
})
<vxe-table :data="tableData">
<vxe-table-column field="name" title="Name">vxe-table-column>
<vxe-table-column field="amount" title="Amount">vxe-table-column>
<vxe-table-column field="sex" title="Sex">vxe-table-column>
<vxe-table-column field="date" title="Date" cell-render="{name: 'MyDate'}">vxe-table-column>
vxe-table>
export default {
data () {
tableData: [
{name: 'Test1', amount: 1024.7895, sex: '1', date: '2020-01-01T10:30:20.000+0800'},
{name: 'Test2', amount: 512.056, sex: '0', date: '2020-01-02T08:40:30.000+0800'}
]
}
}