在数据表格中,将数据按某个字段进行分组展示是一种常见的需求。vxe-table 提供了拖拽列字段进行分组的功能,用户无需编写额外代码,只需通过简单的拖拽操作即可动态改变分组规则,极大提升了数据探索的灵活性。
核心特性
- 可视化拖拽:将列头直接拖拽至分组区域,即可按该列分组。
- 多级分组:支持同时拖入多个字段,形成多层级分组。
- 动态调整:可随时增删分组字段,表格实时重组数据。
- 零代码配置:开启 customConfig.allowGroup 后,工具栏自动出现分组面板,无需手动编写分组逻辑。
代码
- 在 gridOptions 中配置 customConfig.allowGroup: true,即可启用自定义列面板中的分组拖拽功能。
- 如果希望表格初始化时即按某个字段展开分组,可以在对应列上设置 rowGroupNode: true。该列会默认显示分组层级,用户仍可通过拖拽调整。
- 在 toolbarConfig 中启用 custom: true,表格顶部会显示“自定义列”按钮。点击后弹出的面板中,用户可以将任意字段拖拽到“分组”区域,即可实时对数据进行分组。

<template><div><vxe-grid v-bind="gridOptions"></vxe-grid></div>
</template><script setup>
import { reactive } from 'vue'const gridOptions = reactive({height: 600,border: true,showOverflow: true,aggregateConfig: {},columnConfig: {resizable: true // 允许调整列宽},customConfig: {allowGroup: 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>
使用说明
- 拖拽分组:点击工具栏的“自定义列”按钮 → 在弹出面板中,将任意字段(如“部门”)从右侧列表拖拽到左侧“分组”区域 → 表格数据立即按该字段分组展示。
- 多级分组:依次拖入多个字段(例如先按“部门”,再按“产品名称”),表格会形成树形嵌套分组。
- 移除分组:在分组区域点击字段右侧的“×”按钮,或将其拖回字段列表,即可取消分组。
- 聚合统计:若需要分组汇总(如求和、平均值),可在 aggregateConfig 中配置,并在列上指定 aggFunc。
https://vxetable.cn
