Files
lpt-fe/roles/design-principles.md
T

55 lines
4.9 KiB
Markdown

# 前端设计原则
- **功能**:规定页面的信息架构与视觉层级取舍,并列出「模型默认做法」禁用清单,保证每屏只服务一个主任务、层级靠对齐与留白而不是靠堆容器与装饰。
- **何时用**:新增页面或重构页面结构时;决定某块内容放主区还是收起时;评审 UI 层级时。出现新页面或大范围 UI 改动时,须同时走 `skills/ui-review/`(见下「独立评审」)。
## 规则
### 页面信息架构
- **一屏一个主角。** 动手前先回答「用户来这一屏是看什么、做什么」,让那件事占据最大面积与最强对比;其余信息靠更小的字号、更轻的字重、更低的对比或靠边的位置退到后面。同一屏里不让两种强调同时抢注意力。
- **内容先行,页面不自述。** 内容型页面的首屏就是第一排内容本身或工作区;**不放"这个页面是干什么的"说明段落**。页面标题已说清的事不再补一行副标题;操作提示放控件附近(`.scope-field` 的 label、输入框 placeholder),不放页面顶部当导语。
- **低频操作不进工具栏,主操作只有一个。** 主操作显眼且每屏不超过一个;次级操作视觉从属(`plain` / 默认尺寸);**更低的低频操作收进「更多」下拉或设置入口**,不要一排等权按钮平铺。
- **按用户心智分模块,不按实现分按钮。** 同一件事的多个入口是两个并列的**内容区块**(各自有标题、说明与主入口),不是工具栏上的两个按钮。
- **渐进披露。** 复杂或低频的选项默认收起(折叠区、弹窗、抽屉),用户需要时展开;不要把全部字段、全部说明一次铺满首屏。
- **待办与汇总各成一块。** 需要用户处理的内容(待归类等)独立成块并给出条数;纯指标汇总独立成块,不与待办混排。
### 视觉层级
- **间距表达分组:** 同一种关系用同一种间距;一组之内紧(8–12px),组与组之间松(14–24px)。先用对齐和留白立结构,再考虑容器与分隔线。
- **分隔线只做一件事:** 同一处分隔不叠双线、不「线 + 边框框」重复;留白已经分开的地方不再补线。全页线的粗细一致,粗细差对应层级差。
- **容器只在必要时加:** 需要分组、表示选中、拉开背景对比或划出操作范围时才用 `.surface-card`。不要把页面、区块、条目、条目说明一层层套成卡片。
- **同层级等重:** 同一层级的卡片看起来一样重;嵌套的圆角与外层协调(内层 ≤ 外层)。
- **每屏过一遍减法:** 逐区块删文字与装饰,只把删了会影响理解的放回去。删完主角没有变大变强的,说明删得不对或本来就不该有。
### 模型默认做法禁用清单
以下写法是 agent 生成界面的默认倾向,不是经过判断的选择;除非能说出**来自本产品的理由**,一律不用:
- 层层套卡片、每个层级都画一遍边框线。
- 单侧彩色边条(引文、当前项左侧加一根色条)。
- 每张普通卡片配不同的强调色、粗边框、重阴影。
- 标题上方加全大写小眉标;meta 信息用 `A · B · C` 串起来。
- 无来由的渐变、发光、emoji 当图标。
- 全站统一的「淡入上移」入场动画;每张卡片都有的 hover 位移。
- 空泛文案:「了解更多」「立即开始」「高级」「丝滑」「无缝」。
- 组件库默认样子只改主色(换了主色也认不出是哪个产品)。
- 数字指标配一个大号数字 + 大渐变强调色(默认处理,不是最优处理)。
### 文案即设计
- 按钮说清按下去会发生什么(「保存草稿」而不是「提交」);同一动作在整个流程中同名——按钮写「发布」,成功提示就写「已发布」。
- 用用户能理解的语言命名,不用系统内部叫法;不写设计说明类文字进界面(「示例」「示意图」「仅保存在本机」)。
- 错误说清**原因 + 怎么修**,不道歉、不含糊;空状态给下一步动作,不给情绪。
### 独立评审
- **触发条件:新页面,或大范围 UI 改动**(整页重构、视觉语言变更、新增信息区块),交付前必须走 `skills/ui-review/`:取图 → 派无上下文的独立评审者 → 按清单修 → 下一轮逐条核对。
- 小改动、局部低风险调整不走技能,按 `roles/ui-review-checklist.md` 自检即可。
- 评审结论(轮次、分数或问题处理情况)写进交付说明;没做独立评审的,明确写出来。
### 设计系统锚点
- 调性、色板/间距/文字角色/组件语法的**当前取值**见 `roles/design-system.md`;新增颜色、间距、圆角、字号先在那里登记,再落 `src/assets/main.css` 的变量。
- 组件里禁止写颜色字面量(既有规则,见 `roles/code-standards.md`)。