The aria-readonly attribute indicates that the element is not editable, but is otherwise operable.
Description
When you want to indicate that an interactive element works but is not editable, set aria-readonly="true". This indicates to the user that an interactive element that would normally be focusable and copyable has been placed in a read-only (not disabled) state.
When aria-readonly is set to true, it means the user can read but not set the value of the widget. Read-only elements are still relevant to the user, so you should not prevent the user from navigating to the element or its focusable descendants or copying the value.
Examples include:
- Form elements which should not be changed.
- Row and column headers in a spreadsheet.
- The total value in a shopping cart.
If the element is unavailable for interaction, use aria-disabled instead.
[!NOTE] When using semantic HTML form controls, if you set the
readonlyattribute, you don't need to includearia-readonly="true".
[!NOTE] The value of
<input type="checkbox">cannot be edited makingreadonlynot relevant. However, when creating checkboxes withrole="checkbox"thearia-readonlyattribute is supported.
Values
true- : The element is readonly.
false(default)- : The element is not readonly.
Associated interfaces
- Element.ariaReadOnly
- : The
ariaReadOnlyproperty, part of the Element interface, reflects the value of thearia-readonlyattribute.
- : The
- ElementInternals.ariaReadOnly
- : The
ariaReadOnlyproperty, part of the ElementInternals interface, reflects the value of thearia-readonlyattribute.
- : The
Associated roles
Used in roles:
Inherited into roles:
Specifications
See also
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
