- Inicio
- Primitivas
- Button
- Accesibilidad
Button
Teclado, enfoque, semántica y responsabilidades del consumidor para Button.
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.