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
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:
Geerbt in Rollen:
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-readonly |