Accessible Description
Descrizione accessibile
Una descrizione accessibile aggiunge dettagli utili che il nome accessibile di un elemento non fornisce. Può spiegare un formato, un limite o una conseguenza.
accessible name + role + referenced description -> assistive technology output<label for="email">id="receipt-hint"output di esempioaccessible name + role + referenced description -> assistive technology outputA11YUn altro esempio
Un campo Email fa riferimento a un suggerimento di privacy visibile con aria-describedby. La tecnologia assistiva può annunciare il nome, il ruolo e la descrizione.
Parti principali
- 01Etichetta visibile
- 02Nome accessibile
- 03Testo di aiuto visibile
- 04Riferimento descrizione
- 05descrizione calcolata
- 06output assistivo
Usalo quando
Usa una descrizione per dettagli utili che non siano il nome dell'elemento. Riferisci il testo visibile quando possibile.
Non usarlo quando
Non usare una descrizione invece di un'etichetta. Usa aria-details quando contenuti strutturati lunghi necessitano di una navigazione propria.
Nome usato nel codice
accessible name + role + referenced description -> assistive technology output Prima di spedire
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 Descrizione accessibile (Accessible Description). User context: Un campo Email fa riferimento a un suggerimento di privacy visibile con aria-describedby. La tecnologia assistiva può annunciare il nome, il ruolo e la descrizione. Recommended pattern: Descrizione accessibile (Accessible Description). Why it fits: Usa una descrizione per dettagli utili che non siano il nome dell'elemento. Riferisci il testo visibile quando possibile. Do not use it when: Non usare una descrizione invece di un'etichetta. Usa aria-details quando contenuti strutturati lunghi necessitano di una navigazione propria. 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): Lo standard copre solo l'ambito elencato. Non sceglie lo stile visivo, la decisione sul prodotto o l'esempio di vocabolario. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Controlla questa richiesta
Review how Descrizione accessibile (Accessible Description) is used now. Definition: Una descrizione accessibile aggiunge dettagli utili che il nome accessibile di un elemento non fornisce. Può spiegare un formato, un limite o una conseguenza. 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.