aria-describedby
全域性 aria-describedby 屬性標識描述設定該屬性的元素的元素(或元素)。
描述
aria-describedby 屬性列出描述物件的元素的 id。它用於建立小部件或組與描述它們文字之間的關係。
aria-describedby 屬性並不侷限於表單控制元件。它還可以用於將靜態文字與小部件、元素組、帶有標題的區域、定義等關聯。aria-describedby 屬性可以與語義 HTML 元素和具有 ARIA role 的元素一起使用。
aria-describedby 屬性與 aria-labelledby 屬性非常相似。雖然 aria-labelledby 列出描述物件本質的標籤或元素的 id,但 aria-describedby 列出描述或元素的 id,這些描述或元素提供使用者可能需要的更多資訊。aria-labelledby 和 aria-describedby 都引用其他元素來計算文字替代方案,但標籤應該簡潔,而描述旨在提供更詳細的資訊;標籤描述物件的本質,而描述提供使用者可能需要的更多資訊。
透過 aria-describedby 連結的元素不需要可見。即使元素被隱藏,也可以引用該元素。例如,表單控制元件可以有一個預設情況下隱藏的描述,該描述可以使用類似於“更多資訊”圖示的公開小部件在請求時顯示。有視覺障礙的使用者會點選該圖示;對於輔助技術使用者,描述會透過 aria-describedby 直接從該表單欄位中引用。
當關聯內容包含作為純文字體驗的描述時,aria-describedby 屬性適用。如果內容包含大量內容、有用的語義或具有需要使用者導航的複雜結構,請使用 aria-details。aria-details 允許輔助技術使用者訪問關聯的結構化內容,並提供額外的導航命令,使其更容易理解結構或以更小的部分體驗資訊。
注意:aria-describedby 內容應該只是一個文字字串。如果內容中存在重要的底層語義,請考慮使用 aria-details。
示例
<button aria-describedby="trash-desc">Move to trash</button>
…
<p id="trash-desc">
Items in the trash will be permanently removed after 30 days.
</p>
注意:aria-describedby 屬性並非旨在引用來自外部資源的描述。由於其值為一個或多個 id(如果多個則以空格分隔),因此它必須引用同一 DOM 文件中的元素。
值
- ID 引用列表
-
描述當前元素的元素
id或以空格分隔的元素id列表。
關聯角色
用於 所有 角色。也可用於所有 HTML 元素。
規範
| 規範 |
|---|
| 可訪問的富網際網路應用程式 (WAI-ARIA) # aria-describedby |
| 可訪問的富網際網路應用程式 (WAI-ARIA) # aria-describedby |