ARIA: 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

另见