Element: role-Eigenschaft

Baseline 2023
Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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:

js
const images = document.querySelectorAll("img");
images.forEach((image) => {
  if (!image.alt) {
    image.role = "presentation";
  }
});

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-role

Browser-Kompatibilität

Siehe auch