Element.ariaReadOnly
The ariaReadOnly
property of the Element
interface reflects the value of the aria-readonly
attribute, which indicates that the element is not editable, but is otherwise operable.
Note: Where possible use an HTML <input>
element with type="text"
or a <textarea>
as these have built in semantics and do not require ARIA attributes.
Syntax
var ariaReadOnly = element.ariaReadOnly; element.ariaReadOnly = ariaReadOnly
Value
A DOMString
with one of the following values:
"true"
-
The user cannot change the value of the element.
"false"
-
The user can set the value of the element.
Examples
In this example the aria-readonly
attribute on the element with an ID of txtBoxInput
is set to "true" indicating that this input is currently read only. Using ariaReadOnly
we update the value to "false".
<div id="txtboxMultilineLabel">Enter the tags for the article</div> <div role="textbox" id="txtBoxInput" contenteditable="true" aria-multiline="true" aria-labelledby="txtboxMultilineLabel" aria-readonly="true"></div>
let el = document.getElementById('txtBoxInput'); console.log(el.ariaReadOnly); // "true" el.ariaReadOnly = "false" console.log(el.ariaReadOnly); // "false"
Specifications
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) 1.2 (WAI-ARIA 1.2) # dom-ariamixin-ariareadonly |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
ariaReadOnly |
81 |
81 |
No |
No |
68 |
12.1 |
81 |
81 |
No |
58 |
12.2 |
13.0 |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaReadOnly