用 aria-checked=mixed 实现可访问的全选复选框
【摘要】 围绕自定义全选控件的三态可访问性,说明如何用 aria-checked 的 mixed 值表示部分选中,并给出最小 HTML/CSS/JS 示例,覆盖点击、子项联动与键盘验证步骤。
用 aria-checked=mixed 实现可访问的全选复选框
问题场景:列表中有多个复选框,全选框需要三种状态:全未选、全选、部分选中。仅靠视觉上的横线不够,辅助技术也需要获得“混合”状态。自定义控件可使用 role='checkbox' 与 aria-checked 的 true、false、mixed 三个值。注意:原生 <input type='checkbox'> 不应设置 aria-checked='mixed',而应使用 DOM 的 indeterminate 属性;本文示例采用自定义 role='checkbox',便于直接演示 ARIA 状态。
最小实现
HTML:
<div id='selectAll' role='checkbox' aria-checked='false' tabindex='0' aria-labelledby='selectAllLabel'>
<span class='box' aria-hidden='true'></span>
<span id='selectAllLabel'>全选</span>
</div>
<ul id='list'>
<li><label><input type='checkbox' data-item> 选项 A</label></li>
<li><label><input type='checkbox' data-item> 选项 B</label></li>
<li><label><input type='checkbox' data-item> 选项 C</label></li>
</ul>
CSS:
#selectAll { display:inline-flex; align-items:center; gap:6px; cursor:pointer; }
#selectAll:focus-visible { outline:2px solid #2563eb; outline-offset:2px; }
.box { width:16px; height:16px; border:1px solid #555; display:inline-flex; align-items:center; justify-content:center; }
#selectAll[aria-checked='true'] .box::after { content:'✓'; }
#selectAll[aria-checked='mixed'] .box::after { content:'−'; font-weight:700; }
JavaScript:
const selectAll = document.getElementById('selectAll');
const items = Array.from(document.querySelectorAll('[data-item]'));
function syncSelectAll() {
const total = items.length;
const checked = items.filter((item) => item.checked).length;
let state = 'false';
if (total > 0 && checked === total) state = 'true';
else if (checked > 0) state = 'mixed';
selectAll.setAttribute('aria-checked', state);
}
function setAll(checked) {
items.forEach((item) => { item.checked = checked; });
syncSelectAll();
}
selectAll.addEventListener('click', () => {
const current = selectAll.getAttribute('aria-checked');
setAll(current !== 'true');
});
selectAll.addEventListener('keydown', (event) => {
if (event.key === ' ' || event.key === 'Spacebar') {
event.preventDefault();
selectAll.click();
}
});
items.forEach((item) => item.addEventListener('change', syncSelectAll));
syncSelectAll();
运行方法:保存为 select-all.html,用浏览器打开;也可用本地静态服务器托管。点击全选框时,若当前为 true 则全部取消,否则全部勾选;点击单个子项后,全选框会自动变为 false、mixed 或 true。
键盘验证步骤
- 按 Tab 聚焦全选框,确认出现可见焦点轮廓。
- 按 Space,检查所有子项是否被勾选或取消,并观察
aria-checked是否在true与false间切换。 - 再按 Tab 进入任一子项,按 Space 只切换该子项。
- 观察全选框:部分子项选中时应为
mixed;全部取消后应为false;全部选中后应为true。 - 在浏览器 DevTools 的 Accessibility 面板查看角色与 checked 状态;用屏幕阅读器验证其是否播报混合/部分选中。不同屏幕阅读器的具体措辞可能不同,以可访问性树和实际播报为准。
边界与限制
- 原生输入框使用
indeterminate表达混合状态;不要与aria-checked='mixed'混用。自定义控件需要自行实现键盘操作与焦点管理。 - 空列表时同步为
false,避免0 === 0被误判为全选;示例代码已处理该情况。 - 动态新增或删除子项后,需要重新查询节点或使用事件委托,并再次调用
syncSelectAll。若存在禁用项,应明确其是否计入总数并补充相应逻辑;示例未包含禁用项。 - 自定义 checkbox 不参与表单提交,如需要提交值,可增加隐藏输入框同步状态。屏幕阅读器对 mixed 的播报措辞可能存在差异,验证时应以实际可访问性树和播报结果为准。
- 示例只处理 Space 切换,遵循复选框的常见键盘习惯;如产品要求支持 Enter,可额外添加,但避免破坏页面默认行为。
【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)