SuperAPI AI 工具集

table

前端与建站

查看项目

更新于 10-16 04:08

技能介绍

该技能是一个关于“数据表格(Data Table)”的 UX 模式说明,核心用途是在界面中以行和列的形式展示结构化数据,让用户可以扫描、比较、分析并高效地与较大的数据集交互。

【用途】 适合展示包含多个属性的结构化表格数据;当用户需要跨多条数据进行比较时使用;用于支持对数据集进行排序、筛选和搜索;适合展示财务数据、库存、用户列表或分析数据;当数据关系用网格形式最易理解时使用;用于支持对多条数据执行批量操作;也适合需要便于导出的数据呈现。

【不适合的场景】 文中说明以下情况应避免使用表格:属性很少的简单列表(应改用 List View);数据存在复杂层级关系(可考虑 Tree View);内容繁重的条目(应使用 Card Grid 或详情视图);缺少响应式替代方案的小屏移动端;对实时更新有强需求时(可考虑实时数据流);非结构化或叙述性内容(应使用 Expandable Text)。

【实现工作流】 文档给出的流程包括:在复制示例前先确认该模式与问题及约束是否匹配;从 references/pattern.md 中的结构与示例入手,再选择最小可行的变体;在叠加视觉打磨之前,先落实无障碍、性能和交互护栏;使用测试指引验证键盘、屏幕阅读器、响应式以及失败场景下的行为。

【无障碍与性能要点】 文档讨论了客户端与服务端排序/筛选的适用判断,并列出客户端适用的条件:少于 1,000 行、用户需要快速交互式筛选、完整数据集已加载、需要离线功能、需要复杂多列排序。示例场景包括记录数小于 500 的管理后台仪表盘,以及设置或配置表格。性能护栏给出目标指标:首屏 50 行初始渲染 <300ms,1000 行排序操作 <100ms,筛选应用(带防抖)<200ms,虚拟滚动保持 60 FPS,10,000 行内存占用 <50MB。

【常见错误与修复】 一是一次性渲染所有行,会带来严重性能问题、滚动缓慢甚至浏览器卡死,修复方式是使用虚拟滚动仅渲染可见行(如 TanStack Virtual 或自建虚拟化方案)。二是没有移动端替代方案,强制用户在移动端横向滚动桌面表格体验差,修复方式是提供移动端专用视图,如 Card Grid 或堆叠的键值对;必须横向滚动时可考虑固定首列。三是功能过载,一次展示全部筛选、导出、列切换等功能会淹没用户,修复方式是渐进式披露,先保留搜索、排序等核心控件,再通过设置菜单或“高级”按钮暴露复杂功能。

【相关模式】 文档列出了 Accordion、Expandable Text、Modal、Tooltip、Card Grid、Dashboard、Filter Panel、List View、Tree View、Checkbox、Search Field、Pagination、Empty States、Notification、Skeleton 等相关页面链接。完整实现细节、示例与测试说明需参见 references/pattern.md。模式页面为 https://uxpatterns.dev/patterns/data-display/table 。