Element: role-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.
Die role-Eigenschaft des Element-Interfaces gibt die explizit festgelegte WAI-ARIA-Rolle für das Element zurück.
Alle HTML-Elemente haben eine implizite ARIA-Rolle, selbst wenn diese Rolle generic ist. Diese semantische Zuordnung ermöglicht es Werkzeugen, die Interaktion mit dem Objekt in einer Weise darzustellen und zu unterstützen, die mit den Benutzererwartungen über andere Objekte dieses Typs übereinstimmt. Das role-Attribut wird verwendet, um die ARIA-Rolle des Elements explizit festzulegen und die implizite Rolle zu überschreiben. Zum Beispiel könnte ein <ul>, das eine implizite list Rolle hat, explizit den role="treegrid" zugewiesen bekommen. Die role-Eigenschaft spiegelt den explizit gesetzten Wert des role-Attributs wider — in diesem Fall treegrid; sie gibt nicht die implizite list-Rolle des Elements zurück, es sei denn, sie wurde explizit festgelegt.
Die vollständige Liste der definierten ARIA-Rollen finden Sie auf der Referenzseite ARIA roles.
Wert
Ein String; der Wert des role-Attributs oder null, wenn nicht explizit festgelegt.
Beispiele
In diesem Beispiel erhalten Bilder mit leeren oder fehlenden alt-Attributen eine role von presentation:
const images = document.querySelectorAll("img");
images.forEach((image) => {
if (!image.alt) {
image.role = "presentation";
}
});
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-role |
