aria-disabled

root
abc abc
  • 5 Aug

aria-disabled 是 WAI-ARIA(Web Accessibility Initiative - Accessible Rich Internet Applications)中的属性,用于指示元素是否处于禁用状态。该属性通常用于表单控件(如按钮、选择框、复选框等),也可用于其他需要明确标注不可用状态的元素(如超链接、段落等)。 ‌
1
2

核心用法
‌禁用状态标识‌:通过设置 aria-disabled="true" 可将元素标记为禁用状态,即使元素本身未使用原生 disabled 属性。例如,自定义按钮或复杂表单控件在特定场景下需禁用时,可仅通过 aria-disabled 实现。 ‌
1
3
‌改善辅助技术体验‌:辅助技术(如屏幕阅读器)会通过 aria-disabled 识别元素状态,确保所有用户(包括残障用户)都能正确感知界面交互逻辑。 ‌
1
2
注意事项
‌与原生属性配合‌:若元素本身支持原生 disabled 属性(如 <button>、<input> 等),应优先使用原生属性;aria-disabled 仅作为补充机制。 ‌
1
4
‌兼容性‌:需确保辅助技术已适配 aria-disabled 属性,部分旧版本屏幕阅读器可能无法识别该属性。 ‌
2
3
示例代码:

html
Copy Code

<button aria-disabled="true">Submit</button>
此时屏幕阅读器会读取该按钮为“禁用状态”,避免用户误操作。 ‌
1
4