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

4.9 KiB

前端设计原则

  • 功能:规定页面的信息架构与视觉层级取舍,并列出「模型默认做法」禁用清单,保证每屏只服务一个主任务、层级靠对齐与留白而不是靠堆容器与装饰。
  • 何时用:新增页面或重构页面结构时;决定某块内容放主区还是收起时;评审 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)。