Элемент: свойство ariaBrailleRoleDescription

Свойство ariaBrailleRoleDescription интерфейса Element отражает значение атрибута aria-brailleroledescription, который определяет описание роли элемента в ARIA для брайлевского шрифта.

Это свойство может использоваться для предоставления сокращённой версии значения aria-roledescription. Оно должно использоваться только в том случае, если aria-roledescription присутствует и в редких случаях, когда значение слишком громоздко для брайлевского шрифта. aria-brailleroledescription содержит дополнительную информацию о том, когда следует устанавливать свойство.

<string>

Значение — строка, тип значения без ограничений, предназначенная для преобразования в брайлевский шрифт.

Этот пример демонстрирует, как получить и установить свойство ariaBrailleRoleDescription.

HTML

Сначала мы определяем элемент <article>, который будет использоваться как слайд в презентации. Мы устанавливаем атрибут aria-roledescription со значением "slide", а его сокращение для брайлевского шрифта aria-brailleroledescription со значением "sld".

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

JavaScript

Для получения описания роли элемента используется свойство ariaBrailleRoleDescription. В данном коде сначала извлекается значение, а затем выводится в консоль. Затем устанавливается значение описания роли для брайлевского шрифта на "sd" и снова выводится в консоль (только для иллюстрации — в рабочем коде вы не устанавливаете это значение).

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

Результат