ARIA: aria-readonly-Attribut
Das Attribut aria-readonly gibt an, dass das Element nicht bearbeitbar, aber ansonsten bedienbar ist.
Beschreibung
Wenn Sie angeben möchten, dass ein interaktives Element bedienbar, aber nicht bearbeitbar ist, setzen Sie aria-readonly="true". Dadurch wird Benutzern vermittelt, dass sich ein interaktives Element, das normalerweise fokussiert und dessen Wert kopiert werden kann, in einem schreibgeschützten Zustand befindet (und nicht deaktiviert ist).
Wenn aria-readonly auf true gesetzt ist, können Benutzer den Wert des Widgets lesen, aber nicht ändern. Schreibgeschützte Elemente sind für Benutzer weiterhin relevant. Deshalb sollten Sie nicht verhindern, dass sie zum Element oder zu seinen fokussierbaren Nachfahren navigieren oder den Wert kopieren können.
Beispiele sind:
- Formularelemente, die nicht geändert werden sollen.
- Zeilen- und Spaltenüberschriften in einer Tabellenkalkulation.
- Der Gesamtbetrag in einem Warenkorb.
Wenn mit dem Element nicht interagiert werden kann, verwenden Sie stattdessen aria-disabled.
Hinweis:
Wenn Sie semantische HTML-Formularsteuerelemente verwenden und das Attribut readonly setzen, müssen Sie aria-readonly="true" nicht zusätzlich angeben.
Hinweis:
Der Wert von <input type="checkbox"> kann nicht bearbeitet werden, daher ist readonly hierfür nicht relevant. Wenn Sie jedoch Checkboxen mit role="checkbox" erstellen, wird das Attribut aria-readonly unterstützt.
Werte
true-
Das Element ist schreibgeschützt.
false(Standardwert)-
Das Element ist nicht schreibgeschützt.
Zugehörige Schnittstellen
Element.ariaReadOnly-
Die Eigenschaft
ariaReadOnlyder SchnittstelleElementspiegelt den Wert des Attributsaria-readonlywider. ElementInternals.ariaReadOnly-
Die Eigenschaft
ariaReadOnlyder SchnittstelleElementInternalsspiegelt den Wert des Attributsaria-readonlywider.
Zugehörige Rollen
Wird in folgenden Rollen verwendet:
Wird an folgende Rollen vererbt:
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-readonly |