DOM
Element 接口的 ariaBrailleLabel 属性反映了 aria-braillelabel 属性的值,该属性定义了元素的 ARIA 盲文标签。
此元素标签可能会被能够以盲文呈现内容的辅助技术使用,但仅当特定于盲文的标签能够改善用户体验时才应设置。aria-braillelabel 包含有关何时应设置该属性的更多信息。
值
<string>- : 该值是字符串,一种不受约束的值类型,旨在被转换为盲文。
示例
获取和设置 ariaBrailleLabel
此示例展示了如何获取和设置 ariaBrailleLabel 属性。
HTML
首先,我们定义一个按钮,其标签文本为“3 out of 5 stars”,并且 aria-braillelabel 属性的值为 "***"。这允许盲文显示器以盲文显示“btn ***”,而不是更冗长的“btn gra 3 out of 5 stars”。
<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);
结果
获取和设置 ariaBrailleLabel
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
