vxe-table 数据分组统计与表尾合计

在数据报表或管理系统里，按某个字段分组并计算每组统计值（比如求和、平均值），同时表格底部还要显示所有数据的合计——这个需求太常见了。vxe-table 正好提供了灵活的组合方案：aggregateConfig 配上自定义计算函数 calcValuesMethod，再手动维护一个表尾 footerData，就能轻松搞定。

下面拿一个完整的例子来说明：按角色（role）对数据分组，统计每个角色的 num 总和，最后在表格底部显示所有数据的 num 总计。

属性说明

注意：分组聚合需要同时设置 aggregateConfig.groupFields 和至少一列的 rowGroupNode: true，同时要聚合的列必须设置 aggFunc: true（或自定义聚合函数）。

代码

<template>
  <div>
    <vxe-grid v-bind="gridOptions">vxe-grid>
  div>
template><script setup>
import { reactive } from 'vue'// 表尾合计行数据（手动维护总计）
const footerSummaryRow = reactive({
  seq: '总计',
  num: 0
})const gridOptions = reactive({
  border: true,
  showOverflow: true,       // 超出显示省略号
  showFooter: true,         // 开启表尾
  height: 500,
  loading: false,  // 分组聚合配置
  aggregateConfig: {
    groupFields: ['role'],   // 按角色字段分组
    // 自定义分组统计值的计算方法
    calcValuesMethod({ column, children }) {
      // 只对 num 列进行求和
      if (column.field === 'num') {
        let sum = 0
        children.forEach(item => {
          sum += item.num
        })
        return sum
      }
      // 其他列不统计，返回 0 或空字符串
      return 0
    }
  },  // 列定义
  columns: [
    { type: 'seq', width: 70, title: '序号' },
    { field: 'name', title: '姓名', minWidth: 150, rowGroupNode: true },  // 分组显示节点
    { field: 'role', title: '角色', width: 120 },
    { field: 'num', title: '数量', width: 100, aggFunc: true },           // 参与聚合
    { field: 'age', title: '年龄', width: 80 },
    { field: 'address', title: '地址', minWidth: 200 }
  ],  data: [],               // 动态加载的数据
  footerData: [footerSummaryRow]   // 表尾数据
})// 模拟异步加载数据，并计算表尾总计
const loadData = () => {
  gridOptions.loading = true
  setTimeout(() => {
    const rawData = [
      { id: 10001, name: 'Test1', role: 'Develop', sex: 'Woman', age: 28, num: 63, date: '2025-02-01', address: 'test abc' },
      { id: 10002, name: 'Test2', role: 'Test', sex: 'Man', age: 22, num: 63, date: '2025-01-01', address: 'Guangzhou' },
      { id: 10003, name: 'Test3', role: 'PM', sex: 'Woman', age: 32, num: 10, date: '2025-05-01', address: 'Shanghai' },
      { id: 10004, name: 'Test4', role: 'Designer', sex: 'Man', age: 32, num: 24, date: '2025-01-01', address: 'test abc' },
      { id: 10005, name: 'Test5', role: 'Develop', sex: 'Man', age: 30, num: 98, date: '2025-01-01', address: 'Shanghai' },
      { id: 10006, name: 'Test6', role: 'Designer', sex: 'Man', age: 30, num: 46, date: '2025-03-01', address: 'test abc' },
      { id: 10007, name: 'Test7', role: 'Test', sex: 'Woman', age: 29, num: 35, date: '2025-05-01', address: 'test abc' },
      { id: 10008, name: 'Test8', role: 'PM', sex: 'Woman', age: 35, num: 84, date: '2025-11-01', address: 'test abc' },
      { id: 10009, name: 'Test9', role: 'Test', sex: 'Man', age: 21, num: 25, date: '2025-05-01', address: 'test abc' },
      { id: 10010, name: 'Test10', role: 'PM', sex: 'Woman', age: 28, num: 32, date: '2025-03-01', address: 'test abc' },
      { id: 10011, name: 'Test11', role: 'Test', sex: 'Woman', age: 29, num: 24, date: '2025-03-01', address: 'test abc' },
      { id: 10012, name: 'Test12', role: 'Develop', sex: 'Man', age: 37, num: 28, date: '2025-10-01', address: 'test abc' },
      { id: 10013, name: 'Test13', role: 'Test', sex: 'Woman', age: 24, num: 38, date: '2025-02-01', address: 'test abc' },
      { id: 10014, name: 'Test14', role: 'Develop', sex: 'Man', age: 34, num: 46, date: '2025-08-01', address: 'test abc' },
      { id: 10015, name: 'Test15', role: 'Designer', sex: 'Man', age: 21, num: 48, date: '2025-05-01', address: 'test abc' },
      { id: 10016, name: 'Test16', role: 'Designer', sex: 'Woman', age: 21, num: 59, date: '2025-10-01', address: 'test abc' },
      { id: 10017, name: 'Test17', role: 'Test', sex: 'Man', age: 31, num: 81, date: '2025-12-01', address: 'test abc' },
      { id: 10018, name: 'Test18', role: 'Develop', sex: 'Woman', age: 32, num: 75, date: '2025-10-01', address: 'test abc' },
      { id: 10019, name: 'Test19', role: 'Test', sex: 'Man', age: 37, num: 80, date: '2025-02-01', address: 'test abc' },
      { id: 10020, name: 'Test20', role: 'Develop', sex: 'Man', age: 41, num: 60, date: '2025-03-01', address: 'test abc' }
    ]    // 计算总计（num 总和）
    let totalNum = 0
    rawData.forEach(row => {
      totalNum += row.num
    })
    footerSummaryRow.num = totalNum    gridOptions.data = rawData
    gridOptions.loading = false
  }, 200)
}// 调用加载
loadData()
script>

实现思路

• 分组显示：表格会按 role 字段将数据分组，同一角色的数据连续排列，并在每个分组前显示一个可展开/折叠的分组行（分组标题行）。
• 分组统计行：在每个分组的末尾，自动插入一行“分组合计”，其中 num 列显示该组内所有 num 值的总和（由 calcValuesMethod 自定义计算）。
• 表尾总计：表格底部固定一行（footerData），显示所有数据的 num 总计。该总计需要手动从数据源计算并赋值。

总的来说，vxe-table 通过 aggregateConfig 和 aggFunc，再搭配自定义计算函数 calcValuesMethod，就能轻松应对各种复杂的分组统计场景。而表尾合计通过 footerData 手动维护，既灵活又直观。把这两者结合起来，一个带分组统计和总计的专业数据表格就能快速成型。