此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Element:ariaBrailleRoleDescription 属性

基线 2024
最近可用

自 2024年9月 起,此特性已在最新浏览器中得到支持。但在较旧的设备或浏览器中可能无法运行。

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

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

<string>

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

示例

获取和设置 ariaBrailleRoleDescription

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

HTML

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

html
<article
  id="article"
  aria-roledescription="slide"
  aria-brailleroledescription="sld"
  aria-labelledby="slide1heading">
  <h1 id="slide1heading">欢迎参加我的演讲</h1>
</article>

JavaScript

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

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

结果

规范

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

浏览器兼容性