复数化:区域行为
定义用户可见的格式化、语言选择、回退、内容行为和复数化的区域边缘情况。它修正了采用边界和可观察的失败证据,同时保持环境特定限制的可配置性。
包状态: 参考上下文已准备好供人工审查。合同和测试场景已完成,但不保证采用的实现已通过它们。
决策
对于复数化,采用规范的区域中立数据加上显式的展示区域。定义一个确定性的用户旅程,具有可见状态、可逆选择(如可能)、保留输入和可访问的恢复。此包为参考合同:采用团队必须从自身环境的证据中选择数值限制、提供者、司法管辖区和运营所有者。
范围
- 本 UX 模块描述的复数化参与者、输入、输出、状态、策略或模式版本及外部可见结果。
- 主要和备用接口、后台工作、缓存、集成、支持路径及可触发相同边界的证据。
- 采用特定的配置、发布、恢复和验证职责,以安全应用该参考。
本模块之外
- 为每个采用者选择通用供应商、框架、司法管辖区、数值阈值、保留期或服务级别目标。
- 声称已在下游实现上运行打包场景,或该参考授予法律、安全或无障碍认证。
合同
- 持久化规范值和稳定的翻译键;仅在展示或文档生成边界应用区域特定格式化。
- 通过一个确定性、可观察的链条解析请求、用户、组织和产品的回退区域。
- 使用维护的标准中的语言标签和区域数据;不要相互推断语言、地区、货币或法律条款。
- 使用代表性夹具测试扩展、复数类别、双向文本、缺失资源、时区、货币和非拉丁输入。
- 仅在工作实际待处理时显示进度,防止重复激活且不隐藏用户已确认的意图。
- 使用简单、针对动作的消息,区分验证、权限、连接、冲突和终端失败。
- 使用固定 CLDR 版本中的区域特定基数或序数复数类别,并将原始数值传递给消息格式化器。
- 测试零、一、二、小数、大值、缺失翻译和回退区域,不通过拼接单独翻译的片段构建句子。
实现指导
- 在锁定顺畅路径布局前,先原型最长、空、慢、离线、拒绝和辅助技术路径。
- 在选择框架或供应商细节前,建模复数化的输入、输出、参与者、状态、不变量、副作用和证据。
- 将适用的复数化合同或策略版本与重要状态一同存储,以便迁移、重放和支持决策可追溯。
- 在受控发布后引入路径,比较预期和观察结果,并保持经过测试的恢复路线,直到采用证据完整。
失败处理和保障措施
- 缺失或无效资源遵循声明的回退链,安全记录键和值,且绝不暴露内部标识符作为最终文案。
- 无效或矛盾的复数化状态被拒绝或隔离;实现绝不猜测扩大权限或重复效果的值。
- 重试有界且使用持久身份;耗尽后,工作进入可检查的终端状态并有责任所有者。
验证和运营
- 使用键盘、触摸、屏幕阅读器、窄视口、延迟网络和可恢复的服务器错误完成整个旅程。
- 按合同版本监控复数化的成功、拒绝、验证失败、依赖失败、重试耗尽和恢复,且不含敏感负载维度。
- 在策略、模式、依赖、迁移或边界变更后,重新运行配对的正负夹具并保留结果证据。
采用假设
- 示例中的名称和值为具体夹具,不是通用默认;采用者通过文档化证据和所有权替换它们。
- 采用系统能提供认证身份、持久操作或记录版本、有界遥测和受控变更路径。
本包中看似可执行的示例是夹具和验收合同。运行集合验证器检查结构和元数据,然后在目标仓库中翻译并执行场景,最后记录实现证据。