UI设计:构建界面规则
这些规则提炼自《UI设计原则》(Michael Filipiuk,2021版)。本文件包含适用于每个屏幕的规则。references/(位于本文件旁)按主题分文件存放详细内容;仅读取任务涉及的主题文件。
无标签的规则来自原书。(WCAG) 表示书中未提及的无障碍标准。(convention) 表示填补空白的常见行业惯例。(derived) 表示使用原书方法计算出的值。原书中1pt = 1 CSS px = 1 iOS pt = 1 Android dp。
仓库设计系统优先
如果仓库已有token或主题(Tailwind配置、CSS变量、shadcn/MUI主题、components/ui/库),请使用它们。本技能仅补充未定义的内容。
- 绝不在仓库自有token旁引入第二套token。
- 重用现有组件,而非构建平行组件。
- 当仓库本身违反了以下规则(例如对比度不合格、32px按钮),保留仓库的值并报告冲突。不要静默覆盖。
规则冲突时的优先级: 可用性 > 无障碍 > 一致性 > 简洁 > 外观。
快速路径
- 首先确定个性: 基于品牌和受众(
references/personality-and-copy.md)选择俏皮、中性或严肃。勿用个人品味。 - Token先于屏幕: 从仓库或
references/tokens.md获取颜色、字体和间距标尺。只使用这些值。 - 灰度优先: 先处理好层级、布局和间距,仅在需要的地方添加颜色。
- 组件包含所有状态(默认、悬停、按压、聚焦、禁用、错误、成功),且每个屏幕都包含所有状态(空态、加载态、错误态、404)。
- 在报告完成前: 针对构建的内容检查
references/checklist.md。如果可以截图,请检查截图而非代码。
不可协商规则
- 间距必须来自标尺。 移动端使用4pt标尺,Web端使用8pt标尺。不允许出现5、13或22px的值。
- 正文字体大小为16-17px。 任何文字不得低于10px,建议12px以上。小字号上绝不能用Light字重。
- 使用一款字体, 默认为无衬线字体。大约使用5种字号。
- 绝不用
#000000表示文字或阴影。使用深色灰调如#1F1F1F。 - 使用一种主色, 仅用于必须突出的元素。如果所有内容都突出,则无突出。
- 对比度: 正文字体4.5:1,大文字和UI部件3:1 (WCAG)。
- 绝不要仅用颜色 传递含义。错误、成功消息和链接也应配图标、文字、字重或下划线。
- 每个点击或触摸目标至少44×44, 即使可见图标更小。
- 按钮高度为40-60px, 每组中只有一个主按钮。按钮成对出现时,主按钮放在右侧。标签精确说明操作结果。
- 输入框始终有可见标签。 占位符不能作为标签。使用单列表单并启用内联验证,绝不清空用户输入。
- 阴影柔和(大Y偏移、大模糊半径、5-10%不透明度),仅用于交互或抬升元素。
- 图标来自同一图标包, 风格一致,具有相同的描边宽度和圆角。不通用图标需配有标签。
- 动画提供反馈, 持续时间小于1000ms,并采用缓动(绝不用线性)。
- 不用Lorem Ipsum。 写真实、简洁、人性化的文案。错误信息说明如何解决问题。对话框明确对象和后果。
- 相同内容在跨屏中具有相同的外观和行为。 遵循平台模式。
读取哪个引用文件
| 任务涉及 | 读取 |
|---|---|
| 新项目或主题、选择值 | tokens.md(间距、字体标尺、颜色角色、圆角、阴影、动效、起始CSS) |
| 页面或屏幕布局、网格、间距、层级 | layout.md |
| 文字样式、标题、段落 | typography.md |
| 调色板、暗黑模式、阴影、渐变 | color-and-depth.md |
| 按钮和行动号召 | buttons.md |
| 表单、输入框、选择器、复选框、校验 | forms.md |
| 卡片、列表项 | cards.md |
| 图标 | icons.md |
| 标签栏、顶部导航、侧边栏、链接 | navigation.md |
| 照片、插图、空态和404艺术 | imagery.md |
| 品牌感觉、按钮标签、对话框、错误、语气 | personality-and-copy.md |
| 过渡、悬停、加载、反馈 | motion.md |
| 对比度、替代文本、目标、说明文字 | accessibility.md |
| 可重用组件、状态、空态/404屏幕、设计系统 | system-and-states.md |
| 审查完成的屏幕 | checklist.md |
所有路径均位于本技能的references/文件夹下。