UI 视觉设计 / 系统课时
编写组件选型和禁用案例
编写组件选型和禁用案例
同一页面可能用按钮、链接、弹窗或提示消息完成相似任务。如果组件库只展示外观,开发者仍要临场猜测用法。本课把选型条件、禁止搭配、文案限制和验收方式写成可直接放进组件文档的规则,并以团队成员管理场景验证。
学习目标
- 根据用户意图、操作后果和反馈时效选择组件。
- 写出包含反例、替代方案和内容边界的规范条目。
- 用场景验收检查设计稿与前端实现是否遵守同一规则。
用用户任务确定组件,而不是用外观决定
先写“用户要完成什么”,再选控件。团队成员页可使用以下规则;同一任务可能同时需要触发控件、确认组件和反馈组件,它们不是互相替代的关系。
| 用户任务 | 优先选型 | 不应采用的方案 | 判断依据 |
|---|---|---|---|
| 打开成员详情页 | Link | 用无链接语义的可点击文本 | 目标是导航,应支持键盘访问及浏览器打开新标签页 |
| 复制邀请链接 | Button,成功后 Toast | 用 Link 触发复制 | 目标是执行当前页操作,而非导航 |
| 永久移除成员 | 危险操作 Button + 确认 Dialog | 点击后立即删除,仅靠 Toast 告知 | 本案例假设操作不可撤销,需要事前确认 |
| 解释成员角色含义 | Tooltip | 在 Tooltip 内放必须点击的链接或表单 | 简短非交互说明适合 Tooltip;需交互时改为 Popover 或独立页面 |

以上规则中的“禁用”指不允许使用的选型或搭配,不是把控件设为 disabled。后者表示当前不能交互,必须另外解释原因,例如“只有管理员能移除成员”。
把禁用案例写成能照做的条目
不要只写“危险操作请谨慎”。下面是一条可直接放入组件文档的案例,所有判定条件都能在设计评审时检查。
- 案例编号:DS-ACT-03;任务:从团队永久移除成员。
- 适用条件:操作立即生效、无法在当前产品中撤销,且会影响该成员访问权限。
- 推荐组合:按钮文案“移除成员”;点击后打开 Dialog,标题“移除成员张三?”,说明“移除后将失去此团队的访问权限,且无法撤销”;操作按钮为“取消”和“确认移除”。
- 禁用组合:点击危险按钮就提交;用 Toast 代替事前确认;仅将按钮涂红而不写操作后果。
- 替代方案:若产品提供可用的撤销能力,可在执行后给出带“撤销”操作的反馈,并在项目规则允许时省略确认框;必须写明撤销时限,并确保撤销入口可通过键盘访问。
- 验收条件:取消不发送删除请求;确认后提交期间阻止重复触发;失败时保留 Dialog 并显示原因及重试方式;成功后关闭 Dialog 并更新成员列表。
再为“复制邀请链接”建立相邻案例:Button 执行复制,Toast 写“链接已复制”;若复制失败,不能仍显示成功消息,应提供可重试操作。让读者能从正反例辨认边界。
规定内容长度和交互状态的边界
组件文档还要约束内容,不然同一视觉变体可能被塞进完全不同的信息。以下是示例团队的编辑阈值,并非 Figma 或浏览器的统一限制;正式采用前应在真实宽度与放大字体场景下测试。
| 内容位置 | 示例约束 | 超出后的处理 |
|---|---|---|
| 主要 Button 标签 | 优先使用 2~8 个汉字,动词加对象 | 换成更明确的短动作,不靠强制截断 |
| Toast 正文 | 优先一条消息、35 个汉字以内 | 需要解释原因或给出多步处理时改为 Alert |
| Dialog 标题 | 优先 16 个汉字以内 | 将影响范围和细节放进说明区 |
| Dialog 说明 | 优先 80 个汉字以内 | 高复杂度任务改用独立页面,避免滚动堆砌 |
对交互状态也要明写:loading 时避免重复提交;disabled 的原因应由邻近帮助文本提供,不应只藏在无法聚焦的 Tooltip 中;危险操作不能只靠红色表达,必须有明确动词和后果说明。检查 200% 字体缩放、键盘 Tab 顺序和窄容器下是否出现内容遮挡。
让 Figma 与前端共用同一份选型依据
每个组件文档至少保留“适用条件、禁用条件、替代组件、内容限制、交互状态、正反例、验收标准”七项。将规则关联到 Figma 对应组件或变体的说明,并在前端组件文档放相同案例编号;具体属性名以项目实际实现为准,不把设计工具中的变体标签误写成已经存在的代码接口。
交付评审时分别抽查三个任务:打开详情、复制链接、永久移除。让一位未参与设计的同事只读规范做选型;若他能明确指出使用什么组件、禁止什么组合、失败后显示什么信息,且与设计稿和实现一致,这份选型文档才算可执行。