# 界面基础规范

本规范用于产品研发中的页面与组件设计。它是 [UI 设计哲学](../philosophy/ui-design-philosophy.md) 的执行起点；具体产品已有设计系统时，以产品现有约定为准。新界面从少量一致的规则开始，随着真实复用再扩展。

## 信息与操作

保留完成当前任务所需的信息、操作和提示。让主要操作与重要状态容易识别；说明文字只写用户做决定所需的内容。列表、表单和详情页优先支持扫描、比较和连续操作，不把功能说明当成页面主体。

## 视觉基础

使用主题色阶与黑白色阶构成统一色板，并将颜色、间距、字级、阴影和圆角定义为全局令牌。避免靠描边堆砌层次；优先使用扁平布局、清楚的色块和克制的阴影。不要叠加多层卡片或让每个页面重复发明同一种控件。

组件应拥有明确用途和可预期的状态。只有同一种交互在多处真实出现时，才抽成共享组件；共享组件仍应允许页面表达自身的业务含义。

## 状态与反馈

每条用户路径检查加载、空数据、成功、失败和权限限制等实际可能出现的状态。提示要说明发生了什么，以及用户下一步能做什么。写入操作需要可见的处理中状态，避免重复提交带来不明确的结果。

## 适配与可访问性

窄屏和宽屏都要保证文字、控件和内容不互相遮挡；固定格式的元素要有稳定尺寸。交互控件应有可识别的名称、键盘焦点和足够明确的状态表达；不要只依靠颜色区分成功、错误或选中。

界面验收应沿真实任务路径进行，并与 [需求定义与验收](../../product/requirements/requirements-and-acceptance.md) 中的用户结果一致。