You need to enable JavaScript to run this app. 如何在react-table中使用rowSpan实现表格单元格纵向合并
优惠活动
大模型
产品
解决方案
定价
更多

如何在react-table中使用rowSpan实现表格单元格纵向合并

React Table 实现重复字段纵向合并(rowSpan)的落地方法

你当前使用的是React Table v6版本(从配置里的filterable、defaultPageSize、getTdProps这些API可以判断),这个版本本身没有内置rowSpan合并能力,你在列配置里加的enableRowSpan属于自定义标识,不会触发自动合并效果。整套实现不需要引入第三方合并库,完全可以和你现有代码兼容,甚至可以直接复用你已经加好的enableRowSpan列标记,不需要调整原有列定义结构。

核心实现逻辑

  • 第一步:预处理当前渲染的表格数据,计算连续重复值的合并区间
    针对你要合并的username字段,遍历当前页的所有行,把连续相同username值的行归为一个合并组,记录两个核心映射关系:
    1. 组起始行的索引:对应这个单元格需要设置的rowSpan值,也就是这个合并组一共覆盖多少行
    2. 组内非起始行的单元格位置:标记这些位置的单元格需要被折叠,不单独渲染内容
      建议在组件内封装一个通用的计算函数,只要表格数据更新(包括排序、筛选、分页切换带来的data变化)就重新执行计算,避免排序、筛选后出现合并区间错位的问题。
      参考实现:
    // 通用rowSpan计算工具
    const calculateRowSpanConfig = (tableData, targetField) => {
      const rowSpanValueMap = {}
      const hiddenCellSet = new Set()
      if (!tableData.length) return { rowSpanValueMap, hiddenCellSet }
      let groupStartIndex = 0
      for (let i = 1; i <= tableData.length; i++) {
        // 遇到值变化或者遍历到末尾,结算当前分组
        if (i === tableData.length || tableData[i][targetField] !== tableData[groupStartIndex][targetField]) {
          const groupLength = i - groupStartIndex
          rowSpanValueMap[groupStartIndex] = groupLength
          // 标记组内非起始行的对应单元格为隐藏
          for (let rowIndex = groupStartIndex + 1; rowIndex < i; rowIndex++) {
            hiddenCellSet.add(`${rowIndex}-${targetField}`)
          }
          groupStartIndex = i
        }
      }
      return { rowSpanValueMap, hiddenCellSet }
    }
    
  • 第二步:在getTdProps回调中应用合并规则
    你已经实现了getTdProps的点击选中逻辑,只需要在回调里针对标记了enableRowSpan的列做判断,给对应单元格加上原生的rowSpan属性即可:
    • 如果单元格位置在隐藏集合里,设置rowSpan: 0,浏览器会自动将这个单元格折叠,比display: none更符合表格语义
    • 如果单元格是合并组的起始位置,直接取出计算好的rowSpan值应用到单元格上
      适配你现有代码的调整片段:
    <ReactTable
      data={this.state.users}
      filterable={true}
      columns={columns}
      defaultPageSize={18}
      getTdProps={(state, rowInfo, column) => {
        // 保留原有点击逻辑
        const index = rowInfo ? rowInfo.index : -1;
        const baseClickProps = {
          onClick: (e, handleOriginal) => {
            if (column.Header === undefined) {
              handleOriginal();
            } else {
              if (rowInfo !== undefined) {
                this.selectedRow = index;
                this.onRowSelect(rowInfo.original.id);
              }
            }
          },
        }
        // 新增rowSpan合并逻辑
        if (column.enableRowSpan && rowInfo) {
          const cellUniqueKey = `${rowInfo.index}-${column.id}`
          // 被合并的隐藏单元格
          if (this.state.hiddenCellSet.has(cellUniqueKey)) {
            return {
              ...baseClickProps,
              rowSpan: 0
            }
          }
          // 合并组起始的单元格
          if (this.state.rowSpanValueMap[rowInfo.index]) {
            return {
              ...baseClickProps,
              rowSpan: this.state.rowSpanValueMap[rowInfo.index]
            }
          }
        }
        return baseClickProps
      }}
    />
    

实操注意点

  • 排序、筛选、分页切换触发data更新时,必须重新执行rowSpan计算逻辑,不能用初始的固定映射,否则会出现单元格内容和rowSpan不匹配的错位问题
  • 合并区间的计算仅基于当前页实际渲染的行,不要跨页判断连续同值,否则会出现跨页单元格拉伸、布局错乱的问题
  • 原来的行点击选中逻辑不需要改动,只要在返回单元格属性时把原有点击事件透传,就不会破坏现有交互逻辑

内容的提问来源于stack exchange,提问作者Oshini

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 20:45:06