定义颜色系统的规则、预期用途、允许的变异、示例和一致性要求。该参考规范确定采用边界、失败行为和可观察证据,同时允许配置环境特定的限制。
包状态: 参考上下文,准备人工审查。合同和测试场景已完成,但不保证采用的实现已通过测试。
决策
对于颜色系统,采用设计和实现共享的版本化设计令牌和组件合同。定义一个确定性的用户旅程,具有可见状态、可逆选择(尽可能)、保留输入和可访问的恢复。此 UX 模块专注于规范和使用。该包为参考合同:采用团队必须根据自身环境中的证据选择数值限制、提供者、管辖区和运营负责人。
范围
- 颜色系统的参与者、输入、输出、状态、策略或模式版本,以及规范和使用重点所需的外部可见结果。
- 主要和备用接口、后台工作、缓存、集成、支持路径及可行使相同边界的证据。
- 采用特定的配置、推广、恢复和验证职责,以安全应用该参考。
不包含内容
- 为每个采用者选择通用供应商、框架、管辖区、数值阈值、保留期限或服务级别目标。
- 声称已针对下游实现运行打包场景,或该参考授予法律、安全或无障碍认证。
合同
- 按语义目的命名令牌;当存在语义令牌时,产品代码不依赖原始调色板、间距或排版值。
- 在同一合同中定义允许的变体和状态,包含无障碍行为、内容约束和响应行为。
- 将破坏性令牌或组件更改视为迁移,包含所有权、兼容性说明和可测量的采用情况。
- 使用视觉检查作为变更证据,而非语义、键盘操作或可访问名称的唯一测试。
- 仅在工作实际待处理时显示进度,防止重复激活且不隐藏用户已确认的意图。
- 使用简单、针对操作的消息,区分验证、许可、连接、冲突和终端失败。
- 为文本、表面、边框、焦点、操作、数据和状态定义语义颜色令牌,涵盖每个主题和状态,测量前景与背景对比对。
- 将原始调色板值隐藏在令牌后,强制颜色和打印模式下保留含义,并在颜色传达状态时与文本、形状、图标或位置配对。
- 对于规范和使用变体,强制执行此声明边界:定义颜色系统的规则、预期用途、允许变异、示例和一致性要求。
实施指导
- 在锁定主路径布局前,原型最长、空白、缓慢、离线、拒绝和辅助技术路径。
- 在选择框架或供应商细节前,建模颜色系统的输入、输出、参与者、状态、不变量、副作用和证据。
- 将适用的颜色系统合同或策略版本与物料状态一起存储,以便迁移、重放和支持决策可追溯。
- 在受控推广后引入路径,比较预期与观察结果,保持经过测试的恢复路线,直至采用证据完整。
失败处理与保障措施
- 未知令牌或变体在开发中明显失败,发布客户端使用文档化的安全回退。
- 无效或矛盾的颜色系统状态被拒绝或隔离;实现绝不猜测会扩大权限或重复效果的值。
- 重试有界且使用持久身份;耗尽后,工作进入可检查的终端状态并有责任人。
验证与运营
- 使用键盘、触摸、屏幕阅读器、窄视口、延迟网络和可恢复服务器错误完成旅程。
- 按合同版本监控颜色系统的成功、拒绝、验证失败、依赖失败、重试耗尽和恢复,不包含敏感负载维度。
- 策略、模式、依赖、迁移或边界变更后,重新运行配对的正负测试用例并保留结果证据。
采用假设
- 示例中的名称和值为具体测试用例,不是通用默认值;采用者通过文档化证据和所有权替换它们。
- 采用系统能提供认证身份、持久操作或记录版本、有界遥测和受控变更路径。
本包中看似可执行的示例为测试用例和验收合同。运行集合验证器检查结构和元数据,然后在目标仓库中翻译并执行场景,最后记录实现证据。