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
属性是支持的。
值
相关接口
Element.ariaReadOnly
-
Element
接口的一部分ariaReadOnly
属性反映了aria-readonly
属性的值。 ElementInternals.ariaReadOnly
-
ElementInternals
接口的一部分ariaReadOnly
属性反映了aria-readonly
属性的值。
相关角色
用于角色
继承到角色
规范
规范 |
---|
无障碍富互联网应用程序 (WAI-ARIA) # aria-readonly |