1、序言
完整源码:el-table-example: 两种方式对el-table二次封装
最近在公司写了好多的后台管理系统,管理系统很大部分都是elementui下的el-table,el-table中有很多 <el-table-column></el-table-column>是重复的,像这样:
能不能通过配置项让其自动生成 <el-table-column></el-table-column>,省去冗余代码。下一次管理系统添加新模块相似的内容,就不用复制粘贴了。有一说一,复制粘贴完成需求速度非常快、并且效果不错,但是代码就像屎山,冗余度、可维护性都比较差,长期复制粘贴没什么成长!
2、自定义组件方式封装el-table
2.1、封装
(1)在src下建立components文件夹
(2)在components文件夹下建立Table/index.vue、index.js两个文件夹
(3)index.js文件全局注册封装的Table组件
import Vue from 'vue';
import Table from './index.vue';
/* 封装的表格组件 */
// 全局注册<Table>组件
Vue.component('CommonTable', Table);
(4)index.vue文件封装Table组件
遇到一些自定义列就使用作用域名插槽填充,名称为prop值,并在coloum中配置slot属性。像这样:
<!-- 表格组件 -->
<template>
<div>
<el-table :data="data" stripe style="width: 100%" v-loading="loading" @selection-change="handleSelectionChange">
<!--选择-->
<el-table-column v-if="hasSelection" type="selection" width="55" />
<!--序号-->
<el-table-column v-if="hasIndex" type="index" width="55" />
<!--数据源-->
<template v-for="(column, index) in columns">
<!-- 表头存在type类型 -->
<el-table-column v-if="
column.type &&
(column.type == 'selection' || column.type == 'index')
" :type="column.type" />
<!-- 表头是数据或操作内容 -->
<el-table-column v-else :label="column.label">
<template v-if="!column.type" slot-scope="{ row, $index}">
<slot v-if="column.slot" :name="column.slot" :row="row" :index="$index" />
<span v-else>{{ row[column.prop] }}</span>
</template>
</el-table-column>
</template>
</el-table>
</div>
</template>
<script>
export default {
name: 'Table',
props: {
loading: {
type: Boolean,
default: () => false
},
// 是否可以选择
hasSelection: {
type: Boolean,
default: () => false
},
// 是否有序列项
hasIndex: {
type: Boolean,
default: () => false
},
// 这是相应的字段展示
columns: {
type: Array,
default: () => []
},
// 这是数据源
data: {
type: Array,
default: () => []
}
},
methods: {
// 将选中的行发送到父组件
handleSelectionChange(val) {
const selectionArr = []
val.forEach(item => {
selectionArr.push(item)
})
this.$emit('commitSelection', selectionArr)
},
},
}
</script>
(5)main.js中引入全局注册组件
import Vue from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'
import "./assets/css/main.css";
/* 全局注册的组件 */
import './components/Table/index'; // 表格组件
new Vue({
router,
store,
render: h => h(App)
}).$mount('#app')
2.2、使用
<template>
<div>
<common-table :columns="columns" :data="tableData">
<template slot="isPublic" slot-scope="{ row }">
{{ transformPublic(row.isPublic) }}
</template>
<template slot="operation" slot-scope="{ row }">
<el-button type="primary">
编辑
</el-button>
<el-button type="danger">
删除
</el-button>
</template>
</common-table>
</div>
</template>
<script>
export default {
data() {
return {
tableData: [{
id: 11,
name: '绿色天使幼儿园',
count: 100,
address: '北京',
isPublic: 1,
}, {
id: 22,
name: '金苹果幼儿园',
count: 200,
address: '上海',
isPublic: 1,
}, {
id: 33,
name: '童趣幼儿园',
count: 300,
address: '广州',
isPublic: 0,
}, {
id: 44,
name: '快乐星球幼儿园',
count: 400,
address: '深圳',
isPublic: 0,
}],
columns: [
{ prop: 'id', label: 'id' },
{ prop: 'name', label: '名称' },
{ prop: 'count', label: '人数' },
{ prop: 'isPublic', label: '是否公办', slot: 'isPublic' },
{ prop: 'address', label: '地址' },
{
label: "操作",
slot: "operation"
}
]
}
},
computed: {
transformPublic() {
return function (isPublic) {
let t = {
1: '是',
0: '否'
}
return t[isPublic]
}
}
}
}
</script>
<style scoped></style>
3、jsx方式封装el-table
3.1、jsx
我看网上还有使用jsx方式来封装el-table,jsx能够抽象组件,jsx是一种javascript和xml结合的一种语法,它既有javascript的灵活性,也有xml的规范性,但是有一说一,写起来真不习惯、真不舒服!
babel能将es6转换成es5,还能将jsx转换成javascript,所以babel插件必不可少!惊喜的发现脚手架cli已经配置好babel插件,基本可以直接上手写jsx了!jsx语法和vue语法还是有一些差别的,详细去看看网上例子,掌握好它上手react比较容易!
写jsx记得要把vue中的template、script、style标签去掉
3.2、封装
(1)src/components/JsxTable/index.js 建立文件夹
(2)render()中 return <div> <el-table></el-table> </div>
(3)自定义指令v-loading还有语法糖@selection-change 使用不了,需要转译一下让jsx识别
// @selection-change语法糖没法在jsx直接使用,需要转译一下
const listeners = {
on: {
['selection-change']: val => this.$emit('commitSelection', val)
}
};
// v-loading没法在jsx直接使用,需要转译一下
const directives = {
directives: [{ name: 'loading', value: loading }]
};
(4)attrs和scopedSlots
attrs 属性是用于将父组件属性传递(除了 prop 传递的属性、class 和 style )给子组件, 这通常用于将事件监听器和自定义属性传递给子组件。
scopedSlots 是用于将父组件的作用域插槽(scoped slot)传递给子组件,以便子组件可以在父组件提供的数据上进行渲染。在父组件中,标签并设置slot-scope属性来创建作用域插槽,然后在子组件中使用this.$slots属性来获取这些插槽
// 渲染列
const renderColumn = () => {
return columns.map(item => {
const attribute = {
attrs: { ...item }
};
if (item.slot) {
attribute.scopedSlots = {
default: this.$scopedSlots[item.slot]
};
}
return <el-table-column {...attribute} />;
});
};
(5)将属性、事件、指令组装到el-table中,并通过render()返回组装好的el-table
// 渲染表格
const renderTable = (
<el-table data={dataList} {...listeners} {...directives} style="width: 100%" >
{renderColumn()}
</el-table >
);
return <div>{renderTable}</div>;
3.3、使用
<template>
<div>
<jsx-table :columns="columns" :dataList="tableData" hasSelection @commitSelection="getselected">
<template slot="isPublic" slot-scope="{ row }">
{{ transformPublic(row.isPublic) }}
</template>
<template slot="operation" slot-scope="scope">
<el-button type="primary">
编辑
</el-button>
<el-button type="danger">
删除
</el-button>
</template>
</jsx-table>
</div>
</template>
<script>
import JsxTable from '@/components/JsxTable'
export default {
components: {
JsxTable
},
data() {
return {
tableData: [{
id: 11,
name: '绿色天使幼儿园',
count: 100,
address: '北京',
isPublic: 1,
}, {
id: 22,
name: '金苹果幼儿园',
count: 200,
address: '上海',
isPublic: 1,
}, {
id: 33,
name: '童趣幼儿园',
count: 300,
address: '广州',
isPublic: 0,
}, {
id: 44,
name: '快乐星球幼儿园',
count: 400,
address: '深圳',
isPublic: 0,
}],
columns: [
{ prop: 'id', label: 'id' },
{ prop: 'name', label: '名称' },
{ prop: 'count', label: '人数' },
{ prop: 'isPublic', label: '是否公办', slot: 'isPublic' },
{ prop: 'address', label: '地址' },
{
label: "操作",
slot: "operation"
}
]
}
},
methods: {
// 获取选中行
getselected(val) {
console.log('val:', val);
}
},
computed: {
transformPublic() {
return function (isPublic) {
let t = {
1: '是',
0: '否'
}
return t[isPublic]
}
}
}
}
</script>
<style scoped></style>