# botón

## Qué es

Un botón es la parte de una interfaz que actúa cuando se activa: envía un mensaje, guarda un borrador, abre un diálogo, silencia una llamada. En la web suele ser el elemento HTML `<button>`, y en términos de accesibilidad es cualquier elemento que tenga el rol `button`. «Pulsador» es un nombre más antiguo para lo mismo.

WAI-ARIA 1.2 define el rol como «una entrada que permite acciones iniciadas por el usuario al hacer clic o pulsarla» y añade que los botones se utilizan principalmente para acciones discretas. Un botón de comando simple no conserva ningún estado. Un botón de alternancia, marcado con `aria-pressed`, permanece activado o desactivado hasta que se vuelve a pulsar, y un botón de menú, marcado con `aria-haspopup`, abre una lista de opciones adicionales.

La distinción que más importa es la que separa un botón de un enlace. Un enlace lleva al lector a otro lugar; un botón cambia algo en el lugar donde ya está. La guía ARIA Authoring Practices Guide considera las dos funciones claramente distintas y, cuando un enlace se presenta con aspecto de botón o viceversa, prefiere cambiar el diseño visual para ajustarlo a la función antes que tomar prestado el rol del otro elemento.

El HTML Living Standard describe el elemento `<button>` como un botón etiquetado por su contenido. Su atributo `type` tiene tres palabras clave. `submit` envía el formulario al que pertenece el botón, `reset` devuelve los campos del formulario a sus valores iniciales y `button` no hace nada por sí mismo, dejando la acción a un script. Cuando falta `type` o está mal escrito, el botón está en el estado Auto, y un botón en ese estado dentro de un formulario, sin un comando asociado, es un botón de envío. No puede contener contenido interactivo: ningún enlace, ningún campo ni un segundo botón.

El estándar también permite que un botón actúe sobre otro elemento sin un script: `commandfor` identifica el destino por su ID y `command` indica qué hacer con él, como mostrar un popover o abrir un diálogo como modal. La parte de estas funciones que incorpora un navegador concreto se debe consultar en sus propias notas de versión.

## Por qué importa

Un botón es donde leer se convierte en actuar: comprar, enviar, guardar y eliminar pasan por uno. Un botón que algunas personas no pueden encontrar, alcanzar o entender las excluye de la parte del producto que lo financia.

**El elemento real llega con su comportamiento incorporado.** Un `<button>` recibe el foco del teclado, ejecuta su acción con Espacio y con Intro, comunica a la tecnología de asistencia que es un botón y cómo se llama, y deja de responder cuando tiene `disabled`. El documento explicativo del criterio de conformidad 4.1.2 de WCAG 2.2, Nombre, función, valor, señala que los controles HTML estándar ya cumplen el criterio cuando se utilizan conforme a la especificación. Un `<div>` con un manejador de clics carece de todo esto, y cada parte que se omite deja a alguien fuera.

**El nombre es la promesa.** Un lector de pantalla anuncia un botón por su nombre accesible y su rol, por lo que el nombre debe indicar qué hace el botón, no qué aspecto tiene. La APG añade una regla para los botones de alternancia que es fácil incumplir: la etiqueta permanece igual mientras cambia el estado. Un botón llamado «Mute» («Silenciar») se anuncia como «Mute toggle button pressed» cuando está activado, es decir, «Silenciar, botón de alternancia pulsado». Si un diseño prefiere una etiqueta que alterne entre «Mute» y «Unmute» («Activar sonido»), no hace falta `aria-pressed`, porque la propia etiqueta informa del estado.

**El tamaño es un requisito, no una preferencia.** El criterio de conformidad 2.5.8 de WCAG 2.2, Tamaño del objetivo (mínimo), de nivel AA, exige que un objetivo de puntero tenga «al menos 24 por 24 píxeles CSS». Las excepciones incluyen objetivos pequeños con espacio suficiente alrededor, un control de tamaño completo en otro lugar de la página que haga lo mismo, enlaces dentro de una frase, controles cuyo tamaño fija el navegador y tamaños que son esenciales. Un temblor, un autobús en movimiento y un pulgar en un teléfono dificultan todos el uso de objetivos pequeños.

**El foco debe llegar a un lugar razonable.** Tras una pulsación, la APG espera que el foco pase al interior del diálogo que ha abierto el botón y, cuando ese diálogo se cierra, que normalmente regrese al botón que lo abrió. Cuando la pulsación deja al lector en el mismo contexto, como hace un botón Aplicar, el foco suele permanecer en el botón. Un usuario de teclado cuyo foco salta al principio de la página después de cada guardado tiene que empezar la página de nuevo cada vez.

## Cómo se aplica en la práctica

El caso más claro empieza con un anuncio. En una aplicación SwiftUI construida con símbolos del sistema, el lector de pantalla leía el botón de envío como «arrow up circle, button», porque un símbolo sin etiqueta se anuncia por su nombre interno. El trabajo de [dar nombre a los diecisiete controles que solo tenían iconos para los lectores de pantalla](/es/portfolio/named-all-17-icons-for-screen-readers/) dio a cada uno una etiqueta que nombraba su acción en vez de su forma y, cuando el significado de un control depende de su estado, la etiqueta sigue ese estado. La parte más duradera es la comprobación: un linter que encuentra la construcción que crea un control con solo un icono y exige una etiqueta de accesibilidad a no más de ocho líneas de distancia. El umbral de ocho líneas se eligió mediante medición y es deliberadamente rudimentario: la regla demuestra que hay una etiqueta cerca, no que sea correcta, y alguien sigue teniendo que escucharla.

Una segunda lección trata de lo que un botón no puede hacer. En [la capa de pagos y derechos de acceso](/es/portfolio/built-stripe-and-in-app-purchase-entitlements/), construida sobre Stripe y sobre las compras integradas de Apple y Google, un esquema de acceso independiente de 11 tablas decide si una cuenta puede utilizar el directorio de empresas, la búsqueda y la exportación de datos. El servidor vuelve a hacer esa pregunta en cada solicitud que atiende, porque un botón oculto es una facilidad para el usuario, no un control.

Los botones también importan a los lectores que no son personas. La página del sitio sobre estar [preparado para agentes de IA](/es/ai-ready/) señala que muchos agentes que manejan un navegador leen una página a través de su árbol de accesibilidad, como hace un lector de pantalla. Los botones reales y los formularios etiquetados son parte de lo que permite a un agente encontrar un formulario y rellenarlo.

Las plantillas de este sitio no contienen ningún elemento `<button>`. La llamada «Póngase en contacto», con fondo de color, es un `<a>` con estilo de botón porque lleva a la página de contacto, y su regla en la hoja de estilos fija un `min-height` de 24 píxeles con un comentario que cita el criterio de conformidad 2.5.8. El menú principal es un elemento `<details>` cuyo `<summary>` lo abre y lo cierra, y el comentario de la plantilla indica que el navegador se encarga del estado abierto y de la semántica de botón, sin script.

## Dónde surgen los problemas

- **Una caja en la que se puede hacer clic sustituye al elemento.** Un `<div>` o `<span>` con un manejador de clics responde al ratón y a poco más: no recibe el foco, ignora Espacio e Intro y se anuncia como texto corriente. Añadir `role="button"` solo corrige el anuncio; la gestión del foco y del teclado todavía debe programarse a mano.
- **Un enlace hace el trabajo de un botón, o viceversa.** Un enlace que elimina un registro se puede abrir en una pestaña nueva o guardar como marcador, lo que repite la eliminación o hace perder la referencia a ella. Un botón que solo navega no se puede abrir en una pestaña nueva y no tiene una dirección que se pueda copiar.
- **Un botón sin tipo dentro de un formulario lo envía.** Como la ausencia de `type` pone un botón en el estado Auto, un botón «Añadir otra fila» o «Mostrar contraseña» colocado dentro de un formulario lo envía en cuanto se pulsa. Escribir `type="button"` en cada botón que no deba enviarlo elimina la sorpresa.
- **El icono es toda la etiqueta.** Una papelera, un lápiz o una flecha significan algo para quien los dibujó. Sin un nombre accesible, el lector de pantalla lee un nombre de archivo, un nombre de símbolo o simplemente «button». Lo mejor es una palabra visible; cuando no hay espacio para ella, un nombre accesible que indique la acción cubre la carencia.
- **Un botón oculto o desactivado se considera una medida de seguridad.** Quitar el botón de la página solo detiene a los usuarios que actúan de buena fe; la solicitud que hay detrás se puede seguir enviando y el servidor tiene que decidir por su cuenta si esa cuenta puede hacer eso.

## Lecturas adicionales

- [WAI-ARIA 1.2: rol button](https://www.w3.org/TR/wai-aria-1.2/#button)
  — la definición del rol, sus variantes de alternancia y menú y los estados y propiedades que admite.
- [HTML Living Standard: el elemento button](https://html.spec.whatwg.org/multipage/form-elements.html#the-button-element)
  — el modelo de contenido, los tipos submit, reset y button, el estado Auto y los atributos `command` y `commandfor`.
- [ARIA Authoring Practices Guide: patrón de botón](https://www.w3.org/WAI/ARIA/apg/patterns/button/)
  — botones frente a enlaces, comportamiento del teclado, adónde va el foco después de una pulsación y la regla de las etiquetas de alternancia.
- [Comprender el criterio 2.5.8: tamaño del objetivo (mínimo)](https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html)
  — el mínimo de 24 por 24 píxeles, la prueba de separación y las demás excepciones.
- [Comprender el criterio 4.1.2: nombre, función, valor](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html)
  — por qué cada control necesita un nombre y un rol que el software pueda leer y cuándo los controles HTML estándar ya cumplen el criterio.

<https://engineer.company/es/glossary/button/>
