vue 表格组件 vxe-table 实现拖拽列字段自动生成透视表汇总

在数据分析和报表展示中，透视表（Pivot Table）是一种强大的工具，能够通过拖拽字段快速对数据进行分组、汇总和交叉分析。传统的透视表实现往往需要借助 Excel 或专业 BI 工具，而在 Web 应用中，vxe-table 借助其灵活的列自定义和聚合能力，让开发者可以直接在表格界面上通过拖拽列字段来动态生成汇总数据，实现类似 Excel 透视表的交互体验。

本文将详细介绍如何利用 vxe-table 的 customConfig 和 aggregateConfig 配置，快速搭建一个支持拖拽分组和拖拽值汇总的透视表功能，并提供两种展示模式（内联拖拽面板 vs 弹窗模式）的完整代码。

参数说明

vxe-table 通过以下配置开启透视表相关的拖拽汇总功能：

配置项	说明
customConfig.allowGroup	是否允许将列拖拽到"分组"区域（相当于透视表的行/列标签）
customConfig.allowValues	是否允许将列拖拽到"值"区域（相当于透视表的数值汇总字段）
aggregateConfig	聚合配置（如合计、平均值等），通常配合 allowValues 使用
toolbarConfig.custom	显示自定义列按钮，用于打开拖拽面板或弹窗

开启 allowGroup 和 allowValues 后，用户可以通过拖拽列标题到表格上方或侧边区域（或弹窗中）来自由组合分组字段和汇总字段，表格会实时重新计算并展示汇总数据。

交互模式

vxe-table 提供了两种透视表配置界面模式，可通过 customConfig.mode 切换：

内联模式（默认）：在表格上方直接显示拖拽面板，用户将列拖入"分组"或"值"区域，操作直观。
弹窗模式：点击工具栏的"自定义列"按钮，弹出一个独立的配置窗口，在其中进行拖拽配置，适合对界面整洁度要求较高的场景。
抽屉模式：点击工具栏的"自定义列"按钮，弹出一个独立的配置抽屉，在其中进行拖拽配置，适合对界面整洁度要求较高的场景。

个性化列操作

html 复制代码

<template>
  <div>
    <vxe-grid v-bind="gridOptions"></vxe-grid>
  </div>
</template>

<script setup>
import { reactive } from 'vue'

const gridOptions = reactive({
  height: 400,
  border: true,
  showOverflow: true,
  aggregateConfig: {},
  columnConfig: {
    resizable: true
  },
  customConfig: {
    allowGroup: true,
    allowValues: true
  },
  toolbarConfig: {
    custom: true
  },
  columns: [
    { type: 'seq', width: 70 },
    { field: 'department', title: '部门', minWidth: 200, rowGroupNode: true },
    { field: 'name', title: '产品名称', width: 140 },
    { field: 'date', title: '日期', width: 140 },
    { field: 'actualAmount', title: '实际销售', width: 140 },
    { field: 'plannedAmount', title: '计划销售', width: 140 }
  ],
  data: [
    { id: 10001, name: '笔记本', department: '销售1部', actualAmount: 80, plannedAmount: 100, date: '2025-02-01' },
    { id: 10002, name: '手机', department: '销售3部', actualAmount: 140, plannedAmount: 120, date: '2025-01-01' },
    { id: 10003, name: '键盘', department: '销售2部', actualAmount: 220, plannedAmount: 200, date: '2025-05-01' },
    { id: 10004, name: '鼠标', department: '销售1部', actualAmount: 110, plannedAmount: 140, date: '2025-01-01' },
    { id: 10005, name: '笔记本', department: '销售2部', actualAmount: 40, plannedAmount: 90, date: '2025-01-01' },
    { id: 10006, name: '鼠标', department: '销售4部', actualAmount: 40, plannedAmount: 120, date: '2025-03-01' },
    { id: 10007, name: '键盘', department: '销售1部', actualAmount: 234, plannedAmount: 300, date: '2025-05-01' },
    { id: 10008, name: '手机', department: '销售4部', actualAmount: 146, plannedAmount: 240, date: '2025-11-01' },
    { id: 10009, name: '笔记本', department: '销售3部', actualAmount: 78, plannedAmount: 120, date: '2025-05-01' },
    { id: 10010, name: '笔记本', department: '销售4部', actualAmount: 100, plannedAmount: 130, date: '2025-03-01' },
    { id: 10011, name: '手机', department: '销售2部', actualAmount: 146, plannedAmount: 150, date: '2025-03-01' },
    { id: 10012, name: '键盘', department: '销售4部', actualAmount: 130, plannedAmount: 130, date: '2025-10-01' },
    { id: 10013, name: '手机', department: '销售2部', actualAmount: 140, plannedAmount: 80, date: '2025-02-01' },
    { id: 10014, name: '笔记本', department: '销售1部', actualAmount: 200, plannedAmount: 100, date: '2025-08-01' },
    { id: 10015, name: '键盘', department: '销售3部', actualAmount: 320, plannedAmount: 300, date: '2025-05-01' },
    { id: 10016, name: '笔记本', department: '销售4部', actualAmount: 380, plannedAmount: 400, date: '2025-10-01' },
    { id: 10017, name: '鼠标', department: '销售1部', actualAmount: 34, plannedAmount: 200, date: '2025-12-01' },
    { id: 10018, name: '键盘', department: '销售4部', actualAmount: 100, plannedAmount: 150, date: '2025-10-01' },
    { id: 10019, name: '鼠标', department: '销售3部', actualAmount: 90, plannedAmount: 120, date: '2025-02-01' },
    { id: 10020, name: '手机', department: '销售2部', actualAmount: 40, plannedAmount: 50, date: '2025-03-01' }
  ]
})
</script>

弹窗模式

html 复制代码

<template>
  <div>
    <vxe-grid v-bind="gridOptions"></vxe-grid>
  </div>
</template>

<script setup>
import { reactive } from 'vue'

const gridOptions = reactive({
  height: 400,
  border: true,
  showOverflow: true,
  aggregateConfig: {},
  columnConfig: {
    resizable: true
  },
  customConfig: {
    mode: 'modal',
    allowGroup: true,
    allowValues: true
  },
  toolbarConfig: {
    custom: true
  },
  columns: [
    { type: 'seq', width: 70 },
    { field: 'department', title: '部门', minWidth: 200, rowGroupNode: true },
    { field: 'name', title: '产品名称', width: 140 },
    { field: 'date', title: '日期', width: 140 },
    { field: 'actualAmount', title: '实际销售', width: 140 },
    { field: 'plannedAmount', title: '计划销售', width: 140 }
  ],
  data: [
    { id: 10001, name: '笔记本', department: '销售1部', actualAmount: 80, plannedAmount: 100, date: '2025-02-01' },
    { id: 10002, name: '手机', department: '销售3部', actualAmount: 140, plannedAmount: 120, date: '2025-01-01' },
    { id: 10003, name: '键盘', department: '销售2部', actualAmount: 220, plannedAmount: 200, date: '2025-05-01' },
    { id: 10004, name: '鼠标', department: '销售1部', actualAmount: 110, plannedAmount: 140, date: '2025-01-01' },
    { id: 10005, name: '笔记本', department: '销售2部', actualAmount: 40, plannedAmount: 90, date: '2025-01-01' },
    { id: 10006, name: '鼠标', department: '销售4部', actualAmount: 40, plannedAmount: 120, date: '2025-03-01' },
    { id: 10007, name: '键盘', department: '销售1部', actualAmount: 234, plannedAmount: 300, date: '2025-05-01' },
    { id: 10008, name: '手机', department: '销售4部', actualAmount: 146, plannedAmount: 240, date: '2025-11-01' },
    { id: 10009, name: '笔记本', department: '销售3部', actualAmount: 78, plannedAmount: 120, date: '2025-05-01' },
    { id: 10010, name: '笔记本', department: '销售4部', actualAmount: 100, plannedAmount: 130, date: '2025-03-01' },
    { id: 10011, name: '手机', department: '销售2部', actualAmount: 146, plannedAmount: 150, date: '2025-03-01' },
    { id: 10012, name: '键盘', department: '销售4部', actualAmount: 130, plannedAmount: 130, date: '2025-10-01' },
    { id: 10013, name: '手机', department: '销售2部', actualAmount: 140, plannedAmount: 80, date: '2025-02-01' },
    { id: 10014, name: '笔记本', department: '销售1部', actualAmount: 200, plannedAmount: 100, date: '2025-08-01' },
    { id: 10015, name: '键盘', department: '销售3部', actualAmount: 320, plannedAmount: 300, date: '2025-05-01' },
    { id: 10016, name: '笔记本', department: '销售4部', actualAmount: 380, plannedAmount: 400, date: '2025-10-01' },
    { id: 10017, name: '鼠标', department: '销售1部', actualAmount: 34, plannedAmount: 200, date: '2025-12-01' },
    { id: 10018, name: '键盘', department: '销售4部', actualAmount: 100, plannedAmount: 150, date: '2025-10-01' },
    { id: 10019, name: '鼠标', department: '销售3部', actualAmount: 90, plannedAmount: 120, date: '2025-02-01' },
    { id: 10020, name: '手机', department: '销售2部', actualAmount: 40, plannedAmount: 50, date: '2025-03-01' }
  ]
})
</script>

关键点

字段类型与聚合
- 只有数值型字段（如 actualAmount）才能作为"值"进行汇总，文本字段拖入值区域不会产生有效聚合。
- 默认聚合函数为 sum，如需修改为平均值、计数等，可通过 aggregateConfig 自定义。
分组节点的默认状态
- 在列定义中设置 rowGroupNode: true 可以让该列默认出现在分组区域，提升初始体验。
数据刷新
- 拖拽调整后，表格会自动重新计算并渲染汇总数据，无需手动刷新。
与虚拟滚动兼容
- 透视表功能与虚拟滚动（virtualYConfig）可同时使用，但在数据量极大时，建议谨慎开启，避免性能开销。
自定义聚合函数
- 如需更复杂的聚合（如自定义计算公式），可参考 vxe-table 的 aggregate-config 高阶用法。

适用场景

销售报表：按部门、产品、时间维度汇总销售额。
运营数据分析：动态查看不同维度下的指标表现。
后台管理仪表板：为管理者提供灵活的数据探索工具。

借助 vxe-table 的 customConfig.allowGroup 和 allowValues，我们可以在不依赖第三方库的情况下，快速为 Web 应用添加交互式透视表功能。用户通过拖拽即可自由组合维度与指标，实时获得汇总结果，极大提升了数据查看和分析的效率。无论是内联面板还是弹窗模式，都能很好地融入现有后台界面。

https://vxetable.cn