BetaBeta pública — Consulta las notas de lanzamiento
Documentación

Alert

Teclado, enfoque, semántica y responsabilidades del consumidor para Alert.

Paquete
@solidiom/alert
Versión
0.0.1-next.0
Estado
stable

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.