aria-description

グローバルな aria-description 属性は、開発者が現在の要素を説明または注釈付けして、支援技術ユーザーに優れた文脈を提供するためのメカニズムを提供します。

<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 のリストを値として受け取ります。 aria-description は、id の参照によってオブジェクトに関連付けることができる適切な説明テキストがない場合に使用されます。両方の属性が存在する場合、アクセシブル説明 プロパティの定義では aria-describedby が優先されます。

説明の内容は、aria-description または aria-describedby のどちらで設定してもフラットな文字列にする必要があります。内容が非常に長い場合、セマンティックな意味要件がある場合、またはナビゲーション構造がある場合は、代わりに aria-details を使用してください。

<string>

値は、支援技術のユーザーに伝えることを目的とした、制約のない文字列値です。

Element.ariaDescription

Element インターフェースの一部である ariaDescription プロパティは、現在の要素を説明または注釈する文字列値を定義する aria-description 属性の値を反映します。

すべてのロールで使用されます。

• HTML title 属性
• aria-describedby
• aria-details