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。

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