Element：ariaBrailleLabel 属性

基线 2024

值

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

示例

获取和设置 ariaBrailleLabel

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

HTML

首先，我们定义一个按钮，其标签文本为“3 out of 5 stars”，并且 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);

结果

规范

规范
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariabraillelabel

浏览器兼容性

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 2026年9月1日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题