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 对应组件或变体的说明,并在前端组件文档放相同案例编号;具体属性名以项目实际实现为准,不把设计工具中的变体标签误写成已经存在的代码接口。

交付评审时分别抽查三个任务:打开详情、复制链接、永久移除。让一位未参与设计的同事只读规范做选型;若他能明确指出使用什么组件、禁止什么组合、失败后显示什么信息,且与设计稿和实现一致,这份选型文档才算可执行。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写组件选型和禁用案例

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通