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 验证
82 lines
3.6 KiB
HTML
82 lines
3.6 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>Aurora Admin · AnchorNav (H5)</title>
|
||
<link rel="stylesheet" href="../.design_library/aurora-admin/colors_and_type.css">
|
||
<link rel="stylesheet" href="./AnchorNav.css">
|
||
<style>
|
||
.demo { padding: 24px 200px 400px 24px; background: #F5F7FA; font-family: var(--font-family); color: #262626; }
|
||
h1 { font-size: 20px; margin: 0 0 24px; color: #1F2329; }
|
||
.sub { color: #6E6E6E; margin: 0 0 24px; font-size: 12px; }
|
||
section { background: #fff; border: 1px solid #E8ECF1; border-radius: 8px; padding: 20px 24px; margin-bottom: 24px; scroll-margin-top: 24px; }
|
||
section h2 { font-size: 16px; margin: 0 0 8px; }
|
||
section p { color: #595959; line-height: 1.8; margin: 0; }
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div class="demo">
|
||
<h1>Aurora Admin · AnchorNav 组件(纯 H5)</h1>
|
||
<p class="sub">对齐 AnchorNav 规范:右侧目录、滚动高亮、层级嵌套、点击平滑滚动</p>
|
||
|
||
<nav class="aa-anchor fixed" id="anchor"></nav>
|
||
|
||
<section id="intro"><h2>1. 产品简介</h2><p>本系统是一套企业级中后台解决方案……(长文本占位,可滚动测试高亮)</p><p style="margin-top:40px">更多内容用于撑高页面,方便观察当前章节高亮效果。</p></section>
|
||
<section id="install"><h2>2. 安装与初始化</h2><p>通过 npm 安装后,在入口文件引入主题与组件库。</p><p style="margin-top:40px">配置项说明略。</p></section>
|
||
<section id="guide">
|
||
<h2>3. 开发指南</h2>
|
||
<p>包含布局、主题与国际化三部分。</p>
|
||
<div id="layout" style="margin-top:16px"><h3>3.1 布局</h3><p>侧边栏 + 顶栏的经典后台布局。</p></div>
|
||
<div id="theme" style="margin-top:16px"><h3>3.2 主题</h3><p>通过 CSS 变量统一调整品牌色。</p></div>
|
||
</section>
|
||
<section id="faq"><h2>4. 常见问题</h2><p>收集部署与升级中的高频问题。</p><p style="margin-top:40px">FAQ 列表略。</p></section>
|
||
</div>
|
||
|
||
<script>
|
||
const ITEMS = [
|
||
{ key: 'intro', label: '产品简介' },
|
||
{ key: 'install', label: '安装与初始化' },
|
||
{ key: 'guide', label: '开发指南', children: [
|
||
{ key: 'layout', label: '布局' },
|
||
{ key: 'theme', label: '主题' }
|
||
] },
|
||
{ key: 'faq', label: '常见问题' }
|
||
];
|
||
const allKeys = [];
|
||
(function collect(list) { list.forEach(i => { allKeys.push(i.key); if (i.children) collect(i.children); }); })(ITEMS);
|
||
|
||
const anchor = document.getElementById('anchor');
|
||
function render() {
|
||
anchor.innerHTML = ITEMS.map(it => {
|
||
let html = `<button class="aa-anchor-item" role="link" tabindex="0" data-key="${it.key}">${it.label}</button>`;
|
||
if (it.children) {
|
||
html += '<div class="aa-anchor-sub">' + it.children.map(c => `<button class="aa-anchor-item" role="link" tabindex="0" data-key="${c.key}">${c.label}</button>`).join('') + '</div>';
|
||
}
|
||
return html;
|
||
}).join('');
|
||
}
|
||
render();
|
||
|
||
anchor.addEventListener('click', (e) => {
|
||
const btn = e.target.closest('.aa-anchor-item');
|
||
if (!btn) return;
|
||
const el = document.getElementById(btn.dataset.key);
|
||
if (el) window.scrollTo({ top: el.getBoundingClientRect().top + window.scrollY - 24, behavior: 'smooth' });
|
||
});
|
||
|
||
function updateActive() {
|
||
const pos = window.scrollY + 80;
|
||
let active = allKeys[0];
|
||
for (const k of allKeys) {
|
||
const el = document.getElementById(k);
|
||
if (el && el.offsetTop <= pos) active = k;
|
||
}
|
||
anchor.querySelectorAll('.aa-anchor-item').forEach(b => b.classList.toggle('is-active', b.dataset.key === active));
|
||
}
|
||
window.addEventListener('scroll', updateActive);
|
||
updateActive();
|
||
</script>
|
||
</body>
|
||
</html>
|