Элемент: свойство ariaBrailleLabel
Базовая версия 2023
Новое свойство
С октября 2023 года эта функция работает на последних версиях устройств и браузеров. Возможно, эта функция не будет работать на старых устройствах или браузерах.
Свойство ariaBrailleLabel интерфейса Element отражает значение атрибута aria-braillelabel, который определяет метку для брайлевского отображения элемента.
Эта метка может использоваться вспомогательными технологиями, которые могут отображать контент в формате Брайля, но должна устанавливаться только в том случае, если такая метка улучшит пользовательский опыт. aria-braillelabel содержит дополнительную информацию о том, когда следует устанавливать это свойство.
Значение
<string>-
Значение является строкой, не имеющей ограничений по типу, предназначенной для преобразования в брайлевский формат.
Примеры
Получение и установка ariaBrailleLabel
Этот пример демонстрирует, как получить и установить свойство ariaBrailleLabel.
HTML
Сначала мы определяем кнопку с текстом метки "3 из 5 звезд" и атрибутом aria-braillelabel со значением "\*\*\*". Это позволит брайлевскому дисплею отобразить "кнопка ***" вместо более подробного "кнопка оценка 3 из 5 звезд".
<button id="button" aria-braillelabel="\*\*\*">3 out of 5 stars</button>
JavaScript
Затем код использует свойство ariaBrailleLabel кнопки, чтобы сначала получить и вывести метку для брайлевского отображения. После этого он устанавливает метку для брайлевского отображения в "3*" и снова выводит значение.
const button = document.getElementById("button");
log(button.ariaBrailleLabel);
button.ariaBrailleLabel = "3*";
log(button.ariaBrailleLabel);
Результат
Спецификации
| Спецификация |
|---|
| Доступные веб-приложения Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariabraillelabel |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
ariaBrailleLabel |
107 | 107 | 125 | 93 | 18 | 107 | 125 | 73 | 18 | 21.0 | 107 |
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaBrailleLabel