Element: ariaBrailleLabel 属性

Baseline 2024

新推出

自 2024 年 9 月起，此功能已可在最新设备和浏览器版本上使用。此功能可能无法在旧设备或浏览器上使用。

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”。

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

浏览器兼容性

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025年3月6日，由 MDN 贡献者。

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