ARIA: aria-describedby-Attribut
Das globale aria-describedby-Attribut identifiziert das Element (oder die Elemente), das/die das Element beschreibt/beschreiben, auf dem das Attribut gesetzt ist.
Beschreibung
Das aria-describedby-Attribut listet die id-s der Elemente auf, die das Objekt beschreiben. Es wird verwendet, um eine Beziehung zwischen Widgets oder Gruppen und dem Text herzustellen, der sie beschreibt.
Das aria-describedby-Attribut ist nicht auf Formularelemente beschränkt. Es kann auch verwendet werden, um statischen Text mit Widgets, Elementgruppen, Bereichen mit einer Überschrift, Definitionen und mehr zu verknüpfen. Das aria-describedby-Attribut kann mit semantischen HTML-Elementen und mit Elementen verwendet werden, die eine ARIA role haben.
Das aria-describedby-Attribut ist dem aria-labelledby-Attribut sehr ähnlich. Während aria-labelledby die ids der Labels oder Elemente auflistet, die das Wesentliche eines Objekts beschreiben, listet aria-describedby die ids der Beschreibungen oder Elemente auf, die weitere Informationen bieten, die der Benutzer benötigen könnte. Sowohl aria-labelledby als auch aria-describedby verweisen auf andere Elemente, um eine Textalternative zu berechnen, aber ein Label sollte prägnant sein, während eine Beschreibung dazu dient, ausführlichere Informationen bereitzustellen; ein Label beschreibt das Wesentliche eines Objekts, während eine Beschreibung weitere Informationen bereitstellt, die der Benutzer benötigen könnte.
Die über aria-describedby verknüpften Elemente müssen nicht sichtbar sein. Es ist möglich, auf ein Element zu verweisen, selbst wenn dieses Element verborgen ist. Zum Beispiel kann ein Formularelement eine Beschreibung haben, die standardmäßig verborgen ist und auf Anfrage mit einem Offenlegen-Widget wie einem "mehr Informationen"-Icon angezeigt wird. Die sehenden Benutzer klicken auf das Icon, um die Beschreibung anzuzeigen, während Benutzer von unterstützenden Technologien sofort darauf zugreifen können, da die Beschreibung von diesem Formularelement mit aria-describedby referenziert wird.
Die aria-describedby-Eigenschaft ist geeignet, wenn der zugehörige Inhalt nur aus einfachem Text besteht. Wenn der Inhalt umfangreich ist, nützliche Semantiken enthält oder eine komplexe Struktur hat, die eine Benutzernavigation erfordert, sollte stattdessen aria-details verwendet werden. aria-details ermöglicht es Benutzern von unterstützenden Technologien, den verbundenen strukturierten Inhalt zu besuchen und zusätzliche Navigationsbefehle bereitzustellen, was es einfacher macht, die Struktur zu verstehen oder die Informationen in kleinere Teile zu erleben.
Hinweis:
Der aria-describedby-Inhalt sollte nur aus einer Textzeichenfolge bestehen. Wenn wichtige zugrunde liegende Semantiken im Inhalt vorhanden sind, sollten Sie in Betracht ziehen, aria-details zu verwenden.
Beispiel
…
Items in the trash will be permanently removed after 30 days.
Hinweis:
Das aria-describedby-Attribut ist nicht dafür vorgesehen, Beschreibungen aus externen Ressourcen zu referenzieren. Da sein Wert eine oder mehrere durch Leerzeichen getrennte ids sind, muss es auf Elemente im selben DOM-Dokument verweisen.
Werte
- ID-Referenzliste
-
Die
idoder durch Leerzeichen getrennte Liste der Element-ids, die das aktuelle Element beschreiben.
Zugehörige Schnittstellen
Element.ariaDescribedByElements-
Die
ariaDescribedByElements-Eigenschaft ist Teil der Schnittstelle jedes Elements. Ihr Wert ist ein Array von Unterklassen vonElement, das dieid-Referenzen imaria-describedby-Attribut widerspiegelt (mit einigen Vorbehalten). ElementInternals.ariaDescribedByElements-
Die
ariaDescribedByElements-Eigenschaft ist Teil der Schnittstelle jedes benutzerdefinierten Elements. Ihr Wert ist ein Array von Unterklassen vonElement, das dieid-Referenzen imaria-describedby-Attribut widerspiegelt (mit einigen Vorbehalten).
Zugehörige Rollen
Verwendet in allen Rollen. Nutzbar in allen HTML-Elementen ebenfalls.
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-describedby |