Communitygithub.com

数据表格UI系统

设计和实现一套系统化的数据表格框架,确保复杂数据集的可读性、可扫描性和结构完整性。

数据表格UI系统 是什么?

该技能(Data Table UI System)提供了一套用于组织和展示结构化、多属性数据的系统方法。它通过建立对齐、间距、层次结构和表格内交互元素的明确规则,确保大型数据集易于扫描、比较和操作。该技能支持在SaaS仪表盘(如库存、用户管理)、产品对比矩阵、日志查看器以及金融数据视图等场景中使用。其工作流程包括定义列类型与对齐方式、建立视觉层次、设置行密度、设计交互元素以及处理内容差异。同时,它还提供了决策规则(例如可扫描性规则、数字对齐使用等宽字体)和约束条件(如必须使用语义化HTML标签、满足WCAG无障碍标准)。该技能旨在帮助设计师和开发者创建既专业又易用的数据表格组件。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/data-table-ui-system

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

数据表格UI系统 是做什么的?

目的

数据表格UI系统技能提供了一种组织和呈现结构化、多属性数据的方法。它通过建立对齐、间距、层次结构和表格内交互元素的明确规则,确保大型数据集易于扫描、比较和操作。

使用场景

  • 为SaaS仪表盘设计库存、用户管理或账单视图。
  • 为电子商务或营销网站创建产品对比矩阵。
  • 为技术应用实现日志查看器或审计跟踪。
  • 以结构化视图组织财务数据或性能指标。
  • 为“数据表格”或“数据网格”建立组件库标准。

何时不使用

  • 简单的键/值对: 如果你只有两列(例如标签:值),请使用描述列表(<dl>)或简单列表。
  • 叙事内容: 长篇文章或故事应使用标准排版和章节结构,而不是表格。
  • 布局网格: 使用responsive-grid-system进行页面布局;表格严格用于数据。
  • 低数据量卡片: 如果数据高度可视化且属性较少,请使用card-ui-system以获得更好的参与度。

输入

  1. 数据Schema: 要显示的数据类型(字符串、数字、日期、布尔值、操作)。
  2. 列优先级: 哪些属性是识别身份所必需的,哪些是次要细节。
  3. 用户任务: 用户需要查找特定行、比较跨行值还是执行批量操作?
  4. 数据量预期: 典型视图中预计有多少行和列?

输出

  1. 表格结构规格: 定义区域(表头、行、单元格、表尾)及其内部间距。
  2. 对齐矩阵: 基于数据类型的水平对齐规则。
  3. 密度变体: 紧凑、标准和宽松行高的定义。
  4. 交互映射: 排序、筛选、行选择和行内操作的行为规范。

工作流程

1. 定义列类型和对齐

应用“对齐经验法则”以确保可扫描性:

  • 文本/默认: 左对齐(帮助眼睛跟随单词开头)。
  • 数字/指标: 右对齐(对齐小数点,便于快速比较大小)。
  • 日期/状态标签: 居中对齐或左对齐(取决于列宽)。
  • 操作: 右对齐(通常是最后一列)。

2. 建立视觉层次(表头)

表格表头必须清晰地区别于数据:

  • 样式: 对<th>元素使用不同的背景色、粗体或全大写样式。
  • 粘性: 对于长表格,使用粘性表头,使用户在滚动时不会丢失上下文。

3. 设置行密度和节奏

根据使用场景选择密度级别:

  • 紧凑: 高数据密度(例如,高度32px)。最适合高级用户和仪表盘。
  • 标准: 均衡(例如,高度48px)。最适合通用用途。
  • 宽松: 低密度(例如,高度64px)。最适合营销或简单列表。 使用斑马纹或微妙边框来分隔行,减少“跳行”。

4. 设计交互式数据

定义用户如何操作数据:

  • 排序: 在支持排序的表头添加指示符(箭头)。
  • 行状态: 定义行的悬停、选中和聚焦状态。
  • 批量操作: 如果需要,在最左侧添加一个复选框列。

5. 规划内容差异

处理数据长度的边界情况:

  • 截断: 对不重要且过长的标识文本使用省略号。
  • 换行: 对重要的描述性文本允许换行。
  • 固定宽度: 为稳定的列(例如,状态、日期)分配固定宽度,为主要标识符列(例如,名称)分配流体宽度。

决策规则

  • 可扫描性规则: 第一列应始终是最重要的标识符(例如,名称、ID),作为行的锚点。
  • 数字对齐: 如果主要任务是数值比较,则对数字使用等宽字体,以使数字完美对齐。
  • 斑马纹与边框: 对于非常宽的表格,使用斑马纹帮助眼睛水平跟踪;对于较短、较简单的表格,使用边框。
  • 操作位置: 将操作分组放在最后一列,或使用可见的“更多”菜单保持界面整洁。
  • 空单元格: 切勿让单元格留白。使用破折号(—)或“N/A”来确认数据缺失,而不是加载错误。

约束条件

  • 无障碍性: 必须使用语义化的<table>标签。表头必须有scope="col"。必须使用表格标题(<caption>)提供上下文。粘性表头不得遮挡滚动到其下方的单元格或行操作的焦点指示器(WCAG 2.2 SC 2.4.11)。行内操作按钮/链接必须满足24x24px的最小触控目标尺寸(SC 2.5.8)。
  • 响应式: 当视口缩小时,表格必须遵循responsive-data-tables模式(滚动、堆叠或切换)。
  • 对比度: 表头文本和状态指示器必须满足WCAG AA级(4.5:1)。

常见失败模式

  • 数字未对齐: 左对齐数字使得无法快速比较大小。
  • “文字墙”: 使用高密度行但不采用斑马纹或清晰的表头区分,导致“视觉疲劳”。
  • 不可见的表头: 表头看起来与数据过于相似,使得难以知道列代表什么。
  • 缺少操作提示: 单元格内的按钮或链接太小,无法点击或看起来不可交互。
  • 缺少空状态: 显示空白表格而没有“未找到结果”的消息。

验证标准

  • 列对齐遵循数据类型规则(文本=左对齐,数字=右对齐)。
  • 表头视觉上区别于行数据。
  • 主要标识符锚定在第一列。
  • 使用语义化HTML(<table>,<th>,scope)构建结构。
  • 空单元格使用占位符(例如,—)而不是留空。
  • 清晰地定义了交互状态(悬停/选中)。
  • 设计能够优雅地处理长内容(截断或换行)。
  • 粘性表头永远不会遮挡行或单元格操作上的焦点指示器(WCAG 2.2 SC 2.4.11)。
  • 行操作满足24x24px的最小触控目标尺寸(WCAG 2.2 SC 2.5.8)。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

相关技能