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

Button

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

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

Accesibilidad

Contrato de accesibilidad

Teclado

Enter
Activa el botón cuando tiene enfoque.
Space
Activa el botón cuando tiene enfoque.

Foco

  • Button.Root se renderiza como un elemento nativo `<button>` y recibe enfoque por defecto.
  • Los botones deshabilitados y en carga se eliminan del orden de tabulación a través del atributo nativo `disabled`.

Semántica

  • Se renderiza como un elemento nativo `<button>` con `data-scope="button"` y `data-part="root"`.
  • Cuando `loading` es true, establece `aria-busy="true"` y deshabilita el botón.
  • ToggleButton se renderiza como un `<button>` con `aria-pressed` que refleja el estado presionado y `data-part="toggle"`.
  • IconButton envuelve los hijos en `aria-hidden="true"` y requiere `aria-label` para el nombre accesible.
  • ButtonGroup se renderiza como un `<div>` con `role="group"` y `data-part="group"`.
  • Lleva los atributos `data-disabled` y `data-loading` cuando los estados respectivos están activos.

ARIA

  • `aria-busy="true"` indica que el botón está en estado de carga.
  • `aria-pressed` en ToggleButton indica el estado actual de alternancia.
  • `aria-label` en IconButton proporciona el nombre accesible para botones solo con icono.
  • `role="group"` en ButtonGroup asocia botones relacionados.

Responsabilidades del consumidor

  • Asegurar que el texto del botón o `aria-label` comunique claramente la acción.
  • Usar `IconButton` con un `aria-label` significativo cuando el botón no contiene texto visible.
  • Usar `ToggleButton` para acciones que alternan entre dos estados, y gestionar el estado `pressed` externamente.
  • Usar `ButtonGroup` para agrupar botones lógicamente relacionados con un contexto visual compartido.

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
3
Infracciones
0
Incompletas
0

Último análisis ejecutado: 13 ago 2026, 22:47

Identificadores de evidencia: axe-button-scan-v1

Las comprobaciones automatizadas solo cubren el escenario registrado y no establecen una conformidad de accesibilidad completa.