Element: ariaReadOnly-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.
Die ariaReadOnly-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-readonly-Attributs wider, welches angibt, dass das Element nicht bearbeitbar ist, aber ansonsten bedienbar.
Hinweis:
Verwenden Sie nach Möglichkeit ein HTML <input>-Element mit type="text" oder ein <textarea>, da diese über eingebaute Semantik verfügen und keine ARIA-Attribute benötigen.
Wert
Ein String mit einem der folgenden Werte:
Beispiele
In diesem Beispiel wird das aria-readonly-Attribut des Elements mit der ID txtBoxInput auf "true" gesetzt, was anzeigt, dass diese Eingabe derzeit nur gelesen werden kann. Mit ariaReadOnly aktualisieren wir den Wert auf "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"
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariareadonly |