ARIA: aria-readonly-Attribut
Das aria-readonly-Attribut gibt an, dass das Element nicht bearbeitbar ist, aber dennoch bedienbar bleibt.
Beschreibung
Wenn Sie anzeigen möchten, dass ein interaktives Element funktioniert, aber nicht bearbeitbar ist, setzen Sie aria-readonly="true". Dies signalisiert dem Benutzer, dass ein interaktives Element, das normalerweise fokussierbar und kopierbar wäre, in einem schreibgeschützten (nicht deaktivierten) Zustand versetzt wurde.
Wenn aria-readonly auf true gesetzt ist, bedeutet dies, dass der Benutzer den Wert des Widgets lesen, aber nicht setzen 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 umfassen:
- Formularelemente, die nicht geändert werden sollten.
- Zeilen- und SpaltenĂĽberschriften in einer Tabelle.
- Der Gesamtwert in einem Einkaufswagen.
Wenn der nicht veränderbare Wert keinen Fokus erhalten sollte, verwenden Sie stattdessen aria-disabled.
Hinweis:
Wenn Sie semantische HTML-Formularsteuerelemente 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, was readonly irrelevant macht. 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 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
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-readonly |