aria-brailleroledescription

全局 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 属性被赋予“幻灯片”的角色；“幻灯片”是在规范中未定义的角色，但在演示文稿中的幻灯片中是常见角色。在盲文中，该角色显示为“sld”。“gra”是“graphic”的缩写，这是盲文中“image”角色的缩写。

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

由于 aria-brailleroledescription 属性会覆盖辅助技术在盲文中本地化和表达角色名称的方式，因此不合适的价值观会阻止用户理解和交互盲文界面上的元素。

仅当存在 aria-roledescription 时，才使用 aria-brailleroledescription。但是，如果 aria-roledescription 值在盲文中有效，则不需要该属性的盲文版本。通常，仅当 aria-roledescription 对盲文来说过于冗长时，才应使用 aria-brailleroledescription。

一些需要记住的规则

仅将 aria-brailleroledescription 应用于具有有效 ARIA 角色或具有隐式角色语义的元素。
如果存在 aria-brailleroledescription，则必须具有非空、非 null 值，并且该值必须不同于 aria-roledescription 值，而 aria-roledescription 值又必须不同于 ARIA 显式或角色或隐式语义角色。
避免使用 Unicode 盲文模式。如果必须使用，请确保 aria-brailleroledescription 值包含除 unicode 盲文模式、空格和盲文模式点-0 之外的内容。
确保该值始终本地化为文档的语言。

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

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

如果满足以下条件，则盲文用户将不会看到 aria-brailleroledescription 值

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

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