ARIA: aria-readonly-Attribut
Das aria-readonly-Attribut zeigt an, dass das Element nicht editierbar ist, aber dennoch bedienbar.
Beschreibung
Wenn Sie anzeigen möchten, dass ein interaktives Element funktioniert, aber nicht bearbeitbar ist, setzen Sie aria-readonly="true". Dies zeigt dem Benutzer, dass ein interaktives Element, das normalerweise fokussierbar und kopierbar wäre, in einen Nur-Lesen-Zustand (nicht deaktiviert) versetzt wurde.
Wenn aria-readonly auf true gesetzt ist, bedeutet dies, dass der Benutzer den Wert des Widgets lesen, aber nicht ändern kann. Nur-Lesen-Elemente sind für den Benutzer weiterhin relevant, daher sollten Sie den Benutzer nicht daran hindern, zum Element oder seinen fokussierbaren Nachkommen zu navigieren oder den Wert zu kopieren.
Beispiele beinhalten:
- Formularelemente, die nicht verändert werden sollten.
- Zeilen- und Spaltenüberschriften in einer Tabellenkalkulation.
- Der Gesamtwert in einem Warenkorb.
Wenn der nicht änderbare Wert keinen Fokus erhalten sollte, verwenden Sie stattdessen aria-disabled.
Hinweis:
Wenn Sie semantische HTML-Formular-Steuerelemente verwenden und das readonly-Attribut setzen, müssen Sie aria-readonly="true" nicht hinzufügen.
Hinweis:
Der Wert von <input type="checkbox"> kann nicht bearbeitet werden, wodurch readonly nicht relevant ist. Wenn jedoch Kontrollkästchen mit role="checkbox" erstellt werden, wird das aria-readonly-Attribut unterstützt.
Werte
true-
Das Element ist nur lesbar.
false(Standard)-
Das Element ist nicht nur lesbar.
Zugehörige Schnittstellen
Element.ariaReadOnly-
Die
ariaReadOnly-Eigenschaft, Teil derElement-Schnittstelle, spiegelt den Wert desaria-readonly-Attributs wider. ElementInternals.ariaReadOnly-
Die
ariaReadOnly-Eigenschaft, Teil derElementInternals-Schnittstelle, spiegelt den Wert desaria-readonly-Attributs wider.
Zugehörige Rollen
Verwendet in Rollen:
Vererbt in Rollen:
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-readonly |