ARIA: aria-readonly 属性

aria-readonly 属性表示该元素不可编辑,但其他方面可以操作。

描述

当您想表明一个交互式元素可以工作但不可编辑时,请将 aria-readonly="true" 设置为 true。这会向用户表明,一个通常可以获得焦点并可复制内容的交互式元素已被置于只读(非禁用)状态。

aria-readonly 设置为 true 时,意味着用户可以读取小部件的值,但不能设置。只读元素对用户仍然很重要,因此您不应阻止用户导航到该元素或其可聚焦的后代元素,也不应阻止用户复制其值。

示例包括

  • 不应更改的表单元素。
  • 电子表格中的行标题和列标题。
  • 购物车中的总金额。

如果不可更改的值不应能够获得焦点,请改用 aria-disabled

注意:在使用语义化的 HTML 表单控件时,如果设置了 readonly 属性,则无需包含 aria-readonly="true"

注意: <input type="checkbox"> 的值无法编辑,因此 readonly 不适用。但是,当使用 role="checkbox" 创建复选框时,aria-readonly 属性是支持的。

true

该元素是只读的。

false(默认)

该元素不是只读的。

相关接口

Element.ariaReadOnly

Element 接口的一部分 ariaReadOnly 属性反映了 aria-readonly 属性的值。

ElementInternals.ariaReadOnly

ElementInternals 接口的一部分 ariaReadOnly 属性反映了 aria-readonly 属性的值。

相关角色

用于角色

继承到角色

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# aria-readonly

另见