aria-readonly

Das aria-readonly Attribut gibt an, dass das Element nicht bearbeitbar, aber dennoch bedienbar ist.

Beschreibung

Wenn Sie angeben möchten, dass ein interaktives Element funktioniert, aber nicht bearbeitbar ist, setzen Sie aria-readonly="true". Dies zeigt dem Benutzer an, dass ein interaktives Element, das normalerweise fokussierbar und kopierbar wäre, in einem schreibgeschützten Zustand (nicht deaktiviert) ist.

Wenn aria-readonly auf true gesetzt ist, bedeutet dies, dass der Benutzer den Wert des Widgets lesen, aber nicht festlegen kann. Schreibgeschützte Elemente sind für den Benutzer weiterhin relevant, daher sollten Sie nicht verhindern, dass der Benutzer zum Element oder seinen fokussierbaren Nachkommen navigiert oder den Wert kopiert.

Beispiele beinhalten:

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

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

Hinweis: Bei der Verwendung von semantischen HTML-Formularsteuerungen müssen Sie, wenn Sie das readonly Attribut festlegen, aria-readonly="true" nicht einschließen.

Hinweis: Der Wert von <input type="checkbox"> kann nicht bearbeitet werden, wodurch readonly nicht relevant ist. Wenn Sie jedoch Kontrollkästchen mit role="checkbox" erstellen, 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