大网数据广告活动
Web 标准与前端开发

Element:ariaBrailleLabel 属性

· 52CE 我爱测

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

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。