应保留原生 checkbox/radio 元素,用 CSS 视觉隐藏(如 opacity: 0 + absolute 定位)而非 display: none;通过 label 包裹或 for 属性关联自定义外观;确保键盘聚焦、Space 切换、屏幕阅读器正确播报状态。
要让自定义 checkbox 和 radio 被屏幕阅读器正确识别,核心是保留语义结构、确保可访问性属性完整,并避免破坏原生交互逻辑。不能只靠视觉替换,而要兼顾 ARIA 规范与浏览器的无障碍支持机制。
或 元素自定义样式时,不要移除或隐藏原生 input,而是通过 CSS 将其视觉上“透出”(例如用 opacity: 0、position: absolute; left: -9999px),同时保证它仍可聚焦、可操作、在 DOM 中存在且未被 display: none 或

visibility: hidden 移除。
display: none 和 visibility: hidden 会让屏幕阅读器完全忽略该元素 —— 必须避免clip-path: inset(50%) 或 position: absolute; opacity: 0; width: 1px; height: 1px; 实现“视觉隐藏但语义保留”for 属性或 包裹实现点击穿透用户点击自定义外观区域时,必须能触发原生 input 的选中/取消行为。最可靠方式是使用语义化 label 关联:
id,label 用 for="xxx" 指向它 内部(隐式关联),更简洁不易出错如果自定义外观是独立渲染(比如用 div + icon 模拟),且无法或不打算保留原生 input,则必须手动补全语义:
role="checkbox" 或 role="radio"
aria-checked="true"/"false"/"mixed" 同步反映当前状态(需 JS 维护)aria-labelledby 或 aria-label 提供可读名称tabindex="0")并监听 Space 键切换状态完成实现后,务必验证以下几点:
name 一致)不复杂但容易忽略:可访问性不是加个 aria-label 就完事,而是从结构、行为、状态三个层面保持与原生控件一致。保留 input、用 label 关联、避免 display:none,这三步做到,90% 的问题就解决了。