用 aria-checked=mixed 实现可访问的全选复选框

举报
yd_250998817 发表于 2026/11/15 13:32:22 2026/11/15
【摘要】 围绕自定义全选控件的三态可访问性,说明如何用 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。

键盘验证步骤

  1. 按 Tab 聚焦全选框,确认出现可见焦点轮廓。
  2. 按 Space,检查所有子项是否被勾选或取消,并观察 aria-checked 是否在 true 与 false 间切换。
  3. 再按 Tab 进入任一子项,按 Space 只切换该子项。
  4. 观察全选框:部分子项选中时应为 mixed;全部取消后应为 false;全部选中后应为 true。
  5. 在浏览器 DevTools 的 Accessibility 面板查看角色与 checked 状态;用屏幕阅读器验证其是否播报混合/部分选中。不同屏幕阅读器的具体措辞可能不同,以可访问性树和实际播报为准。

边界与限制

  • 原生输入框使用 indeterminate 表达混合状态;不要与 aria-checked='mixed' 混用。自定义控件需要自行实现键盘操作与焦点管理。
  • 空列表时同步为 false,避免 0 === 0 被误判为全选;示例代码已处理该情况。
  • 动态新增或删除子项后,需要重新查询节点或使用事件委托,并再次调用 syncSelectAll。若存在禁用项,应明确其是否计入总数并补充相应逻辑;示例未包含禁用项。
  • 自定义 checkbox 不参与表单提交,如需要提交值,可增加隐藏输入框同步状态。屏幕阅读器对 mixed 的播报措辞可能存在差异,验证时应以实际可访问性树和播报结果为准。
  • 示例只处理 Space 切换,遵循复选框的常见键盘习惯;如产品要求支持 Enter,可额外添加,但避免破坏页面默认行为。
【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。