Skip to content

Table 数据表格 ​

数据表格用行列关系呈现同类记录,支持精确比较、查找和批量操作。静态 table 与可编辑 grid 的键盘模型不同。

数据与任务边界 ​

表格的核心是不同行共享同一列定义,从而沿垂直方向精确比较。设计前必须确定记录主键、字段类型、表头关系和操作范围;可编辑单元格导航是额外能力,不能由普通读取表自动推导。

前置知识:HTML 表格元素、ARIA grid、稳定排序、游标分页、批量授权和数据导出。

数据模型 ​

json
{
  "queryId": "invoice-open",
  "columns": [
    "invoiceNo",
    "customer",
    "amount",
    "status"
  ],
  "sort": [
    {
      "field": "issuedAt",
      "direction": "desc"
    }
  ],
  "page": {
    "cursor": "c-20",
    "size": 50
  },
  "total": 1842,
  "snapshotVersion": 27
}

columns 应引用列定义而非只存显示文案,列定义包含字段类型、单位、格式化器和可排序性。snapshotVersion 把总数、页数据和跨页选择绑定到同一集合;更新后的快照不能继续使用旧选择令牌。

工作机制 ​

  • 每行对应一个稳定业务对象,行键不使用数组序号。
  • 列有字段 ID、可见标题、类型、单位、格式化与排序规则。
  • 静态比较优先使用原生 table、thead、tbody、th 与 scope。
  • 只有需要方向键在单元格间移动或编辑时才采用 ARIA grid。
  • 排序状态同时更新按钮名称、aria-sort、查询和 URL。
  • 分页总数、当前页和跨页选择使用同一查询快照。
  • 固定列与虚拟滚动不得破坏表头关系和键盘顺序。
  • 批量结果按稳定行 ID 返回成功、失败与未处理。
mermaid
flowchart LR
    C["列定义:类型、单位、表头"] --> Q["筛选与类型化排序"]
    Q --> S["查询快照"]
    S --> R["稳定行 ID"]
    R --> T["语义 table 或交互 grid"]
    S --> B["选择令牌与批量操作"]
    S --> E["同口径导出"]

交互规则 ​

  • 筛选改变查询集合并清除或重新确认跨页选择。
  • 排序使用原始类型值,不用格式化字符串比较。
  • 列宽调整有键盘或设置入口,不把拖拽作为唯一方式。
  • 行级操作与行导航分开,整行点击不能包裹内部按钮。
  • 选择当前页与选择当前筛选全部明确显示数量。
  • 导出冻结筛选、列、时区和权限,并返回任务 ID。

Table 数据表格状态 ​

状态专属行为
查询中保留表头、筛选和已确认快照;新查询不可操作旧选择
可用总数、快照版本、列与排序齐全
跨页选择明确本页数量与冻结查询全部数量
部分结果逐行标记失败,不把整表改成成功
过期版本变化,写操作前刷新并重选
虚拟化只渲染窗口,但行列语义与总数可取得

案例 1:账单后台筛选、排序并跨页选择发票 ​

约束与输入 ​

  • 1,842 张发票;50 行/页;财务角色;金额含币种。
  • 筛选未付款并按开票时间降序,选择当前筛选全部。

处理过程 ​

  1. 服务端返回 queryId、snapshotVersion 与总数。
  2. 表头按钮更新 aria-sort 和 URL 查询。
  3. 用户选择本页 50 项后,显式升级为全部 312 项。
  4. 提交批量提醒时发送冻结 queryId 而非当前 DOM 行。
  5. 结果页列出逐项结果并允许重试失败项。

失败分支 ​

筛选改变后仍保留旧的“全部 312 项”选择。修正为查询指纹变化即使选择失效,并要求重新确认范围。

专属验证 ​

  • 按开票时间降序后,前后两页合计 100 个发票 ID 无重复,列头报告降序且焦点留在排序按钮。
  • 从“本页 50 项”升级到“当前筛选 312 项”后,界面、选择令牌摘要和服务端预览数量一致。
  • 改变未付款筛选或角色权限后,旧选择令牌被拒绝并要求重新确认,不能继续发送提醒。
  • 批量结果按发票 ID 对账,成功、无权限、已支付和不存在分别计数,失败项可单独导出。

案例 2:安全平台查看上万条审计事件 ​

约束与输入 ​

  • 每天 200 万事件;只读;事件时间和接收时间分开。
  • 用户需要键盘查看详情并复制事件 ID。

处理过程 ​

  1. 使用服务端游标分页,不计算巨大页码偏移。
  2. 表格只展示关键列,详情通过相邻抽屉读取。
  3. 时间列显示时区并保留机器可读时间。
  4. 虚拟化只在性能证据需要时启用,并测试读屏行列信息。
  5. 导出作为后台任务按当前授权重新过滤。

失败分支 ​

虚拟滚动让读屏只感知 20 行,却宣称总计 20,000 行。若无法完整实现 grid 虚拟化语义,应改用分页静态表格。

专属验证 ​

  • 读屏抽查事件时间、主体、动作三列,任一数据单元格都能取得正确列头,不出现复制固定列的重复内容。
  • 在 200 万事件数据上比较游标分页与虚拟化;若虚拟化不能保持总行数和行索引,则交付方案必须回退到分页。
  • 从事件行打开相邻抽屉再关闭,焦点返回原事件 ID;该行滚出窗口后按既定规则恢复可见位置。
  • 导出任务使用当前授权重新查询,文件中的首尾游标、时区与界面筛选摘要一致。

语义与键盘 ​

  • 读取表保留原生 table、caption、thead、tbody 与 th 关系。
  • 排序按钮位于列头内,当前排序列使用 aria-sort;结果更新后焦点仍在按钮。
  • 行选择复选框名称包含对象标识,表头复选框明确“本页”还是“当前筛选全部”。
  • 水平滚动限制在带名称的表格容器,固定列不复制第二套可访问单元格。
  • 只有实现完整方向键与编辑模式时才使用 grid;普通表格保持浏览器表格导航。
  • 批量操作逐项返回状态,失败行可以定位、下载或在权限允许时重试。

Table 数据表格工程实现 ​

1. 静态读取表使用原生 table。表头按钮置于 th 内,aria-sort 只放当前排序列。 ​

列头用 scope="col",复杂分组表头按结构使用 scope 或 headers/id 建立对应关系。排序按钮的名称保持列名,排序状态由当前表头的 aria-sort 表达;切换排序后焦点留在按钮,并说明新的顺序。

2. 交互 grid 采用 roving tabindex;方向键在单元格移动,Tab 进入/离开 grid 或按产品编辑模型处理。不要把普通表格加 role=grid。 ​

只有需要单元格导航、选择或编辑时才承担 grid 的键盘责任。组件状态应保存活动行列,方向键只改变活动单元格;进入编辑模式后,文本框、选择框等内部控件接管按键,Escape 恢复到单元格导航。

3. 跨页选择保存 explicit IDs 或冻结 queryId。筛选、排序、权限或快照改变后,旧 queryId 失效。 ​

少量选择直接提交对象 ID;“选择全部查询结果”则由服务端生成带过期时间和查询摘要的选择令牌,并允许记录排除项。执行批量操作时服务端重新授权每个对象,返回成功、已变化、无权限和不存在等逐项结果。

4. 虚拟化必须维护稳定 row ID、rowindex、rowcount 和表头关系;无法验证读屏时回退为分页。 ​

回收 DOM 行时不能把视觉索引当对象 ID,焦点、选择和更新都必须绑定业务主键。对于 ARIA grid,aria-rowindex 表示该行在完整集合中的一基位置,aria-rowcount 表示已知总数;滚动卸载活动行前需要先确定焦点迁移策略。

5. 固定列由同一语义表格实现,不复制出两个无法关联的表。 ​

可使用 position: sticky 固定同一表格中的表头和首列,并处理层叠顺序、背景及滚动容器。若为视觉效果复制首列,会产生重复朗读、行高错位和两个滚动区域;必须避免这种拆分或隐藏重复副本且证明表头关系仍成立。

6. 导出在服务端按冻结筛选、列、时区和当前授权重新执行。 ​

导出任务应保存请求者、查询版本、字段集合、币种与时间格式,并在生成时再次执行行级和列级授权。文件完成后提供行数、生成时间和失败原因;超大导出采用异步任务与短期下载地址,不把当前页面 DOM 拼成权威数据。

Table 数据表格调试 ​

  • 检查表头 scope/headers 与 aria-sort。
  • 用两列同名显示值验证稳定行 ID。
  • 选择本页后升级为全部,再改变筛选。
  • 让另一会话删除已选行并提交批量操作。
  • 用 20,000 行测试分页、虚拟化、焦点和内存。
  • 对比界面金额、导出金额和数据库币种。

调试记录列定义、表头关联、排序原始值、查询快照、选择令牌与批量逐项结果。虚拟化场景还要保存活动行 ID、ARIA 行索引、DOM 窗口范围和滚动后焦点,避免只验证视觉行号。

Table 数据表格发布检查 ​

  • 表头与单元格关系可由读屏取得
  • 排序后焦点留在触发按钮且结果被说明
  • 跨页选择数量与服务端作用范围一致
  • 虚拟化不会把总行数伪装为可视行数
  • 列固定和横向滚动不破坏键盘顺序
  • 逐项结果可以下载和重试

失败注入包括同值排序、空单元格、超长文本、总数变化、已选行被删除、导出期间权限撤销和虚拟行回收。所有结果按稳定主键合并,旧快照选择不得静默作用于新查询。

综合练习 ​

实现发票表:4列、服务端排序、游标分页、本页/全部选择、逐项批量结果。另实现静态 table 与 grid 两版并说明为何最终只选一版。

验收分别实现读取表与可编辑 grid,证明二者键盘模型没有混用。使用 20,000 行验证排序、分页或虚拟化、跨页选择、批量部分失败及导出对账;读屏能取得每个数据单元格对应表头。

Table 与 Grid 的选择 ​

<table> 表达二维数据关系。浏览器与辅助技术能够识别表格、行、列、表头和单元格。只读表即使包含链接、复选框和按钮,也不因此自动变成 grid。

grid 是复合控件。采用它以后,应用负责:

  • 只让一个单元格或行进入页面 Tab 序列;
  • 用方向键在单元格之间移动;
  • 区分导航模式与单元格编辑模式;
  • 实现 Home、End、Page Up、Page Down 等约定行为;
  • 维护 aria-rowindex、aria-colindex 与总行列信息;
  • 处理虚拟化窗口之外的逻辑位置;
  • 在删除、排序和分页后恢复焦点。

以下情况优先保留原生 Table:

  • 主要任务是阅读和比较;
  • 行内只有少量独立操作;
  • 用户不需要像电子表格一样连续编辑;
  • 分页可以满足容量;
  • 团队无法完整实现和测试 Grid 键盘模型。

以下情况才考虑 Grid:

  • 用户高频在大量单元格之间移动;
  • 多个单元格可直接编辑;
  • 方向键导航能显著改善任务;
  • 已有真实辅助技术测试和回退方案。

表头关系 ​

简单表格中,列标题使用 <th scope="col">,行标题使用 <th scope="row">。

多级表头需要确认每个数据单元格能关联到正确的上级表头。若跨行、跨列结构过于复杂,应:

  1. 简化表头层级;
  2. 拆分为多个可理解表格;
  3. 使用 headers 与 id 显式关联;
  4. 用屏幕阅读器逐列验证。

表头视觉固定不能复制出第二套只有外观、没有关系的表头。固定层应来自同一语义表格,或保证复制层完全不进入可访问树且原表头关系仍有效。

排序契约 ​

排序字段包含:

字段含义
field服务端允许排序的稳定字段 ID
directionasc 或 desc
nulls空值在前或在后
locale文本排序使用的语言规则
collation数据库或服务端实际排序规则
tieBreaker值相同时的稳定次级字段

表头按钮名称应表达动作,例如“按金额升序排列”。排序完成后,当前列的 aria-sort 表达结果。

不要用格式化文本排序:

  • ¥9,000 与 ¥100 应按数值;
  • 2026年7月 应按日期;
  • “高、中、低”应按业务枚举;
  • 缺失值位置应固定;
  • 相同值应使用稳定次序,避免翻页重复或丢行。

跨页选择 ​

跨页选择至少支持两种范围:

显式 ID ​

保存用户逐项选择的稳定 ID。适合数量有限、需要精确复核的任务。

冻结查询 ​

保存查询指纹、快照版本和排除 ID:

json
{
  "kind": "frozen-query",
  "queryId": "invoice-open-v27",
  "snapshotVersion": 27,
  "total": 312,
  "excludedIds": ["invoice-91"]
}

界面必须显示“已选择当前筛选中的 311 项”,不能只显示复选框勾选。

筛选、排序、租户、权限或快照改变时:

  • 旧范围失效;
  • 已成功对象不能自动重新处理;
  • 用户重新确认新数量;
  • 服务端按当前授权再次过滤;
  • 结果返回成功、失败、跳过和已失效。

虚拟化边界 ​

虚拟化减少 DOM 数量,但增加语义和焦点成本。

检查:

  • 读屏能否取得逻辑总行数;
  • aria-rowindex 是否从完整集合计算;
  • 滚动回收行时焦点是否消失;
  • 排序后焦点对象是否仍存在;
  • 当前选择是否依赖可见 DOM;
  • 浏览器查找是否只搜索可视行;
  • 打印与导出是否覆盖完整结果;
  • 动态行高是否使滚动位置漂移。

若这些条件不能稳定满足,服务端分页通常更安全。

表格错误分类 ​

错误呈现范围恢复
查询失败表体保留表头、筛选和重试
单行数据缺失该行标记字段并允许查看详情
批量部分成功逐行只重试失败 ID
权限撤销页面或字段重新授权并解释范围
快照过期选择与写操作刷新并重新确认
导出失败后台任务保留查询并重新生成

复杂 B 端表格配置 ​

信息层级与默认列 ​

默认列由最高频比较任务决定,不由后端字段顺序决定。对象标识、当前状态和主比较值优先;低频详情、内部 ID 和只在异常时需要的字段进入详情或列配置器。默认列必须在常见桌面宽度下保留主任务,不以横向滚动隐藏关键状态。

列定义包含稳定 columnId、标题、数据类型、单位、格式化、排序能力、筛选能力、权限要求、默认宽度、最小/最大宽度和固定资格。展示名称可以翻译,保存配置不能使用翻译后标题作主键。

列配置与保存视图 ​

列配置支持显示/隐藏、顺序、宽度和允许固定的列。至少提供键盘可操作的移动方式,拖拽不是唯一入口。恢复默认值只重置列设置,不应清空用户筛选或业务数据。

保存视图是一份带版本的查询与呈现配置:

json
{
  "viewVersion": 3,
  "columns": ["invoiceNo", "supplier", "amount", "status"],
  "sort": [{ "field": "amount", "direction": "desc" }],
  "filters": [{ "field": "status", "op": "eq", "value": "open" }],
  "density": "compact"
}

重新打开视图时,服务端或受控配置层删除已失权、已弃用或不再支持的字段,并向用户说明视图已调整。公开共享视图不能携带创建者的权限;每个查看者按自身数据范围重新查询。

固定列与横向滚动 ​

固定列只保留识别当前行和执行核心任务所需内容。固定过多会压缩可滚动区域。固定层、滚动层和表头必须来自同一逻辑表格,行高和焦点不能形成两套对象。

横向滚动容器具有可访问名称,键盘可到达,并在边缘提供非颜色的溢出提示。窄屏应评估是否改为摘要列表加详情,而不是无限压缩列。

不可选行 ​

不可选行保留行内容并说明原因,例如“已结算,不能再次付款”或“你没有付款权限”。表头全选只作用于当前合法范围,摘要同时显示可选与不可选数量。

服务端仍逐项授权;前端禁用复选框不能阻止构造 ID。若原因对用户不可公开,使用最小必要说明并提供合法处理路径。

行内编辑、树形数据与保存 ​

行内编辑需要明确浏览模式和编辑模式、原值、草稿值、校验、保存中、成功、失败与冲突。批量编辑不能把一个字段的错误覆盖整行;保存结果按稳定行 ID 和字段 ID 返回。

树形表格同时表达父子层级与列关系。展开状态、选择范围和聚合值要定义:选择父节点是否包含未加载子节点、移动节点是否改变权限、折叠后活动焦点如何恢复。无法完整实现 treegrid 键盘模型时,使用树导航进入普通子表格。

权限字段与大数据 ​

字段权限必须在查询、排序、筛选、列配置、导出和聚合中保持一致。隐藏列不能仍出现在 URL 建议或排序白名单;脱敏值不能作为导出原值。

大数据先选择服务端筛选、稳定排序和游标分页。只有真实测量证明分页不足时才引入虚拟化;虚拟化需要维护逻辑行列总数、稳定焦点、动态行高和辅助技术可用性。

专项验证 ​

  • 保存视图后撤销一个字段权限,重新打开不泄露字段且提示调整;
  • 列标题切换语言后仍按稳定 ID 恢复配置;
  • 固定列、200% 缩放和窄屏下焦点始终可见;
  • 全选 500 项时明确排除 17 个不可选对象;
  • 编辑期间服务端更新同行,保存进入字段级冲突而非静默覆盖;
  • 树节点折叠、移动和懒加载后选择数量与服务端一致;
  • 200 万行查询的 UI、导出与权限范围可以对账。

来源 ​

从前端走向软件产品工程的长期路线图。