优先用原生元素;确需补充时,从这张卡里挑最贴切的一个属性即可。
01aria-label / aria-labelledby
为无可见文本的控件提供名称;不要覆盖更清楚的可见文本。
02aria-describedby
关联格式说明、错误文本等补充描述,聚焦时一并读出。
03aria-expanded / aria-controls
表达折叠部件的展开状态与其控制区域。
04aria-current="page"
标出导航或分页中的当前项。
05aria-invalid + aria-errormessage
标明字段校验失败与对应说明。
06aria-pressed / aria-selected
切换按钮与选项的选中状态。
07role="status" / role="alert"
结果计数等温和播报,与需要立即注意的错误提示。
08inert / aria-hidden
让整棵子树不可交互不可读;不要用在可聚焦元素上。
本卡按「可对照、可复现」的原则编排;规范会更新,使用时请同时核对适用版本与验证日期。
