ARIA: aria-description 屬性

描述

全域性 aria-description 屬性提供了一種機制，供開發者描述或註解當前元素，為輔助技術使用者提供更豐富的上下文資訊。

html

<div
  role="application"
  aria-label="calendar"
  aria-description="Game schedule for the Boston Red Sox 2021 Season">
  <h1>Red Sox 2021</h1>
  <div role="grid">…</div>
</div>

aria-description 屬性與 aria-label 相似，都提供了一個與元素關聯的文字字串。但是，標籤（label）應簡短而簡潔，而描述（description）可以更長，因為其目的是提供更多的上下文和資訊。

aria-description 和 aria-describedby 屬性具有相同的目的；都為使用者提供有關其設定物件的附加描述性文字。如果 DOM 中存在描述性文字，請使用 aria-describedby 替代。

只有在不希望提供可見描述的情況下，才應使用 aria-description 屬性。aria-describedby 屬性的值是包含有關該物件的描述性文字的元素的 id 列表。當沒有合適的描述性文字可以透過 id 引用與物件關聯時，則使用 aria-description。如果同時存在這兩個屬性，則 aria-describedby 在定義可訪問描述屬性時具有優先權。

無論是透過 aria-description 還是 aria-describedby 設定的描述內容，都應為純文字。如果內容非常長、具有語義要求或結構上的導航性，請使用 aria-details 替代。