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。

注意：請與日常使用輔助技術的使用者（包括盲文讀者）一起測試您的網站和應用程式，以確保您的內容在盲文中具有意義。