Files
aurora-admin/frameworks/select.html
T
aurora-admin bb4052955c 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 验证
2026-09-11 14:16:00 +08:00

208 lines
9.8 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!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 · Select (H5)</title>
<link rel="stylesheet" href="../.design_library/aurora-admin/colors_and_type.css">
<style>
/* 对齐 components.css 与 select.json 契约(触发器样式同 Input) */
.demo { padding: 24px; background: #F5F7FA; color: #262626; font-family: var(--font-family); }
h1 { font-size: 20px; margin: 0 0 4px; }
.sub { color: #6E6E6E; margin: 0 0 24px; font-size: 12px; }
.group { margin-bottom: 24px; }
.group h2 { font-size: 16px; margin: 0 0 12px; color: #1F2329; }
.row { display: flex; flex-wrap: wrap; gap: 16px; align-items: flex-start; }
.aa-select { position: relative; display: inline-block; min-width: 220px; }
.aa-select-trigger {
display: flex; align-items: center; gap: 8px; min-height: 32px; height: auto;
padding: 2px 28px 2px 12px; background: #fff; border: 1px solid #E8ECF1;
border-radius: 4px; box-sizing: border-box; cursor: pointer; transition: border-color .15s, box-shadow .15s;
font-size: 14px; color: #262626; flex-wrap: wrap;
}
.aa-select-trigger:hover { border-color: #2F54EB; }
.aa-select.is-open .aa-select-trigger { border-color: #2F54EB; box-shadow: 0 0 0 2px rgba(47,84,235,0.2); }
.aa-select.is-disabled .aa-select-trigger { background: #F5F5F5; border-color: transparent; color: #BFBFBF; cursor: not-allowed; }
.aa-select-trigger .placeholder { color: #767676; }
.aa-select-trigger .caret { position: absolute; right: 10px; top: 50%; transform: translateY(-50%); transition: transform .15s; color: #6E6E6E; pointer-events: none; }
.aa-select.is-open .caret { transform: translateY(-50%) rotate(180deg); }
.aa-select-trigger .tag {
display: inline-flex; align-items: center; gap: 4px; background: #F0F5FF; color: #2F54EB;
border-radius: 2px; padding: 1px 6px; font-size: 12px; line-height: 20px;
}
.aa-select-trigger .tag .x { cursor: pointer; }
.aa-select-panel {
position: absolute; z-index: 10; top: calc(100% + 4px); left: 0; right: 0;
background: #fff; border-radius: 4px; box-shadow: 0 4px 16px rgba(0,0,0,0.12);
max-height: 256px; overflow-y: auto; padding: 4px 0;
}
.aa-select-search { padding: 6px 8px; border-bottom: 1px solid #F0F0F0; }
.aa-select-search input { width: 100%; box-sizing: border-box; border: 1px solid #E8ECF1; border-radius: 4px; padding: 4px 8px; font-size: 13px; outline: none; }
.aa-select-search input:focus { border-color: #2F54EB; }
.aa-select-group-label { padding: 6px 12px; font-size: 12px; color: #6E6E6E; }
.aa-select-option {
display: flex; align-items: center; gap: 8px; padding: 0 12px; height: 32px; cursor: pointer;
font-size: 14px; color: #262626; box-sizing: border-box;
}
.aa-select-option:hover { background: #F5F7FA; }
.aa-select-option.is-selected { background: #F0F5FF; color: #2F54EB; }
.aa-select-option .check { visibility: hidden; margin-left: auto; }
.aa-select-option.is-selected .check { visibility: visible; }
.aa-select-option.is-disabled { color: #BFBFBF; cursor: not-allowed; }
.aa-select-empty { padding: 16px 12px; text-align: center; color: #767676; font-size: 13px; }
</style>
</head>
<body>
<div class="demo">
<h1>Aurora Admin · Select 组件(纯 H5)</h1>
<p class="sub">对齐 select.json 契约:触发器同 Input,面板圆角4px / 阴影中 / 最大高度256px,选中项品牌色 + 勾选图标</p>
<div class="group">
<h2>1. 单选</h2>
<div class="row">
<div class="aa-select" data-select data-mode="single" data-name="city">
<div class="aa-select-trigger" role="button" aria-haspopup="listbox" aria-expanded="false" tabindex="0"><span class="placeholder">请选择城市</span><span class="caret">▾</span></div>
<div class="aa-select-panel" hidden>
<div class="aa-select-option" role="option" data-value="bj">北京</div>
<div class="aa-select-option" role="option" data-value="sh">上海</div>
<div class="aa-select-option" role="option" data-value="gz">广州</div>
<div class="aa-select-option" role="option" data-value="sz">深圳</div>
</div>
</div>
</div>
</div>
<div class="group">
<h2>2. 多选</h2>
<div class="row">
<div class="aa-select" data-select data-mode="multiple" data-name="role">
<div class="aa-select-trigger" role="button" aria-haspopup="listbox" aria-expanded="false" tabindex="0"><span class="placeholder">请选择角色</span><span class="caret">▾</span></div>
<div class="aa-select-panel" hidden>
<div class="aa-select-option" role="option" data-value="admin">管理员</div>
<div class="aa-select-option" role="option" data-value="editor">编辑</div>
<div class="aa-select-option" role="option" data-value="viewer">访客</div>
<div class="aa-select-option is-disabled" role="option" data-value="guest" data-disabled="1">受限访客</div>
</div>
</div>
</div>
</div>
<div class="group">
<h2>3. 可搜索</h2>
<div class="row">
<div class="aa-select" data-select data-mode="single" data-searchable="1" data-name="user">
<div class="aa-select-trigger" role="button" aria-haspopup="listbox" aria-expanded="false" tabindex="0"><span class="placeholder">搜索并选择用户</span><span class="caret">▾</span></div>
<div class="aa-select-panel" hidden>
<div class="aa-select-search"><input placeholder="输入关键字"></div>
<div class="aa-select-option" role="option" data-value="u1">张伟</div>
<div class="aa-select-option" role="option" data-value="u2">李娜</div>
<div class="aa-select-option" role="option" data-value="u3">王芳</div>
<div class="aa-select-option" role="option" data-value="u4">刘强</div>
</div>
</div>
</div>
</div>
<div class="group">
<h2>4. 分组</h2>
<div class="row">
<div class="aa-select" data-select data-mode="single" data-grouped="1" data-name="dept">
<div class="aa-select-trigger" role="button" aria-haspopup="listbox" aria-expanded="false" tabindex="0"><span class="placeholder">请选择部门</span><span class="caret">▾</span></div>
<div class="aa-select-panel" hidden>
<div class="aa-select-group-label">技术中心</div>
<div class="aa-select-option" role="option" data-value="fe">前端组</div>
<div class="aa-select-option" role="option" data-value="be">后端组</div>
<div class="aa-select-group-label">产品中心</div>
<div class="aa-select-option" role="option" data-value="pm">产品组</div>
<div class="aa-select-option" role="option" data-value="ux">设计组</div>
</div>
</div>
</div>
</div>
</div>
<script>
document.querySelectorAll('[data-select]').forEach(root => {
const trigger = root.querySelector('.aa-select-trigger');
const panel = root.querySelector('.aa-select-panel');
const mode = root.dataset.mode;
const multiple = mode === 'multiple';
const searchable = root.dataset.searchable === '1';
const grouped = root.dataset.grouped === '1';
let selected = multiple ? [] : null; // value | array of value
function optionLabel(opt) { return opt.textContent.trim(); }
function renderTrigger() {
if (multiple) {
if (!selected.length) { trigger.innerHTML = '<span class="placeholder">请选择角色</span><span class="caret">▾</span>'; return; }
const tags = selected.map(v => {
const txt = root.querySelector(`.aa-select-option[data-value="${v}"]`).textContent.trim();
return `<span class="tag" data-tag="${v}">${txt}<span class="x" data-x="${v}">✕</span></span>`;
}).join('');
trigger.innerHTML = tags + '<span class="caret">▾</span>';
} else {
if (selected == null) { trigger.innerHTML = '<span class="placeholder">请选择</span><span class="caret">▾</span>'; return; }
const txt = root.querySelector(`.aa-select-option[data-value="${selected}"]`).textContent.trim();
trigger.innerHTML = `<span>${txt}</span><span class="caret">▾</span>`;
}
}
function syncSelectedClasses() {
root.querySelectorAll('.aa-select-option').forEach(o => {
const v = o.dataset.value;
const isSel = multiple ? selected.includes(v) : selected === v;
o.classList.toggle('is-selected', isSel);
});
}
function open() {
root.classList.add('is-open');
panel.hidden = false;
if (searchable) panel.querySelector('.aa-select-search input').focus();
}
function close() { root.classList.remove('is-open'); panel.hidden = true; }
trigger.addEventListener('click', (e) => {
if (root.classList.contains('is-disabled')) return;
if (e.target.dataset.x) {
const v = e.target.dataset.x;
selected = selected.filter(x => x !== v);
syncSelectedClasses(); renderTrigger(); return;
}
root.classList.contains('is-open') ? close() : open();
});
panel.addEventListener('click', (e) => {
const opt = e.target.closest('.aa-select-option');
if (!opt || opt.classList.contains('is-disabled')) return;
const v = opt.dataset.value;
if (multiple) {
selected.includes(v) ? selected = selected.filter(x => x !== v) : selected.push(v);
syncSelectedClasses(); renderTrigger();
} else {
selected = v; syncSelectedClasses(); renderTrigger(); close();
}
});
if (searchable) {
panel.querySelector('.aa-select-search input').addEventListener('input', (e) => {
const q = e.target.value.trim().toLowerCase();
root.querySelectorAll('.aa-select-option').forEach(o => {
o.style.display = o.textContent.toLowerCase().includes(q) ? '' : 'none';
});
});
}
document.addEventListener('click', (e) => {
if (!root.contains(e.target)) close();
});
renderTrigger();
});
</script>
</body>
</html>