aria-description

全域性 aria-description 屬性定義一個字串值，用於描述或註釋當前元素。

注意：aria-description 仍在 W3C ARIA 1.3 的編輯草案中。目前，請繼續使用 aria-describedby，該屬性自 ARIA 1.1 起就得到支援。

描述

全域性 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，因為它們都提供一個文字字串與元素關聯，但標籤應簡短且簡潔，而描述可以更長，因為它旨在提供更多上下文和資訊。

aria-description 和 aria-describedby 屬性具有相同的用途；兩者都為使用者提供了對其設定的物件的附加描述性文字。如果 DOM 中有描述性文字可用，請改用 aria-describedby。

只有在提供可見描述不是所需的使用者體驗時，才應使用 aria-description 屬性。aria-describedby 屬性將其值作為包含有關物件描述性文字的元素的 id 列表。當沒有合適的描述性文字可以透過 id 引用與物件關聯時，使用 aria-description。如果兩個屬性都存在，則 aria-describedby 在定義 可訪問描述 屬性方面優先。

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

值

<字串>

該值是一個字串，一個不受約束的值型別，旨在傳達給輔助技術使用者。

關聯介面

Element.ariaDescription

ariaDescription 屬性（Element 介面的一部分）反映了 aria-description 屬性的值，該屬性定義一個字串值，用於描述或註釋當前元素。

關聯角色

用於**所有**角色。

規範

規範
可訪問的富網際網路應用程式 (WAI-ARIA)
# aria-description

另請參閱