- Inicio
- Primitivas
- Alert
- Accesibilidad
Alert
Teclado, enfoque, semántica y responsabilidades del consumidor para Alert.
Accesibilidad
Contrato de accesibilidad
Semántica
- Renders Root como un `<div>` con `role="alert"` (assertive) o `role="status"` (polite).
- Title se renderiza como un `<h5>` y se conecta a `aria-labelledby` en el Root.
- Description se renderiza como un `<div>` y se conecta a `aria-describedby` en el Root.
- Los IDs se generan con `createStableId` para consistencia compatible con SSR.
- Lleva los atributos `data-scope="alert"`, `data-part` y `data-state` en todas las partes.
ARIA
- `role="alert"` indica una región en vivo asertiva que interrumpe al usuario para anunciar el mensaje inmediatamente.
- `role="status"` indica una región en vivo cortés que anuncia el mensaje en la siguiente oportunidad sin interrupción.
- `aria-labelledby` en Root referencia el ID estable de Title para proporcionar un nombre para el alert.
- `aria-describedby` en Root referencia el ID estable de Description para proporcionar una descripción para el alert.
Responsabilidades del consumidor
- Siempre incluir un Title para que los lectores de pantalla puedan anunciar un nombre significativo para el alert.
- Usar `assertiveness="polite"` para actualizaciones no urgentes como cambios de estado o notificaciones.
- Usar `assertiveness="assertive"` (default) para información crítica que requiere atención inmediata.
- No eliminar y recrear programáticamente el alert para volver a anunciar; usar un role polite o gestionar cambios de `aria-live` en su lugar.
No aplicable
- keyboard
- Alert es un elemento de presentación no interactivo sin interacciones de teclado.
- focus
- Alert es un elemento de presentación no interactivo y no recibe enfoque. Anuncia contenido a las tecnologías de asistencia sin robar el enfoque.
Estado de revisión: Borrador — aún no revisado
Este contrato describe lo que garantiza la primitiva. Los productos que la consumen siguen siendo responsables de las etiquetas, el diseño y las decisiones de flujo que afectan el resultado final de accesibilidad.
Evidencia automatizada
Resumen del análisis axe
- Comprobaciones superadas
- 9
- Infracciones
- 0
- Incompletas
- 1
Último análisis ejecutado: 13 ago 2026, 22:47
Identificadores de evidencia: axe-alert-scan-v1
Las comprobaciones automatizadas solo cubren el escenario registrado y no establecen una conformidad de accesibilidad completa.