分组

通过 groupConfig 按字段分组展示数据，支持多级分组与展开/收起。

使用的 API

type Column = {
  key: string;  // 列标识(必填)
  title: string;  // 列标题(必填)
  width: number;  // 列宽(必填)
}

type Options = {
  list: T[];  // 数据列表
  itemKey: string;  // 行唯一标识字段名
  estimatedSize: number;  // 行预估高度(px)
  buffer: number;  // 缓冲区行数
  border: boolean;  // 是否显示边框
  groupConfig: { field: string; sort?: 'asc' | 'desc' }[];  // 分组配置
  defaultExpandAll: boolean;  // 默认展开所有展开行
}

分组行外观

分组行会自动带上：左侧主色标记条、分组字段名（取同 key 列的 title）、分组值、条数徽标；整行可点击折叠/展开；横向滚动时分组标题会 sticky 停在左侧不被滚走。多级分组按层级（.vt-tr--group-lv1/2/3）自动递减底色与字号。

配色同样是变量，可单独覆盖：

.vt-root {
  --vt-group-bg: #eaf0fb; /* 分组行底色（默认由主色派生） */
  --vt-group-bg-lv2: #f1f5fd; /* 二级 */
  --vt-group-bg-lv3: #f6f9fe; /* 三级及更深 */
  --vt-group-bg-hover: #dfe9fa;
  --vt-group-border: #c9d8f2; /* 分组行上下分隔线 */
  --vt-group-accent: var(--vt-color-primary); /* 左侧标记条 */
  --vt-group-accent-width: 3px;
  --vt-group-text: var(--vt-text-color);
}

示例

微应用尚未挂载。

源码

点击查看源码

import { faker } from '@faker-js/faker';
import { VirtTable } from '@virt-table/vanilla';

export function bootstrapTableGroup(root: HTMLElement): () => void {
  const depts = ['工程部', '设计部', '市场部', '财务部'];
  const teamNames = ['Alpha', 'Beta', 'Gamma'];

  const groupRows = Array.from({ length: 200 }, (_, i) => ({
    id: i,
    name: faker.person.fullName(),
    department: depts[i % depts.length],
    team: teamNames[i % teamNames.length],
    score: Math.floor(Math.random() * 100),
  }));

  const columns = [
    { key: 'name', title: '姓名', width: 180 },
    { key: 'department', title: '部门', width: 120 },
    { key: 'team', title: '小组', width: 120 },
    { key: 'score', title: '分数', width: 100 },
  ];

  root.innerHTML = `
    <div class="virt-table-controls">
      <button class="virt-table-btn virt-table-btn-primary" id="btnExpandAll">全部展开</button>
      <button class="virt-table-btn" id="btnCollapseAll">全部收起</button>
    </div>
    <div style="width:800px;height:600px;" class="demo-container" id="tableContainer"></div>
  `;

  const container = root.querySelector('#tableContainer') as HTMLElement;
  const listeners: (() => void)[] = [];

  const table = new VirtTable(container, {
    list: groupRows,
    columns,
    itemKey: 'id',
    estimatedSize: 40,
    buffer: 4,
    groupConfig: [{ field: 'department' }, { field: 'team' }],
    defaultExpandAll: true,
    border: true,
  });

  const on = (id: string, handler: () => void) => {
    const el = root.querySelector(`#${id}`);
    if (!el) return;
    el.addEventListener('click', handler);
    listeners.push(() => el.removeEventListener('click', handler));
  };

  on('btnExpandAll', () => table.expandAll());
  on('btnCollapseAll', () => table.collapseAll());

  return () => {
    table.destroy();
    listeners.forEach((off) => off());
    root.innerHTML = '';
  };
}