aria-braillelabel
全局 aria-braillelabel
属性定义一个字符串值,该值用于标记当前元素,旨在将其转换为盲文。
描述
全局 aria-braillelabel
属性类似于全局 aria-label
,因为它定义了一个字符串值来标记当前元素。虽然 aria-label
由屏幕阅读器读取,但 aria-braillelabel
属性的内容会转换为盲文;为用户提供对象在盲文中的可识别名称。
aria-braillelabel
属性的目的是覆盖辅助技术如何本地化和表达元素在盲文中的可访问名称。仅当没有此属性时,可访问名称在转换为盲文时不会产生所需的的用户体验时才应使用它。
使用 aria-braillelabel
时,请确保
- 应用
aria-braillelabel
的元素具有有效的可访问名称。 aria-braillelabel
的值具有实际内容,并且在 Unicode 或 Unicode 盲文中不为空或仅包含空格。- 该值与可访问名称**不同**。
aria-braillelabel
值已本地化为与文档语言一致。- 告知用户此属性可用,尤其是在内容包含 Unicode 盲文模式时,以便用户知道设置设置以应用用户特定的盲文翻译
注意:支持盲文的辅助技术可以将可访问名称转换为盲文。因此,仅当可访问名称不是您想要的的用户体验时,才使用 aria-braillelabel
。
仅使用可访问名称(例如,来自内容或通过 aria-label
)几乎总是更好的用户体验,因此不要使用 aria-braillelabel 来复制 aria-label。仅当可访问名称无法提供足够的盲文表示时,才使用 aria-braillelabel
。
html
<button aria-braillelabel="***">
<img alt="3 out of 5 stars" src="three_stars.png" />
</button>
盲文显示器可能会显示盲文“btn ***”,而不是更详细的“btn gra 3 out of 5 stars”。
值
<string>
-
该值是一个字符串,一个不受约束的值类型,旨在转换为盲文。
关联角色
用于**所有**角色。
规范
规范 |
---|
可访问的富互联网应用程序 (WAI-ARIA) # aria-braillelabel |