DESIGN HANDOFF · 设计交付

组件状态矩阵生成器

设计评审总漏状态?把组件清单 × 状态集合交给工具:选默认、悬停、焦点、按下、禁用、加载、错误、空态,一键生成可交付的矩阵表,每格给出背景/边框/光标/ARIA 的 token 建议,右侧还能实时预览按钮各状态,可直接复制进 Figma 备注或导出 CSV 给前端。

1定义组件与状态

矩阵与预览将按主色推导各状态 token

2状态实时预览

* 预览为示意效果:focus 环、禁用透明度、加载转圈、错误红边、空态虚线框,均按下方矩阵规则渲染。

3组件 × 状态交付矩阵

412 组件预设 · 状态迁移图 · 覆盖审计

点选任一组件预设,自动带入该组件的推荐状态组合并刷新上方矩阵;下方审计区实时标出八个状态是否已覆盖,可逐项勾选「已验收」跟踪进度。

当前 0 个组件

状态覆盖审计 0 / 8 已覆盖

验收进度 0 / 8

状态迁移图 · 自绘 SVG

focus-visible 焦点环适用于全部可聚焦态,不单独成为流程节点。

状态 → 选择器 / ARIA 对照

状态CSS 选择器ARIA / 属性键盘行为
default 默认.btn无(优先用原生元素)Tab 可聚焦,Enter/空格触发
hover 悬停:hover无触屏无悬停,不作为唯一提示
focus 焦点:focus-visible无(勿移除 outline)Tab 到达,焦点环清晰可见
active 按下:activearia-pressed(切换按钮)按住触发,反馈不晚于 100ms
disabled 禁用[disabled]aria-disabled="true"不响应点击,需在页面说明原因
loading 加载[aria-busy="true"]aria-busy="true"保留焦点,阻断重复触发
error 错误[aria-invalid="true"]aria-invalid + aria-describedby焦点移入错误字段,读屏播报
empty 空态[data-empty]role="status"说明空原因并提供下一步操作

方案管理 · 数值对比 · 导出

调好的参数可存成方案随时载入,也能生成可分享链接;结果里的数值列会自动画成对比图,并支持导出 CSV / JSON。

最近方案 暂无

🧩口径说明与常见误填

组件 × 状态网格,每格给 token 与 ARIA 建议

八种状态
默认、悬停、焦点、按下、禁用、加载、错误、空态八态芯片点选组合。
token 推导
选定主色后自动推导每格背景、边框、光标与 ARIA 的 token 建议。
实时预览
右侧按钮实时预览各态效果:focus 环、禁用透明度、加载转圈、错误红边、空态虚线框。
交付导出
复制矩阵文本贴 Figma 备注,导出 CSV 进 Excel 或飞书表格做评审记录。
验收项
每格的 ARIA 标注可直接当前端组件验收清单使用。

这个工具解决什么问题

设计评审总漏状态,前端实现总缺焦点环?把组件清单与状态集合交给本工具:勾选默认、悬停、焦点、按下、禁用、加载、错误、空态,一键生成组件 × 状态交付矩阵,每格给出按主色推导的背景、边框、光标与 ARIA token 建议,右侧实时预览按钮各态效果,复制进 Figma 备注或导出 CSV 给前端。

三条交付守则

① 按钮至少七态:default、hover、active、focus-visible、disabled、loading、error 缺一不可,缺 focus 与 loading 是验收最常见扣分项。

② 空态要分三种:首次使用、搜索无结果、加载失败三种文案不同,配虚线容器与引导操作按钮。

③ 错误态必须播报:红边之外要有错误说明文字并用 aria-describedby 关联,重试按钮出现在状态内,读屏可感知。

怎么用

  1. 第 1 步 · 定义组件与状态
    组件清单每行一个,点芯片勾选状态集合,选主色(可先载入示例)。
  2. 第 2 步 · 看实时预览
    右侧按钮实时渲染各状态效果,下方同步生成组件 × 状态矩阵表。
  3. 第 3 步 · 复制或导出
    点复制矩阵文本贴进 Figma 备注或需求单,点导出 CSV 进表格做评审记录。

更新记录

  • v1.0 2026-11-02
  • 2026-11-02 上线首个版本
  • 2026-11-02 新增空态与加载态及 CSV 导出

常见问题

UI 组件状态矩阵怎么做?
行是组件(按钮、输入框、卡片、弹窗),列是状态(默认/悬停/焦点/按下/禁用/加载/错误/空态),每格写清背景、边框、文字、光标、动效与 ARIA 属性。本页按主色自动推导每格 token,生成即可交付。
按钮的几种状态设计规范是什么?
至少七态:default、hover(提亮 6 至 10%)、active(压暗并轻微缩放)、focus-visible(2px 焦点环加 offset)、disabled(透明度 40% 加 aria-disabled)、loading(转圈加 aria-busy 加防重复点击)、error(红边加 aria-invalid)。缺 focus 与 loading 是验收最常见扣分项。
有没有设计交付状态表模板?
本页生成的矩阵就是模板:每格含样式 token、交互说明与 ARIA 标注三段信息,点复制矩阵文本贴进 Figma 备注或需求单,点导出 CSV 可直接进 Excel 或飞书表格做评审记录。
组件的空状态、错误态怎么定义?
空状态要区分首次使用、搜索无结果、加载失败三种文案,配虚线容器与引导操作按钮;错误态要有红边、错误说明文字并用 aria-describedby 关联,可恢复操作(重试)必须出现在状态内。
前端组件验收清单包含什么?
对照矩阵逐格验收:视觉与 token 一致、键盘可达(Tab 顺序、Enter/空格)、focus 环可见、禁用态不响应点击、loading 防重复提交、错误播报读屏可感知、暗色模式对比度达标。本页每格的 ARIA 建议可直接当验收项。

💬 留言板 0

全部留言需审核通过后展示
💬

还没有留言,来抢沙发吧!

✍️ 说点什么
0 / 500
图形验证码
👣 做完这一步,顺便看看
🏛️ 凯撒密码解密 凯撒密码解密 :1~25 位位移加解密、ROT13 一键转换… → 🔤 乱码转换器在线修复 乱码转换器在线 :把“锟斤拷”“�”“涓枃”“😀”等乱… → 📸 代码截图美化工具 在线代码转图片工具:粘贴或输入代码(支持 JavaScrip… → 🎨 WCAG 对比度检测工具 在线颜色对比度检测工具:输入前景文字色与背景色(支持 #he… →
全部工具 →