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

另請參閱