DieariaBrailleRoleDescription-Eigenschaft derElement-Schnittstelle spiegelt den Wert desaria-brailleroledescription-Attributs wider, das die ARIA-Braille-Rollenbeschreibung des Elements definiert.

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

Wert

<string>

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 dieariaBrailleRoleDescription-Eigenschaft abrufen und festlegen können.

HTML

Zuerst definieren wir ein<article>-Element, das als Folie in einer Diaschau verwendet wird. Wir setzen dasaria-roledescription-Attribut auf "slide" und seine Braille-Abkürzung inaria-brailleroledescription auf "sld".

<article   aria-roledescription="slide"  aria-brailleroledescription="sld"  aria-labelledby="slide1heading">  <h1>Welcome to my talk</h1></article>

<pre></pre>

#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 dieariaBrailleRoleDescription-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

Browser-Kompatibilität