深入探索 ElementUI el-table 行列合并

在前端开发中，数据展示一直是一个重要的部分，而表格则是数据展示最常见的形式之一。ElementUI 是饿了么前端团队推出的一款基于 Vue 的 UI 组件库，其中的 el-table 组件是一个功能强大且灵活的表格组件。今天我们要详细探讨的是 el-table 的行列合并操作。

初识 el-table

el-table 是一个提供了丰富功能和极高定制性的表格组件。它不仅能展示常规的表格数据，还可以实现复杂的数据处理和展示需求，如排序、过滤、分页、合并单元格等。而在实际开发中，行列合并是一个非常实用的功能，尤其是在展示报表数据时，能够极大地提升数据的可读性和用户体验。

el-table 的基本使用

在开始讨论行列合并之前，我们先简单了解一下 el-table 的基本使用方法。我们可以通过 el-table 标签和 el-table-column 标签来定义一个表格。el-table 用于定义整个表格，而 el-table-column 用于定义表格中的每一列。

<template><el-table :data="tableData"><el-table-column prop="date" label="日期" width="180"></el-table-column><el-table-column prop="name" label="姓名" width="180"></el-table-column><el-table-column prop="address" label="地址"></el-table-column></el-table>
</template><script>
export default {data() {return {tableData: [{date: '2016-05-02',name: '王小虎',address: '上海市普陀区金沙江路 1518 弄'}, {date: '2016-05-04',name: '王小虎',address: '上海市普陀区金沙江路 1517 弄'}]}}
}
</script>

行合并的实现

行合并是指将相同数据的相邻行合并成一个单元格，这在数据表格中非常常见。ElementUI 通过 span-method 属性来实现行合并功能。span-method 是一个方法，用于设置单元格的 rowspan 和 colspan。该方法的返回值是一个包含 rowspan 和 colspan 的对象，通过它们可以控制单元格的合并。

下面是一个简单的示例，展示了如何实现行合并：

<template><el-table:data="tableData":span-method="arraySpanMethod"borderstyle="width: 100%"><el-table-column prop="name" label="姓名" width="120"></el-table-column><el-table-column prop="date" label="日期" width="120"></el-table-column><el-table-column prop="address" label="地址"></el-table-column></el-table>
</template><script>
export default {data() {return {tableData: [{date: '2016-05-02',name: '王小虎',address: '上海市普陀区金沙江路 1518 弄'}, {date: '2016-05-02',name: '王小虎',address: '上海市普陀区金沙江路 1517 弄'}, {date: '2016-05-04',name: '王小虎',address: '上海市普陀区金沙江路 1519 弄'}]}},methods: {arraySpanMethod({ row, column, rowIndex, columnIndex }) {if (columnIndex === 0) {if (rowIndex % 2 === 0) {return {rowspan: 2,colspan: 1};} else {return {rowspan: 0,colspan: 0};}}}}
}
</script>

在这个例子中，我们定义了一个 arraySpanMethod 方法，通过判断行索引 rowIndex 是否为偶数来控制行合并。对于偶数行，我们返回 rowspan: 2，表示合并两行；对于奇数行，我们返回 rowspan: 0，表示不显示该单元格。

列合并的实现

列合并是指将相同数据的相邻列合并成一个单元格，这在一些特定场景中也非常有用。列合并同样是通过 span-method 属性来实现的。我们只需要在 span-method 方法中控制 colspan 的值即可。

下面是一个实现列合并的示例：

<template><el-table:data="tableData":span-method="objectSpanMethod"borderstyle="width: 100%"><el-table-column prop="name" label="姓名" width="120"></el-table-column><el-table-column prop="date" label="日期" width="120"></el-table-column><el-table-column prop="address" label="地址"></el-table-column></el-table>
</template><script>
export default {data() {return {tableData: [{date: '2016-05-02',name: '王小虎',address: '上海市普陀区金沙江路 1518 弄'}, {date: '2016-05-02',name: '王小虎',address: '上海市普陀区金沙江路 1517 弄'}, {date: '2016-05-04',name: '王小虎',address: '上海市普陀区金沙江路 1519 弄'}]}},methods: {objectSpanMethod({ row, column, rowIndex, columnIndex }) {if (rowIndex % 2 === 0) {if (columnIndex === 1) {return {rowspan: 1,colspan: 2};}if (columnIndex === 2) {return {rowspan: 0,colspan: 0};}}}}
}
</script>

在这个例子中，我们同样通过 objectSpanMethod 方法来控制列合并。对于偶数行的第二列，我们返回 colspan: 2，表示合并两列；对于第三列，我们返回 colspan: 0，表示不显示该单元格。

行列合并的综合实现

在实际开发中，我们经常需要同时实现行合并和列合并。下面是一个更复杂的示例，展示了如何同时实现行合并和列合并：

<template><el-table:data="tableData":span-method="combinedSpanMethod"borderstyle="width: 100%"><el-table-column prop="name" label="姓名" width="120"></el-table-column><el-table-column prop="date" label="日期" width="120"></el-table-column><el-table-column prop="address" label="地址"></el-table-column></el-table>
</template><script>
export default {data() {return {tableData: [{date: '2016-05-02',name: '王小虎',address: '上海市普陀区金沙江路 1518 弄'}, {date: '2016-05-02',name: '王小虎',address: '上海市普陀区金沙江路 1517 弄'}, {date: '2016-05-04',name: '王小虎',address: '上海市普陀区金沙江路 1519 弄'}]}},methods: {combinedSpanMethod({ row, column, rowIndex, columnIndex }) {if (columnIndex === 0) {if (rowIndex % 2 === 0) {return {rowspan: 2,colspan: 1};} else {return {rowspan: 0,colspan: 0};}}if (rowIndex % 2 === 0) {if (columnIndex === 1) {return {rowspan: 1,colspan: 2};}if (columnIndex === 2) {return {rowspan: 0,colspan: 0};}}}}
}
</script>

在这个示例中，我们在 combinedSpanMethod 方法中同时控制了行合并和列合并。对于第一列的行合并逻辑保持不变，而对于第二列，我们增加了列合并的逻辑，使其在满足条件时合并两列。

实践中的应用

在实际项目中，行列合并常用于展示统计数据或报表。例如，我们有一个展示销售数据的表格，需要对相同日期的销售记录进行合并。通过行列合并，可以使表格更加简洁明了，提升数据展示的效果。

<template><el-table:data="salesData":span-method="salesSpanMethod"borderstyle="width: 100%"><el-table-column prop="date" label="日期" width="120"></el-table-column><el-table-column prop="region" label="区域" width="120"></el-table-column><el-table-column prop="sales" label="销售额"></el-table-column></el-table>
</template><script>
export default {data() {return {salesData: [{date: '2023-01-01',region: '华东',sales: 1000}, {date: '2023-01-01',region: '华南',sales: 2000}, {date: '2023-01-02',region: '华东',sales: 1500}, {date: '2023-01-02',region: '华南',sales: 2500}]}},methods: {salesSpanMethod({ row, column, rowIndex, columnIndex }) {if (columnIndex === 0) {if (rowIndex % 2 === 0) {return {rowspan: 2,colspan: 1};} else {return {rowspan: 0,colspan: 0};}}}}
}
</script>

在这个示例中，我们通过 salesSpanMethod 方法实现了日期列的行合并，使得相同日期的销售记录合并在一起。这种方式不仅简化了表格的视觉效果，还提升了数据的可读性。

更加复杂的合并逻辑

在某些情况下，我们可能需要更加复杂的合并逻辑。例如，根据多个条件进行合并，或者在合并过程中动态调整单元格的内容。这时候，我们可以在 span-method 方法中编写更加灵活的逻辑。

<template><el-table:data="complexData":span-method="complexSpanMethod"borderstyle="width: 100%"><el-table-column prop="category" label="分类" width="120"></el-table-column><el-table-column prop="subCategory" label="子分类" width="120"></el-table-column><el-table-column prop="item" label="项目"></el-table-column></el-table>
</template><script>
export default {data() {return {complexData: [{category: '水果',subCategory: '苹果',item: '红富士'}, {category: '水果',subCategory: '苹果',item: '青苹果'}, {category: '水果',subCategory: '橙子',item: '脐橙'}, {category: '蔬菜',subCategory: '叶菜',item: '菠菜'}, {category: '蔬菜',subCategory: '根茎',item: '胡萝卜'}]}},methods: {complexSpanMethod({ row, column, rowIndex, columnIndex }) {if (columnIndex === 0) {if (rowIndex === 0 || row.category !== this.complexData[rowIndex - 1].category) {let rowspan = 1;for (let i = rowIndex + 1; i < this.complexData.length; i++) {if (this.complexData[i].category === row.category) {rowspan++;} else {break;}}return {rowspan,colspan: 1};} else {return {rowspan: 0,colspan: 0};}} else if (columnIndex === 1) {if (rowIndex === 0 || row.subCategory !== this.complexData[rowIndex - 1].subCategory) {let rowspan = 1;for (let i = rowIndex + 1; i < this.complexData.length; i++) {if (this.complexData[i].subCategory === row.subCategory) {rowspan++;} else {break;}}return {rowspan,colspan: 1};} else {return {rowspan: 0,colspan: 0};}}}}
}
</script>