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

Element:ariaBrailleRoleDescription 属性

· 52CE 我爱测

Element 接口的 **`ariaBrailleRoleDescription`** 属性反映 `aria-brailleroledescription` 属性的值,该属性定义元素的 ARIA 盲文角色描述。

DOM

Element 接口的 ariaBrailleRoleDescription 属性反映 aria-brailleroledescription 属性的值,该属性定义元素的 ARIA 盲文角色描述。

此属性可用于提供 aria-roledescription 值的缩略版本。仅当存在 aria-roledescription,且它对于盲文而言过于冗长这一少见情形下,才应使用该属性。aria-brailleroledescription 包含有关应在何时设置该属性的更多信息。

值

  • <string>
    • : 该值是一个无约束的字符串值类型,旨在转换为盲文。

示例

获取和设置 ariaBrailleRoleDescription

本示例展示如何获取和设置 ariaBrailleRoleDescription 属性。

HTML

首先,定义一个用作幻灯片放映中幻灯片的 <article> 元素。将 aria-roledescription 属性设为 "slide",并将其在 aria-brailleroledescription 中的盲文缩写设为 "sld"。

<article
  id="article"
  aria-roledescription="slide"
  aria-brailleroledescription="sld"
  aria-labelledby="slide1heading">
  <h1 id="slide1heading">欢迎参加我的演讲</h1>
</article>
<pre id="log"></pre>
#log {
  height: 70px;
  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;
}

使用 ariaBrailleRoleDescription 属性获取元素的角色描述。以下代码先获取并记录该值,随后将盲文角色描述设为 "sd" 并再次记录该值(仅用于说明;生产代码中不应设置此值)。

const article = document.getElementById("article");
log(article.ariaBrailleRoleDescription);
article.ariaBrailleRoleDescription = "sd";
log(article.ariaBrailleRoleDescription);

结果

获取和设置 ariaBrailleRoleDescription

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

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

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

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