元素：ariaBrailleLabel 属性

ariaBrailleLabel 是 Element 接口的属性，它反映了 aria-braillelabel 属性的值，该属性定义了元素的 ARIA 盲文标签。

此元素标签可以被能够以盲文形式呈现内容的辅助技术使用，但只有在盲文专用标签可以改善用户体验的情况下才应设置。 aria-braillelabel 包含有关何时应设置该属性的更多信息。

价值

<字符串>: 该值是一个字符串，一个不受约束的值类型，旨在转换为盲文。

示例

获取和设置 ariaBrailleLabel

此示例展示了如何获取和设置 ariaBrailleLabel 属性。

HTML

首先，我们定义了一个标签文本为“3 颗星（共 5 颗）”的按钮，以及一个值为 "\*\*\*" 的 aria-braillelabel 属性。这使盲文显示器能够显示“btn ***”的盲文，而不是更冗长的“btn gra 3 out of 5 stars”。

html

<button id="button" aria-braillelabel="\*\*\*">3 out of 5 stars</button>

<pre id="log"></pre>

#log {
  height: 100px;
  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;
}

然后，代码使用按钮的 ariaBrailleLabel 属性首先获取并记录盲文标签。然后，它将盲文标签设置为“3*”，并再次记录该值。

const button = document.getElementById("button");
log(button.ariaBrailleLabel);
button.ariaBrailleLabel = "3*";
log(button.ariaBrailleLabel);

结果

规范

规范
可访问的富互联网应用 (WAI-ARIA) # dom-ariamixin-ariabraillelabel

浏览器兼容性

BCD 表格仅在浏览器中加载