aria-readonly

Das aria-readonly-Attribut zeigt an, dass das Element nicht bearbeitet werden kann, aber dennoch bedienbar ist.

Beschreibung

Wenn Sie anzeigen möchten, dass ein interaktives Element funktioniert, aber nicht bearbeitet werden kann, setzen Sie aria-readonly="true". Dies zeigt dem Benutzer, dass ein interaktives Element, das normalerweise fokussierbar und kopierbar ist, in einem schreibgeschützten (nicht deaktivierten) Zustand versetzt wurde.

Wenn aria-readonly auf true gesetzt ist, bedeutet es, dass der Benutzer den Wert des Widgets lesen, aber nicht setzen kann. Schreibgeschützte Elemente sind weiterhin für den Benutzer relevant, daher sollten Sie verhindern, dass der Benutzer das Element oder dessen fokussierbare Nachkommen erreicht oder den Wert kopiert.

Beispiele umfassen:

Formularelemente, die nicht geändert werden sollten.
Zeilen- und Spaltenüberschriften in einer Tabellenkalkulation.
Der Gesamtwert in einem Warenkorb.

Wenn der nicht änderbare Wert keinen Fokus erhalten soll, verwenden Sie stattdessen aria-disabled.

Hinweis: Bei Verwendung von semantischen HTML-Formularsteuerelementen müssen Sie, wenn Sie das readonly-Attribut setzen, nicht zusätzlich aria-readonly="true" angeben.

Hinweis: Der Wert von <input type="checkbox"> kann nicht bearbeitet werden, sodass 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 schreibgeschützt.
false (Standard): Das Element ist nicht schreibgeschützt.

Zugehörige Schnittstellen

Element.ariaReadOnly: Die ariaReadOnly-Eigenschaft, Teil der Element-Schnittstelle, spiegelt den Wert des aria-readonly-Attributs wider.
ElementInternals.ariaReadOnly: Die ariaReadOnly-Eigenschaft, Teil der ElementInternals-Schnittstelle, spiegelt den Wert des aria-readonly-Attributs wider.

Zugehörige Rollen

Verwendet in Rollen:

Vererbt in Rollen:

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA) # aria-readonly