Accessible Description
アクセシブル説明
アクセシブルな説明は、要素のアクセシブル名が提供しない有用な詳細を追加します。形式、制限、または結果を説明できます。
accessible name + role + referenced description -> assistive technology output<label for="email">id="receipt-hint"例 出力accessible name + role + referenced description -> assistive technology outputA11Yもう一つの例
Emailフィールドは、aria-describedbyを使用して表示されるプライバシーヒントを参照します。支援技術は名前、役割、説明をアナウンスできます。
主な部分
- 01可視ラベル
- 02アクセシブル名
- 03可視ヘルプテキスト
- 04説明の参照
- 05計算された説明
- 06支援出力
以下の場合に使用します
要素の名前ではない有用な詳細には、説明を使用します。可能な場合は、表示されているテキストを参照してください。
以下の場合は使用しないでください
ラベルの代わりに説明を使用しないでください。長い構造化されたコンテンツが独自のナビゲーションを必要とする場合は、aria-detailsを使用してください。
コードで使用する名前
accessible name + role + referenced description -> assistive technology output 出荷前に
Give each field a label that code can read. Link hints and errors, and keep entered values. Check autofill, keyboard order, validation timing, submit states, failure recovery, zoom, and languages.
Outcome：Complete the task with アクセシブル説明 (Accessible Description)。 User context：Emailフィールドは、aria-describedbyを使用して表示されるプライバシーヒントを参照します。支援技術は名前、役割、説明をアナウンスできます。 Recommended pattern：アクセシブル説明 (Accessible Description)。 Why it fits：要素の名前ではない有用な詳細には、説明を使用します。可能な場合は、表示されているテキストを参照してください。 Do not use it when：ラベルの代わりに説明を使用しないでください。長い構造化されたコンテンツが独自のナビゲーションを必要とする場合は、aria-detailsを使用してください。 Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary)：この標準は、列挙された範囲のみを対象とします。視覚スタイル、製品の判断、またはVibularyの例は選びません。 Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
このリクエストを確認する
Review how アクセシブル説明 (Accessible Description) is used now. Definition: アクセシブルな説明は、要素のアクセシブル名が提供しない有用な詳細を追加します。形式、制限、または結果を説明できます。 Release checks: Give each field a label that code can read. Link hints and errors, and keep entered values. Check autofill, keyboard order, validation timing, submit states, failure recovery, zoom, and languages. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.