Element: ariaBrailleRoleDescription-Eigenschaft

Baseline 2024

Newly available

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

Die ariaBrailleRoleDescription-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-brailleroledescription-Attributs wider, das die ARIA-Braille-Rollenbeschreibung des Elements definiert.

Diese Eigenschaft kann verwendet werden, um eine abgekürzte Version des aria-roledescription-Wertes bereitzustellen. Sie sollte nur verwendet werden, wenn aria-roledescription vorhanden ist und in dem seltenen Fall, dass es für Braille zu ausführlich ist. Das aria-brailleroledescription-Attribut enthält zusätzliche Informationen darüber, wann die Eigenschaft gesetzt werden sollte.

Wert

: Der Wert ist eine Zeichenkette, ein nicht eingeschränkter Werttyp, der in Braille umgewandelt werden soll.

Beispiele

Abrufen und Festlegen von ariaBrailleRoleDescription

Dieses Beispiel zeigt, wie Sie die ariaBrailleRoleDescription-Eigenschaft abrufen und festlegen können.

HTML

Zuerst definieren wir ein

-Element, das als Folie in einer Diaschau verwendet wird. Wir setzen das aria-roledescription-Attribut auf "slide" und seine Braille-Abkürzung in aria-brailleroledescription auf "sld".

html


  Welcome to my talk

#log {
  height: 70px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

Um die Rollenbeschreibung des Elements zu erhalten, verwenden wir die ariaBrailleRoleDescription-Eigenschaft. Der untenstehende Code ruft zuerst den Wert ab und protokolliert ihn. Anschließend wird die Braille-Rollenbeschreibung auf "sd" gesetzt und der Wert erneut protokolliert (nur zur Veranschaulichung — im Produktionscode würden Sie diesen Wert nicht setzen).

const article = document.getElementById("article");
log(article.ariaBrailleRoleDescription);
article.ariaBrailleRoleDescription = "sd";
log(article.ariaBrailleRoleDescription);

Ergebnis

Spezifikationen

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