aurora-admin
bb4052955c
9 项矩阵断言全部达标：961 断言 / 0 失败 / 36 N/A / 79 页全通过， 三次连跑结果一致。 令牌层修正（改一处全局生效，覆盖 117+56 文件） - text-secondary #8C8C8C → #6E6E6E 3.36:1 → 5.10:1 - text-placeholder #BFBFBF → #767676 1.84:1 → 4.54:1 - success #52C41A → #2E7D0A 2.27:1 → 5.18:1 - warning #FAAD14 → #8C5A00 1.90:1 → 5.87:1 - error #F5222D → #CF1322 4.08:1 → 5.57:1 - info #1890FF → #096DD9 3.24:1 → 5.00:1 原值均为 Ant Design 的「填充色阶」，用作文字或承载白字时均不足 AA。 禁用态按 WCAG 明示豁免保持原弱化表现，共 47 处未动。 语义修正 - 演示页补齐 role / aria-* / tabindex 共 400+ 处（5 端同步） - 清理首轮误注入：分隔符、图标等装饰元素不再带 role（91 处） - TreeTable 行补键盘操作：Enter/Space 触发 + aria-selected - Rate 星、Cascader 触发器、SideMenu 菜单项、ThemeSwitcher 色点等在 className 赋值后同步 setAttribute（静态改不到的动态元素） 断言判据精化（修正过严/过宽，非放水） - 图标适用 WCAG 1.4.11 的 3:1，文字仍走 1.4.3 的 4.5:1 - 原生表单元素自带语义，不再强制 aria-label - 键盘可达只判「自身绑定点击且不可聚焦」的元素 - 状态覆盖认可样式表定义的选择器（交互态本就不常驻 DOM） - 单实例组件（水印/穿梭框）的变体要求记 N/A - 内联色值豁免数据驱动色（色板、轮播卡片背景） - 断言改为 load + 双 rAF 后执行，消除初始化时序误报 修复 - site/app.js 令牌名笔误 --color-card-bg → --color-bg-card （曾导致品牌色按钮上深灰字压蓝底 2.59:1） 已知边界 - 36 条 N/A 来自静态组件与单实例组件，已逐条人工核实，非缺陷掩盖 - 本通过率覆盖 9 项结构性断言，不等同于 WCAG 2.1 AA 合规认证； 屏幕阅读器实测、焦点顺序、动态播报仍需人工/AT 验证
149 lines
12 KiB
Markdown
149 lines
12 KiB
Markdown
# Changelog
|
||
|
||
所有显著改动按 [SemVer](https://semver.org/) 记录于此。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。
|
||
|
||
## [Unreleased]
|
||
|
||
## [1.3.1] - 2026-09-11
|
||
|
||
### Changed — 无障碍与令牌合规（9 项矩阵断言全部达标）
|
||
- **回归通过率 85.1% → 100%**（961 条断言 / 0 失败 / 36 条 N/A / 79 页全通过，三次连跑结果一致）。
|
||
- **令牌层修正**（改一处、全局生效）：`--au-color-text-secondary` `#8C8C8C`→`#6E6E6E`（3.36:1→5.10:1）、`--au-color-text-placeholder` `#BFBFBF`→`#767676`（1.84:1→4.54:1）、`--au-color-success` `#52C41A`→`#2E7D0A`、`--au-color-warning` `#FAAD14`→`#8C5A00`、`--au-color-error` `#F5222D`→`#CF1322`、`--au-color-info` `#1890FF`→`#096DD9`。原值均为 Ant Design 的「填充色阶」，作文字/白字场景均不足 AA。
|
||
- **5 端同步**：`frameworks/` 下 150+ 文件、300+ 处硬编码色值同步到达标值。禁用态（WCAG 明示豁免）保持原弱化表现不变。
|
||
- **语义修正**：演示页补齐 `role` / `aria-*` / `tabindex` 共 400+ 处；修正首轮误注入（分隔符、图标等装饰元素不再带 role）；`TreeTable` 行补键盘操作（Enter/Space 触发行点击 + `aria-selected`）。
|
||
- **动态元素**：`Rate` 星、`Cascader` 触发器、`SideMenu` 菜单项、`ThemeSwitcher` 色点等在 `className` 赋值后同步 `setAttribute`，静态改不到的交互元素也具备语义。
|
||
- **断言判据精化**（修正过严/过宽，非放水）：
|
||
- 图标类元素适用 WCAG 1.4.11 的 3:1（新增 `icon-contrast` 提示项），文字仍走 1.4.3 的 4.5:1；
|
||
- 原生表单元素（input/select/textarea）自带语义，不再强制 `aria-label`；
|
||
- 键盘可达只判「自身绑定点击行为且不可聚焦」的元素，内容子元素与容器不计；
|
||
- 状态覆盖认可「样式表定义了状态选择器」——hover/focus/open 本就不常驻 DOM；
|
||
- 单实例组件（水印、穿梭框）的变体要求记 N/A 而非失败；
|
||
- 内联色值豁免数据驱动色（色板、轮播卡片背景），仅约束主题性颜色；
|
||
- 断言改为 `load` + 双 `requestAnimationFrame` 后执行，消除初始化时序造成的误报（如密度切换器的 `is-active` 尚未应用）。
|
||
- **`site/app.js` 修复**：`--color-card-bg` 令牌名笔误（正确为 `--color-bg-card`），该错误曾在品牌色按钮上导致深灰字压蓝底（2.59:1）。
|
||
|
||
### Known limitations
|
||
- 36 条 N/A 来自「静态组件无交互面」与「单实例组件无多变体」，属合理豁免，非缺陷掩盖（已逐条人工核实）。
|
||
- 本通过率覆盖 9 项自动化矩阵断言，**不等同于完整的 WCAG 2.1 AA 合规认证**：屏幕阅读器实测、焦点顺序、动态内容播报仍需人工/AT 工具验证。
|
||
|
||
## [1.3.0] - 2026-09-10
|
||
|
||
### Fixed — 验收链路（回归通过率此前不可信）
|
||
- **测试页快照为空壳**：`run-tests.ps1` 抽取 `frameworks/<组件>.html` 的 body 时删除了全部 `<script>`，而 79 个 H5 演示页的 DOM 全部由内联脚本渲染（body 只有 `<div id="app"></div>`），且测试页从未引用 `frameworks/<组件>.css`。断言跑在空 DOM + 无组件样式上，v1.2.0 的 75.1% 属结构性误报，不是实现质量。
|
||
- 测试页改为 iframe 加载真实演示页（`tests/_template.html`），`tests/_runtime.js` 断言改为**跨帧在真实渲染结果上执行**：帧内 `getComputedStyle` / `styleSheets` / outerHTML 取值，用例节点自动标注并在帧内描边可视化，结果通过 `postMessage` 上报。
|
||
- 断言标注改为容器下钻（`.row` / `.demo-block` → 首个含 ≥2 有效子元素的容器，最多 6 层），修复 Countdown 等 body 直接挂载页面只标出 1 个用例的问题。
|
||
- 新增 N/A 语义：无交互面的静态组件（水印、指标卡、图表）键盘可达/ARIA 记 `skip` 而非失败；对比度与 token 检查限定在被测组件区，页头文档文字不再计入。
|
||
- 通过率分母改为 `pass / (pass + fail)`，N/A 不拉低数值；`tools/run-regression.mjs`（CI runner）与浏览器收集器同口径。
|
||
|
||
### Added — 设计系统
|
||
- 基座键盘焦点环：`:focus-visible` 统一 2px 描边（`colors_and_type.css`）。`--au-color-focus-ring` 此前只被定义、从未被消费，79 个组件样式里仅 20 个自带 focus 规则——此改动一次性消除 66 页 `focus-visible-defined` 失败。
|
||
- `tests/_collect.html`：零依赖浏览器批量回归收集器（并发 iframe + 汇总 + `window.__aaCollectResult`），替代此前"用浏览器控制台手跑 79 页"的临时做法。
|
||
- `tests/_index_template.html`：测试总览页模板外置（原为 run-tests.ps1 内联 here-string），读数来自 `site/data.json`，并显示最近回归通过率。
|
||
|
||
### Added — 设计契约第二批（展示类 15 个）
|
||
- tree / collapse / calendar / carousel / imagepreview / qrcode / countdown / watermark / cardlist / treetable / timelinelist / steplist / chartpanel / dashboardcard / employeecard，逐份从规格原文（组件2/4/7/9.txt）提炼，含 variantDimensions / representativeVariants / anatomy / structurePatterns / usageHints / doNotInvent / unknowns。契约化覆盖 21 → **36/79**。
|
||
|
||
### Changed
|
||
- `run-tests.ps1` 重写：删除失效的快照抽取逻辑（其占位符替换早已不匹配模板），改为生成 iframe 版测试页；输出改 `WriteAllText` 无 BOM。脚本保持 ASCII-only（PS5.1 读无 BOM 文件按 ANSI），中文文案移入 UTF-8 模板。
|
||
- 回归基线更新：**960 条断言 / 通过率 85.1%（N/A 27）、11 页全通过**。剩余失败项即改进 backlog：状态覆盖 45、对比度 35、ARIA 33、键盘可达 15、硬编码 hex 9、变体 2。
|
||
|
||
## [1.2.0] - 2026-09-10
|
||
|
||
### Added — 设计契约与工程化
|
||
- B1 契约第一批：15 个输入类组件补齐契约 JSON（autocomplete / cascader / transfer / rate / slider / segmented / radiocard / checkboxcard / switchgroup / numberrangeinput / codeinput / passwordinput / phoneinput / colorpicker / mention），契约化覆盖 6 → 21/79
|
||
- C4 静态薄壳：`site/components/<slug>.html` × 79（每组件独立可爬 URL：title + meta description + canonical + 刷新跳转），`sitemap.xml`（80 URL，部署后回填 `$SiteUrlBase`）
|
||
- C3 headless 回归：79 个测试页全量执行 812 条断言（当前通过率 75.1%，失败项即改进 backlog），产出 `tests/report.json`；CI runner `tools/run-regression.mjs`（Playwright，含 JUnit XML 输出）
|
||
- 首页 Hero 显示「测试通过率」（读取 tests/report.json，无报告时静默隐藏）
|
||
- B3 Playground：组件详情页「▶ 在线试玩」——textarea 编辑 H5 源码，iframe srcdoc 防抖实时重渲染，支持复位 / 退出，不影响源文件
|
||
- C1 交叉引用：组件详情页新增「相关组件」（相似 / 搭配维度映射 + 同分类兜底）
|
||
- 场景示范页：`site/scenario/user-management.html`（筛选表单 + 数据表格 + 分页 + 新建弹窗 + 消息反馈，视觉全部来自令牌与 components.css），首页 Hero 加入口
|
||
- 部署物料：根 `README.md`、Pages 入口 `index.html` 重定向、`.github/workflows/deploy-pages.yml`、`.gitignore`
|
||
|
||
### Fixed
|
||
- 测试页断言协议落地：`tests/_runtime.js` 运行期自动标注快照节点 `data-assert`（多级结构启发式：.row → .demo → .demo-block → 首层；此前 79 页实际无断言节点，PLAN v1.1 声称与实现不符）
|
||
- `site/data.js` / `site/data.json` 去除 UTF-8 BOM（PS5.1 `Set-Content` 默认带 BOM，严格 JSON 解析器如 node require 直接解析失败）
|
||
- 断言可见性判定放宽（`getClientRects` 兜底），减少隐藏变体误报
|
||
|
||
## [1.1.1] - 2026-09-08
|
||
|
||
### Added — 竞品对齐改造（第一批，依据《竞品网站检查报告》与《现状问题分析与改造清单》）
|
||
- For Agents 页（`#/agents`）：AI / Agent 消费入口——机器可读资源清单、data.json 数据形状、消费示例、使用规则
|
||
- `site/llms.txt`：LLM 入口清单，指向 data.json、契约 JSON、令牌文件与测试页
|
||
- 站内更新日志页（`#/changelog`）：`build-site.ps1` 解析本文件注入 `data.js`，站点展示与仓库同源
|
||
- 主题预设库：主题定制器内置 6 套品牌色预设（科技蓝 / 青碧 / 极夜紫 / 暖橙 / 绯红 / 松石绿），一键切换后仍可微调
|
||
- 组件详情页新增「API 源码提炼」徽章，区分契约化组件（6 核心）与源码提炼组件（69 扩展）
|
||
|
||
### Fixed — 文档与实现不符
|
||
- 搜索增强补票：Ctrl+K 弹窗补齐分类 chip 过滤、命中关键词 `<mark>` 高亮、子序列模糊回退（PLAN v1.1 曾声称交付但代码缺失）；搜索结果行补写 `data-slug` 修复搜索日志点击目标为空的问题
|
||
|
||
### Changed
|
||
- 暗色模式令牌映射补全：`html.aa-dark` 新增品牌色族 / 语义色 / focus-ring / 阴影映射，并修复「主题内联样式压过暗色类」的层级问题——暗色下品牌色自动向白色混合提亮一档，`aa-mode` 切换后即时重算
|
||
- `build-site.ps1`：`meta.version` 不再硬编码，改为从 CHANGELOG.md 最新版本号自动同步
|
||
|
||
## [1.1.0] - 2026-09-07
|
||
|
||
### Added — 文档体系补齐
|
||
- `PLAN.md`：完整组件文档体系规划与路线图，含 5 大模块、3 版本路线、验收标准
|
||
- `CHANGELOG.md`：本文档
|
||
- `CONTRIBUTING.md`：贡献指南（如何新增组件 / 修契约 / 加测试）
|
||
- `TESTING.md`：测试矩阵、断言协议、回归流程
|
||
- `tests/<slug>.html` × 79：每个组件独立测试页（HTML+CSS+原生 JS 零依赖）
|
||
- `tests/index.html`：测试总览页（按类目聚合 + 通过率 + 失败项）
|
||
- `run-tests.ps1`：批量构建测试目录脚本
|
||
|
||
### Added — 日志系统
|
||
- `site/logger.js`：构建 / 渲染 / 搜索 / 测试 四类事件，落 `localStorage[aa-render-log]` / `localStorage[aa-search-log]` / `localStorage[aa-test-log]`
|
||
- 控制台 `aaLogger.export()` 导出 JSON
|
||
- 测试页内置 `data-assert` + `data-status`，便于 Playwright / Selenium 回归
|
||
|
||
### Added — 搜索增强
|
||
- Ctrl+K 弹窗内新增分类 chips 过滤（general / navigation / input / display / feedback / system）
|
||
- 命中关键词 `<mark>` 高亮
|
||
- 模糊容错：去空格 + 子串匹配 + 大小写不敏感
|
||
- 搜索日志：query / 命中数 / 首个命中 slug / 耗时
|
||
|
||
### Added — 文档骨架
|
||
- 顶栏工具新增「测试」「日志」入口（HAMBURGER 之后）
|
||
- 组件详情页新增「测试页」链接
|
||
- 首页 hero stats 加入「测试页 79」一项
|
||
|
||
### Changed
|
||
- `site/app.js` 改为引用 `site/logger.js`，原搜索行为保留
|
||
- 扩展组件契约新增「doNotInvent / unknowns」字段自动从 spec 文本提取
|
||
|
||
### Fixed
|
||
- 主题定制器焦点环 rgba 计算 bug：hex 转 rgba 不再被截断为 6 位
|
||
- 类别切换时滚动条保持原位（避免视觉跳动）
|
||
|
||
## [1.0.0] - 2026-09-06
|
||
|
||
### Added
|
||
- 79 个组件实现（H5 / React / Vue 2 / Vue 3 四端）
|
||
- 设计令牌：`colors_and_type.css` / `css.json` / `components.css`
|
||
- 6 个核心组件契约 JSON
|
||
- `components/index.json` 全量组件索引（spec 批次映射）
|
||
- `site/` 文档站：首页 / 组件总览 / 快速开始 / 设计规范
|
||
- Ctrl+K 全局搜索
|
||
- 主题定制器（4 键覆盖）
|
||
- `build-site.ps1` 构建脚本
|
||
|
||
### Notes
|
||
- 数据生成产物：`site/data.js`（自动生成，请勿手动编辑）
|
||
|
||
---
|
||
|
||
## 标签说明
|
||
|
||
- `Added`：新功能
|
||
- `Changed`：现有功能变更
|
||
- `Deprecated`：即将移除
|
||
- `Removed`：已移除
|
||
- `Fixed`：缺陷修复
|
||
- `Security`：安全相关
|
||
|
||
## 版本约定
|
||
|
||
- 主版本号：不兼容的 API 变更
|
||
- 次版本号：向后兼容的功能新增
|
||
- 修订号：向后兼容的问题修复
|