Accessible Description
Zugängliche Beschreibung
Eine zugängliche Beschreibung fügt hilfreiche Details hinzu, die der zugängliche Name eines Elements nicht liefert. Sie kann ein Format, eine Beschränkung oder eine Konsequenz erklären.
accessible name + role + referenced description -> assistive technology output<label for="email">id="receipt-hint"Beispiel Ausgabeaccessible name + role + referenced description -> assistive technology outputA11YEin weiteres Beispiel
Ein E-Mail-Feld verweist auf einen sichtbaren Datenschutzhinweis mit aria-describedby. Hilfstechnologien können den Namen, die Rolle und die Beschreibung ansagen.
Hauptteile
- 01Sichtbares Etikett
- 02Zugänglicher Name
- 03Sichtbarer Hilfetext
- 04Beschreibungsreferenz
- 05Berechnete Beschreibung
- 06Unterstützende Ausgabe
Verwenden Sie es, wenn
Verwenden Sie eine Beschreibung für hilfreiche Details, die nicht der Name des Elements sind. Beziehen Sie sich nach Möglichkeit auf sichtbaren Text.
Nutze es nicht, wenn
Verwenden Sie keine Beschreibung anstelle eines Labels. Verwenden Sie aria-details, wenn lange strukturierte Inhalte eine eigene Navigation benötigen.
In Code verwendeter Name
accessible name + role + referenced description -> assistive technology output Vor dem Ausliefern
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 Zugängliche Beschreibung (Accessible Description). User context: Ein E-Mail-Feld verweist auf einen sichtbaren Datenschutzhinweis mit aria-describedby. Hilfstechnologien können den Namen, die Rolle und die Beschreibung ansagen. Recommended pattern: Zugängliche Beschreibung (Accessible Description). Why it fits: Verwenden Sie eine Beschreibung für hilfreiche Details, die nicht der Name des Elements sind. Beziehen Sie sich nach Möglichkeit auf sichtbaren Text. Do not use it when: Verwenden Sie keine Beschreibung anstelle eines Labels. Verwenden Sie aria-details, wenn lange strukturierte Inhalte eine eigene Navigation benötigen. 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): Der Standard deckt nur den aufgeführten Umfang ab. Er wählt nicht den visuellen Stil, die Produktentscheidung oder das Vibulary-Beispiel aus. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Diese Anfrage prüfen
Review how Zugängliche Beschreibung (Accessible Description) is used now. Definition: Eine zugängliche Beschreibung fügt hilfreiche Details hinzu, die der zugängliche Name eines Elements nicht liefert. Sie kann ein Format, eine Beschränkung oder eine Konsequenz erklären. 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.