v1.3.1: 无障碍与令牌合规优化,回归 85.1% → 100%
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 验证
This commit is contained in:
@@ -9,7 +9,7 @@
|
||||
<style>
|
||||
.demo { display: flex; gap: 24px; padding: 24px; background: #F5F7FA; font-family: var(--font-family); }
|
||||
h1 { font-size: 20px; margin: 0 0 4px; color: #1F2329; }
|
||||
.sub { color: #8C8C8C; margin: 0 0 16px; font-size: 12px; }
|
||||
.sub { color: #6E6E6E; margin: 0 0 16px; font-size: 12px; }
|
||||
.col { background: #fff; border-radius: 8px; padding: 16px; }
|
||||
.toggle { margin-bottom: 12px; font-size: 13px; color: #2F54EB; cursor: pointer; user-select: none; }
|
||||
</style>
|
||||
@@ -20,7 +20,7 @@
|
||||
<h1>SideMenu</h1>
|
||||
<p class="sub">多级、图标、徽章、选中态+左指示条、折叠</p>
|
||||
<div class="toggle" id="toggle">⇥ 折叠 / 展开</div>
|
||||
<div class="aa-sidemenu" id="menu"></div>
|
||||
<div class="aa-sidemenu" role="navigation" id="menu"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -45,7 +45,7 @@ function render() {
|
||||
const hasChild = it.children && it.children.length;
|
||||
const isOpen = openKeys.has(it.key);
|
||||
const el = document.createElement('div');
|
||||
el.className = 'aa-menu-item' + (active === it.key ? ' is-active' : '') + (it.disabled ? ' is-disabled' : '') + (hasChild && isOpen ? ' is-open' : '');
|
||||
el.className = 'aa-menu-item' + (active === it.key ? ' is-active' : '') + (it.disabled ? ' is-disabled' : '') + (hasChild && isOpen ? ' is-open' : ''); el.setAttribute('role','menuitem'); el.setAttribute('tabindex','0');
|
||||
el.dataset.key = it.key;
|
||||
el.innerHTML = `<span class="aa-menu-icon">${it.icon || ''}</span>` +
|
||||
`<span class="aa-menu-label">${it.label}</span>` +
|
||||
@@ -58,7 +58,7 @@ function render() {
|
||||
wrap.className = 'aa-menu-children';
|
||||
it.children.forEach(c => {
|
||||
const cEl = document.createElement('div');
|
||||
cEl.className = 'aa-menu-item' + (active === c.key ? ' is-active' : '');
|
||||
cEl.className = 'aa-menu-item' + (active === c.key ? ' is-active' : ''); cEl.setAttribute('role','menuitem'); cEl.setAttribute('tabindex','0');
|
||||
cEl.dataset.key = c.key;
|
||||
cEl.innerHTML = `<span class="aa-menu-label">${c.label}</span>`;
|
||||
wrap.appendChild(cEl);
|
||||
@@ -96,9 +96,9 @@ menu.addEventListener('mouseover', (e) => {
|
||||
pop.style.top = item.offsetTop + 'px';
|
||||
let html = `<div class="aa-menu-pop-title">${it.label}</div>`;
|
||||
if (it.children) it.children.forEach(c => {
|
||||
html += `<div class="aa-menu-item ${active === c.key ? 'is-active' : ''}" data-key="${c.key}"><span class="aa-menu-label">${c.label}</span></div>`;
|
||||
html += `<div class="aa-menu-item ${active === c.key ? 'is-active' : ''}" role="menuitem" tabindex="0" data-key="${c.key}"><span class="aa-menu-label">${c.label}</span></div>`;
|
||||
}); else {
|
||||
html += `<div class="aa-menu-item is-active" data-key="${it.key}"><span class="aa-menu-label">${it.label}</span></div>`;
|
||||
html += `<div class="aa-menu-item is-active" role="menuitem" tabindex="0" data-key="${it.key}"><span class="aa-menu-label">${it.label}</span></div>`;
|
||||
}
|
||||
pop.innerHTML = html;
|
||||
menu.appendChild(pop);
|
||||
|
||||
Reference in New Issue
Block a user