UI 视觉设计 / 知识点
设计系统术语速查手册
主题与适配
把 Variant、Size、State 等维度交叉展开用于检查组件覆盖度的分析方式;它帮助发现遗漏,但不意味着所有组合都必须成为合法实例。
定义
**Component Matrix(组件矩阵)**把组件的主要变化维度交叉列出,用于检查设计覆盖和 API 复杂度。
例如:
Variant × Size × State
4 × 3 × 8 = 96 combinations边界
矩阵用于分析,不代表 96 种组合都需要制作成独立资产。
最小例子
通过矩阵检查 Danger / Small / Disabled 是否已有明确样式,可以发现设计遗漏。
常见误区
当矩阵呈指数级膨胀时,不应机械补齐所有组合;更应重新检查 Variant、State 和 Property 是否划分合理。
一组 Token 映射和视觉配置,用于在保持组件语义不变的情况下切换品牌、明暗或场景表现;组件应尽量依赖语义 Token 完成主题化。
定义
**Theme(主题)**是一组可替换的设计值映射,使同一套组件结构和语义在不同视觉环境中呈现不同结果。
结构示意
color.text.primary
├── Light → dark value
└── Dark → light value边界
Theme 通常修改 Token 值,而不是复制整套组件重新维护。
对比
- Theme:一组完整视觉映射。
- Mode:主题中的某个维度或上下文模式。
- Brand Theme:针对不同品牌的映射。
常见误区
如果切换主题需要逐个组件改硬编码颜色,说明 Token 抽象不足。
同一 Token 集在特定上下文下的一组值,例如 light、dark、compact;Mode 强调某一变化维度,具体是否独立于 Theme 取决于系统架构。
定义
**Mode(模式)**表示同一套设计语义在某个上下文维度下使用不同值。
常见示例:
- Light / Dark
- Comfortable / Compact
- High Contrast
边界
Theme 与 Mode 在不同设计系统中的建模方式并不完全一致。关键是团队必须明确两者的层级和切换规则。
最小例子
同一个 color.background.surface 在 Light Mode 与 Dark Mode 中映射到不同 Primitive Color。
常见误区
不要只因为设计工具中某项功能叫 Mode,就把所有 Variant 都重新定义为 Mode;术语应首先服从系统语义。
针对环境亮度和视觉偏好的两套明暗 Token 映射;高质量实现不是简单反相颜色,还要重新验证层级、对比度、状态和媒体资源。
定义
**Light / Dark Mode(明暗模式)**是在保持信息语义和组件行为稳定的前提下,为不同明暗环境提供一组 Token 映射。
边界
Dark Mode 不是把所有颜色做数学反相。
需要重新检查:
- Text contrast
- Surface hierarchy
- Borders
- Focus
- Status colors
- Images / illustrations
最小例子
color.text.primary 在 Light Mode 可能映射到深灰,在 Dark Mode 映射到浅灰,但语义名称不变。
常见误区
只替换背景和文字两个颜色,通常无法形成可靠 Dark Mode;交互态和浮层层级同样需要完整设计。
让多个品牌或子产品共享组件结构和行为,同时通过 Token 映射体现各自色彩、字体、圆角等品牌差异的主题策略。
定义
**Brand Theme(品牌主题)**允许多个品牌共享同一套组件架构,同时替换品牌相关 Design Token。
结构示意
Shared Components
↓
Semantic Tokens
┌──┴───┐
Brand A Brand B边界
品牌主题适合“结构与交互一致、视觉品牌不同”的场景;若产品模型本身完全不同,不应强行共用所有组件。
最小例子
同一 Button 组件在不同品牌中使用不同 Primary Color、Font Family 和 Radius,但 Variant 与状态规则保持一致。
常见误区
如果每个品牌都复制整套组件独立维护,后续功能修复和无障碍改进会重复发生多次。
规范与资产
控制单位空间内信息与控件的紧凑程度,例如 comfortable、compact;Density 通常同时影响高度、间距和排版,而不是简单整体缩放。
定义
**Density(界面密度)**描述同一界面在单位空间内承载多少信息和操作。
典型模式:
Comfortable → 更大间距与控件
Compact → 更高信息密度边界
Density 是系统级或区域级策略,通常会同时影响控制高度、Spacing、Typography 和 Table Row。
对比
- Size:单个组件规格。
- Density:整体信息密度策略。
- Responsive:针对可用空间调整布局。
常见误区
Compact 不是把整个 UI 按 80% 缩放。触控目标、可读性和无障碍底线仍然需要保持。
组件或布局根据可用空间重新排列、收缩、换行或切换模式的规则;应定义行为断点,而不是只提供几个固定画板截图。
定义
**Responsive Behavior(响应式行为)**描述组件和布局如何随着可用空间变化调整结构。
可能包括:
- Resize
- Wrap
- Reflow
- Collapse
- Hide
- Replace pattern
边界
响应式设计关注“空间变化下的行为”,不仅是桌面、平板、手机三张静态稿。
最小例子
宽屏 Data Table 显示全部列,窄屏隐藏低优先级列并提供详情入口,这是一条响应式规则。
常见误区
不要只写“768 以下变移动端”而不说明组件如何变化。Breakpoint 只是触发点,Behavior 才是设计内容。
在共享设计语言的基础上尊重 Web、iOS、Android 等平台的导航、输入和系统行为差异;一致性不意味着所有平台像素级相同。
定义
**Platform Adaptation(平台适配)**是在保持品牌和核心交互一致的同时,对不同平台的系统习惯和能力做合理调整。
边界
跨平台设计系统通常共享:
- Semantic Tokens
- Core components
- Content principles
但可能分别实现:
- Navigation
- Native controls
- Gestures
- Platform-specific behavior
最小例子
同一个“选择日期”任务在不同平台可以采用各自更符合平台习惯的 Date Picker。
常见误区
“设计系统一致”不等于 Web、iOS、Android 所有组件必须长得完全一样。
让某个局部容器或层级在不切换全局主题的情况下使用特定 Token 映射,适合深浅区域嵌套、品牌区块或特殊视觉场景。
定义
**Contextual Theming(上下文主题)**允许某个局部区域根据所在环境获得不同 Token 值,而不改变整个应用的主题。
结构示意
Page Theme
├── Surface A → default tokens
└── Surface B
└── local context → alternate tokens边界
局部主题仍应通过受控 Token 映射实现,而不是组件内部随意写特殊颜色。
最小例子
深色 Hero 区域中的按钮和文字自动切换到适合深背景的语义 Token。
常见误区
如果每个局部背景都新增一组专用组件,会造成组件复制;优先考虑上下文 Token 或受控 Theme。
治理与演进
描述布局、尺寸、Token、状态、响应行为等精确实现要求的设计蓝图,供开发、设计和测试对齐;它强调可实现与可验证。
定义
**Design Spec(设计规范 / 设计规格)**是把设计意图转化为可实现、可验证要求的精确说明。
通常包括:
- Structure
- Measurements
- Tokens
- Interaction states
- Responsive behavior
- Accessibility
边界
Spec 比视觉稿更明确,比 Guideline 更偏精确实现。
最小例子
组件 Spec 明确 Focus Ring 使用哪个 Token、距组件多少、Disabled 状态如何变化,开发与测试即可直接据此验收。
常见误区
“标了宽高和间距”不代表完整 Spec。交互状态和行为往往比静态尺寸更容易产生实现偏差。
设计系统提供的可复用资源,如图标、组件、插画、模板或变量;资产应有明确版本、授权、用途和更新来源。
定义
**Design Asset(设计资产)**是设计系统向产品团队提供的可复用资源。
可能包括:
- Components
- Icons
- Templates
- Illustrations
- Variables
- Motion assets
边界
Asset 是具体可消费资源;Foundation 和 Guideline 则更多是规则与知识。
最小例子
统一的 Icon Library 是 Design Asset,图标尺寸和使用原则属于 Foundation / Guideline。
常见误区
不要让团队从聊天记录、旧设计稿和本地文件夹复制“野生资产”。设计系统资产应该有权威来源和版本。
设计端组件与代码端组件在 API、Variant、State、Token 和行为上的对应程度;高 Parity 可减少设计可做但开发不可实现的情况。
定义
**Design-Code Parity(设计与代码一致性)**描述设计资产和代码实现是否对同一个组件模型保持一致。
检查维度
Design ↔ Code
Variant
State
Size
Token
Slot
Behavior
Naming边界
Parity 不要求设计工具和代码内部结构完全一样,而要求对使用者可见的能力和规则可以对应。
最小例子
Figma Button 有 size=xs,代码组件却没有该 Size,就是典型 Parity 缺口。
常见误区
只比较视觉截图是否一样远远不够。API 和行为不一致同样会导致设计交付失真。
集中发布组件、Token、Guideline、Pattern、迁移和版本信息的可检索入口;它应帮助用户做设计决策,而不只是展示组件 Demo。
定义
**Documentation Site(设计系统文档站)**是设计系统知识和使用指南的统一入口。
典型内容:
Foundations
Tokens
Components
Patterns
Accessibility
Releases
Migration
Contribution边界
文档站不是组件展厅。真正有价值的是帮助用户判断“用什么、为什么、怎么正确用”。
最小例子
Button 页面同时提供 Anatomy、Variants、States、Content、A11y、代码示例和 Do / Don't,而不是只放一排按钮截图。
常见误区
如果搜索不到术语、看不到版本和迁移信息,即使页面视觉漂亮,也很难成为高效的系统入口。
定义谁可以决策、如何新增或修改资产、怎样评审和发布的运行机制;治理用于控制系统长期演进,而不是单纯审批设计稿。
定义
**Governance(设计系统治理)**规定设计系统如何决策、维护、演进和承担责任。
常见问题:
- 谁拥有组件?
- 谁可以提案?
- 谁负责评审?
- 如何发布?
- 如何处理 Breaking Change?
- 旧能力什么时候删除?
边界
治理不是“核心团队什么都审批”,而是建立清晰、高效、可持续的责任和决策机制。
常见误区
没有治理时,设计系统通常会出现重复组件、长期实验功能、版本混乱和无人负责的历史资产。
规定产品团队如何向设计系统提出新 Token、组件或 Pattern,并经过提案、设计、实现、评审和维护责任确认进入系统。
定义
**Contribution Model(贡献模型)**定义系统使用者如何反向参与设计系统建设。
一个典型流程可能是:
Need
↓
Proposal
↓
Review
↓
Design + Code
↓
Validation
↓
Release边界
贡献不只是“提交代码”,还可能包含需求证明、设计、文档、测试和长期维护承诺。
常见误区
完全关闭外部贡献会让核心团队成为瓶颈;完全无门槛合并又会让系统迅速失去一致性。
明确 Token、组件、文档或平台实现由谁负责决策、维护和响应问题;没有 Owner 的资产通常会逐渐失去可信度。
定义
**Ownership(所有权)**明确某项设计系统资产由哪个团队或角色负责最终维护和决策。
边界
Owner 不一定亲自完成所有修改,但必须能回答:
- 谁评审变更?
- 谁处理缺陷?
- 谁决定兼容策略?
- 谁维护文档?
最小例子
Data Table 由 Core Components Team 所有,产品团队可以贡献,但 Breaking Change 必须由 Owner 评审。
常见误区
“大家共同负责”如果没有明确决策人,实际往往等同于没人负责。
为设计系统发布建立可追踪的版本标识,使使用方知道正在使用哪一版、发生了哪些变化以及是否需要迁移。
定义
**Versioning(版本控制)**为设计系统资产的发布建立可追踪版本。
边界
版本对象可以是:
- 整个 Design System
- Code package
- Design Kit
- Token package
- Individual component
团队应明确哪些版本需要同步。
最小例子
代码组件库升级到 4.2,而 Design Kit 仍停留在 3.x,就容易产生 Design-Code Parity 问题。
常见误区
只给代码包版本号、设计资产完全没有版本信息,会让设计师无法判断稿件使用的是哪套能力。
常用 major.minor.patch 表达兼容性影响:重大不兼容、向后兼容功能、向后兼容修复;具体采用方式仍需由团队发布策略定义。
定义
**SemVer(Semantic Versioning,语义化版本)**使用类似 MAJOR.MINOR.PATCH 的结构表达版本变化级别。
3.4.2
│ │ └─ PATCH
│ └─── MINOR
└───── MAJOR一般语义:
- MAJOR:不兼容变更。
- MINOR:向后兼容的新能力。
- PATCH:向后兼容的修复。
边界
设计系统可以借鉴 SemVer,但设计资产、Token 和组件的兼容性定义必须由团队明确。
最小例子
删除公共 Button Variant 通常比修复其 Focus 样式具有更高的迁移影响。
常见误区
不要机械认为“视觉变化一定是 PATCH”。如果变化导致大量页面必须重新验收,它可能具有更高的产品影响。
宣布某个组件、Token 或 API 不再推荐使用但暂时保留兼容的阶段;应同时提供替代方案、迁移说明和计划移除版本。
定义
**Deprecation(弃用)**表示某项能力仍然存在,但已经不建议新项目继续使用,并计划在未来停止支持或删除。
推荐信息
Deprecated
├── Why
├── Replacement
├── Migration guide
├── Deprecated since
└── Removal target边界
Deprecated 不等于立即删除,它提供了兼容迁移窗口。
最小例子
旧 InlineNotification 被新 Notification 替代,系统继续保留旧组件两个版本周期,并提供迁移表。
常见误区
只打一个 “Deprecated” 标签却不给替代方式,会把迁移成本全部推给使用团队。
会使既有使用方式无法继续工作或需要人工迁移的变更,例如删除公开 API、重命名 Token 或改变关键行为;发布前必须明确影响范围。
定义
**Breaking Change(破坏性变更)**会让现有使用者在升级后需要修改设计、代码或数据才能继续正常工作。
典型情况:
- Remove public API
- Rename token
- Remove variant
- Change slot contract
- Change behavior semantics
边界
视觉调整不一定是 Breaking;是否 Breaking 取决于对既有契约和使用方式的影响。
最小例子
把 color.text.secondary 直接删除并要求所有项目改用新名称,是 Token Breaking Change。
常见误区
不要只从“代码能否编译”判断。设计资产失效、交互语义变化也可能构成实际破坏。