ARIA: aria-brailleroledescription 属性

描述

盲文并非字母和数字的一对一转写，而是包含各种缩写、合同语和代表单词的字符（称为象形文字）。

与将较长的角色描述转换为盲文不同，aria-brailleroledescription 属性允许提供 aria-roledescription 值的缩写版本。aria-roledescription 是一个人类可读的、作者本地化的描述，用于表示元素的角色，以改善盲文界面的用户体验。

基本上，aria-brailleroledescription 的值是 aria-roledescription 属性的一个将要转换为盲文的缩写版本。

html

<article
  aria-roledescription="slide"
  aria-brailleroledescription="sld"
  aria-labelledby="slide1heading">
  <h1 id="slide1heading">Welcome to my talk</h1>
  <img alt="Me" src="images/me.jpg" />
</article>

大多数辅助技术，如屏幕阅读器，会以上述内容读取为“幻灯片，欢迎参加我的演讲。图片，我。”盲文辅助技术会以盲文形式呈现“sld welcome to my talk gra me”。语义化的 <article> 通过 aria-roledescription 属性被赋予了“slide”的角色；“slide”是一个规范中未定义的角色，但常用于演示文稿中的幻灯片。在盲文中，该角色被表示为“sld”。“gra”是“graphic”（图形）的缩写，这也是“image”（图像）角色在盲文中被缩写的方式。

aria-brailleroledescription 属性仅应用于澄清非交互式容器角色（如“group”或“region”）的目的，或在盲文上下文中为小部件提供更具体的描述。

由于 aria-brailleroledescription 属性会覆盖辅助技术如何在盲文中本地化和表达角色的名称，不恰当的值将阻止用户在盲文界面上理解和与元素进行交互。

只有在存在 aria-roledescription 时才使用 aria-brailleroledescription。但是，如果 aria-roledescription 的值在盲文中可用，则不需要该属性的盲文版本。总的来说，aria-brailleroledescription 仅应在 aria-roledescription 对于盲文来说过于冗长的情况下，在极少数情况下使用。

几条规则需要记住

仅将 aria-brailleroledescription 应用于具有有效 ARIA 角色或具有隐式角色语义的元素。
如果存在 aria-brailleroledescription，则其值必须是非空、非 null 的，并且与 aria-roledescription 的值不同，而后者又与 ARIA 显式或隐式语义角色不同。
避免使用 Unicode 盲文模式。如果必须使用，请确保 aria-brailleroledescription 值包含除 Unicode 盲文模式、空白字符和盲文模式点-0（dots-0）以外的内容。
确保值始终根据文档的语言进行本地化。

警告：如果内容仅包含 Unicode 盲文模式，则该值不会根据用户首选的翻译表进行翻译。

注意：请勿使用 aria-brailleroledescription 来复制 aria-roledescription。仅在 aria-roledescription 未提供足够的盲文表示时才包含此属性。

如果以下情况，aria-brailleroledescription 的值将不会暴露给盲文用户：

该值为空、仅包含空白字符，或为空盲文模式：点-0（U+2800）。
应用该属性的元素具有显式或隐式的 WAI-ARIA 角色，其中 aria-brailleroledescription 是被禁止的，包括 generic 角色。
应用该属性的元素没有有效的 aria-roledescription。

注意：请与日常使用辅助技术的用户（包括盲文读者）一起测试您的网站和应用程序，以确保您的内容在盲文中具有意义。