Element:ariaBrailleRoleDescription 属性
>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> |