aria-readonly

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

Beschreibung

Wenn Sie anzeigen 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 einen schreibgeschützten (nicht deaktivierten) Zustand versetzt wurde.

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

Beispiele umfassen:

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

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

Hinweis: Wenn Sie semantische HTML-Formularsteuerungen verwenden und das readonly Attribut setzen, brauchen Sie aria-readonly="true" nicht einzuschließen.

Hinweis: Der Wert von <input type="checkbox"> kann nicht bearbeitet werden, wodurch readonly nicht relevant ist. Wenn jedoch Checkboxen 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

Spezifikationen

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

Siehe auch