v1.3.3: 中英双语 i18n + 回归时序根治
i18n(竞品 7 家全有、Aurora 唯一还缺的一线能力) - site/i18n.js:330 条文案字典,顶栏「中 / EN」切换,偏好存 aa-lang, <html lang> 与 document.title 同步 - 设计取舍:以中文源串为字典键,而非抽象 key。中文是规范原文语言也是 app.js 现有字面量;源串作键意味着未收录文案自动回退原文,不会出现 空白或 key 泄漏 - 覆盖:导航/侧栏/首页 Hero 与设计原则/总览/快速开始/设计规范(含令牌 导出区)/For Agents 全表/更新日志/组件详情页(何时使用、API 三表、 无障碍键盘表、Do&Don't、设计契约、实现资源、相关组件)/Playground/ 主题面板/搜索弹窗/FAB 提示 - 语言感知显示:组件名主次调换(中文模式主显中文名,英文模式主显英文 名),详情页大标题不再重复;分类名走 CAT_EN 不占字典 修复回归时序(根治偶发) - DensitySwitcher 对比度偶发失败:断言在演示页内联脚本执行完之前就跑了, 读到 is-active 尚未应用的中间态(白字未落到品牌蓝底)。单页打开通过、 并发收集器里偶发失败 - 根因是固定帧数等待(load + 双 rAF)在多个 iframe 抢主线程时不够稳。 改为就绪轮询:readyState === 'complete' 且 DOM 连续 3 次采样(约 48ms) 无变化才断言,另设约 4.8s 超时兜底 - 验证:四次连跑全部 100%,偶发不再复现 修复 i18n 接入中的三个真实缺陷 - TDZ 顺序:KIND_KEYS 等模块级常量在 I18N/T 定义前调用 T(),抛 Cannot read properties of undefined。改为存中文源串、渲染时求值 (模块级预先求值还会导致语言切换后不更新) - 局部变量遮蔽:renderDesign 内原有 var T = data.tokens 遮蔽全局翻译 函数,导致设计规范页整个渲染失败。改名 TOKENS - 模板拼接括号:el() 调用在包装 T() 后少一个右括号 验证 - 9 个路由 × 2 语言全部正常渲染(中英文内容均非空且确实不同) - 回归保持 100%:961 断言 / 925 通过 / 0 失败 / 79 页全通过 / N/A 36
This commit is contained in:
+4
-2
@@ -2,7 +2,9 @@
|
||||
|
||||
> **修复进度(2026-09-10 v1.3.0)**:v1.1.1 完成 A1 搜索增强、A2 For Agents + llms.txt、A3 站内 Changelog + 版本同步、B2 暗色令牌映射、B4 主题预设库;v1.2.0 完成 B1 契约第一批(21/79)、B3 Playground、C1 交叉引用、C3 headless 回归骨架、C4 静态薄壳 + sitemap。
|
||||
>
|
||||
> **v1.3.2(本次)**:契约第三批 43 份落地,**79/79 全量契约化**(此前 36);新增令牌导出三格式(CSS / W3C DTCG / Figma Tokens);规格原文色彩系统同步至 AA 达标值。
|
||||
> **v1.3.3(本次)**:中英双语落地(`site/i18n.js` 330 条字典 + 顶栏切换 + 偏好持久化),覆盖全部页面;回归时序根治(DensitySwitcher 偶发失败 → 就绪轮询,四次连跑 100%)。
|
||||
>
|
||||
> **v1.3.2**:契约第三批 43 份落地,**79/79 全量契约化**;新增令牌导出三格式(CSS / W3C DTCG / Figma Tokens);规格原文色彩系统同步至 AA 达标值。
|
||||
>
|
||||
> 前序:v1.3.0 修复验收链路(测试页原以静态快照断言、剥离 script 后 DOM 为空,75.1% 属结构性误报 → 改 iframe 真实渲染 + 跨帧断言);v1.3.1 完成无障碍与令牌合规,回归达 **100%**(961 断言 / 0 失败 / 79 页全通过)。
|
||||
>
|
||||
@@ -69,7 +71,7 @@
|
||||
### P2 — 增强项
|
||||
|
||||
**问题 9:无组件交叉引用** — 无「相似组件 / 搭配使用 / 推荐·慎用」(TDesign Button 页特色栏目)。契约 JSON 已有「不发明 / 未明示 / 使用要点」字段,具备映射条件。
|
||||
**问题 10:无 i18n** — CAT_LABELS 等常量硬编码中文,无 EN 切换(7 家竞品全有双语,3 家还有 RTL)。
|
||||
**问题 10:i18n 双语(v1.3.3 已闭环)** — `site/i18n.js` 330 条字典,中文源串作键(未收录自动回退),顶栏 `中/EN` 切换 + `aa-lang` 持久化,覆盖 9 个路由与全部组件详情页。
|
||||
**问题 11:无设计资源下载** — css.json 已是结构化令牌,但没有导出 Figma Tokens / 设计资源包入口(竞品标配 Figma/Sketch 资源)。
|
||||
**问题 12:可爬取性弱** — hash 路由 SPA 全靠 JS 渲染;`data.json` 已生成(2026-09-07)但无 sitemap、无每组件静态入口,搜索引擎与 LLM 爬虫拿不到组件页内容。
|
||||
**问题 13:组件页无 FAQ**(Ant Design 每组件 FAQ 模式,高频问题沉淀)。
|
||||
|
||||
Reference in New Issue
Block a user