Accessible Description
Descripción accesible
Una descripción accesible agrega detalles útiles que el nombre accesible de un elemento no proporciona. Puede explicar un formato, límite o consecuencia.
accessible name + role + referenced description -> assistive technology output<label for="email">id="receipt-hint"salida de ejemploaccessible name + role + referenced description -> assistive technology outputA11YOtro ejemplo
Un campo de correo electrónico hace referencia a un aviso de privacidad visible con aria-describedby. La tecnología de asistencia puede anunciar el nombre, el rol y la descripción.
Partes principales
- 01Etiqueta visible
- 02Nombre accesible
- 03Texto de ayuda visible
- 04Referencia de descripción
- 05Descripción calculada
- 06salida de asistencia
Úsalo cuando
Usa una descripción para detalles útiles que no sean el nombre del elemento. Haz referencia al texto visible cuando sea posible.
No lo uses cuando
No use una descripción en lugar de una etiqueta. Use aria-details cuando el contenido largo y estructurado necesite su propia navegación.
Nombre usado en código
accessible name + role + referenced description -> assistive technology output Antes de lanzarlo
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 Descripción accesible (Accessible Description). User context: Un campo de correo electrónico hace referencia a un aviso de privacidad visible con aria-describedby. La tecnología de asistencia puede anunciar el nombre, el rol y la descripción. Recommended pattern: Descripción accesible (Accessible Description). Why it fits: Usa una descripción para detalles útiles que no sean el nombre del elemento. Haz referencia al texto visible cuando sea posible. Do not use it when: No use una descripción en lugar de una etiqueta. Use aria-details cuando el contenido largo y estructurado necesite su propia navegación. 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): El estándar cubre únicamente el alcance listado. No elige el estilo visual, la decisión del producto ni el ejemplo de Vibulary. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Revisa esta petición
Review how Descripción accesible (Accessible Description) is used now. Definition: Una descripción accesible agrega detalles útiles que el nombre accesible de un elemento no proporciona. Puede explicar un formato, límite o consecuencia. 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.