aria-readonly

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

描述

当您想要指示交互式元素可工作但不可编辑时,请设置 aria-readonly="true"。这会向用户指示通常可聚焦和可复制的交互式元素已置于只读(未禁用)状态。

aria-readonly 设置为 true 时,表示用户可以读取但不能设置小部件的值。只读元素仍然与用户相关,因此您不应阻止用户导航到该元素或其可聚焦的后代或复制值。

示例包括

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

如果不可更改的值不能接收焦点,请改用 aria-disabled

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

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

true

元素为只读。

false(默认值)

元素不为只读。

关联接口

Element.ariaReadOnly

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

ElementInternals.ariaReadOnly

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

关联角色

规范

规范
可访问的富互联网应用程序 (WAI-ARIA)
# aria-readonly

另请参阅