# Desplegable accesible (combobox): ARIA y teclas

Source: https://allyway.ai/es/glossary/desplegable-accesible

Un desplegable accesible (combobox) es un campo de entrada o de selección que abre una lista de opciones y muestra a las tecnologías de apoyo su rol, su etiqueta, su estado de expansión y la opción actual, con compatibilidad total con el teclado. Los comboboxes personalizados entran en el criterio WCAG 4.1.2 Nombre, función, valor, de nivel A.

Un desplegable accesible (combobox) es un campo que abre una lista de opciones, como un selector de país, un cuadro de búsqueda con sugerencias o un filtro de tienda, y que funciona para todos. Los desplegables personalizados de las bibliotecas de interfaz suelen sustituir el `<select>` nativo por `div`s: tienen un aspecto moderno, pero el teclado no puede abrirlos, los lectores de pantalla no saben que existe la lista y el valor elegido nunca se anuncia.

## Qué significa

El desplegable accesible más sencillo es el `<select>` nativo con un `<label>`. El W3C señala que los controles HTML estándar ya cumplen el criterio [WCAG 4.1.2 Nombre, función, valor](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) (nivel A) cuando se usan como indica la especificación. Cuando crea uno propio, el criterio exige que su [nombre, función y valor](https://allyway.ai/es/glossary/nombre-funcion-valor) puedan determinarse por software, que el valor pueda establecerse y que los cambios lleguen a las tecnologías de apoyo. El W3C cita expresamente los comboboxes personalizados como ejemplo.

El [patrón de combobox](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/) de la guía WAI-ARIA Authoring Practices describe las partes:

| Parte | Rol y atributos |
|---|---|
| Campo de entrada | `role="combobox"`, una etiqueta visible, `aria-expanded="false"` o `"true"` |
| Relación con la ventana emergente | `aria-controls` con el ID de la lista |
| Comportamiento de autocompletado | `aria-autocomplete="none"`, `"list"` o `"both"` |
| Opción resaltada | `aria-activedescendant` con el ID de la opción; el foco del teclado permanece en el campo |
| Ventana emergente | `role="listbox"` con hijos `role="option"`; la opción elegida recibe `aria-selected="true"` |

La ventana emergente también puede ser una cuadrícula, un árbol o un cuadro de diálogo; `aria-haspopup` es `listbox` por defecto y solo se indica para esos otros tipos.

| Tecla | Qué ocurre |
|---|---|
| Flecha abajo | Abre la lista si hace falta y se mueve a ella |
| Alt + Flecha abajo (opcional) | Abre la lista sin mover el foco |
| Flecha arriba (opcional) | Se mueve a la última opción |
| Intro | Acepta la opción resaltada |
| Escape | Cierra la lista; opcionalmente, borra el campo si la lista ya estaba cerrada |

> **Warning:** > **No estropee la escritura**
> Un combobox con un campo de texto no debe capturar las teclas que se usan para editar texto, como Inicio, Fin o las flechas izquierda y derecha dentro del campo. El W3C advierte de que los scripts que interfieren con las teclas de edición nativas dificultan el uso del campo.

## Ejemplos

```html title="Ejemplo"
<label for="country">Country</label>
<input id="country" type="text" role="combobox"
       aria-autocomplete="list" aria-expanded="true"
       aria-controls="country-list"
       aria-activedescendant="opt-at">
<ul id="country-list" role="listbox" aria-label="Countries">
  <li id="opt-at" role="option" aria-selected="true">Austria</li>
  <li id="opt-de" role="option" aria-selected="false">Germany</li>
  <li id="opt-ch" role="option" aria-selected="false">Switzerland</li>
</ul>
```

La [etiqueta de formulario](https://allyway.ai/es/glossary/etiquetas-de-formulario) da nombre al campo. Mientras el usuario pulsa las flechas, el script mueve `aria-activedescendant` de una opción a otra, de modo que un lector de pantalla anuncia «Austria, 1 de 3» sin sacar el foco del campo. Cuando la lista se cierra, `aria-expanded` vuelve a `false`.

**Do:** Qué hacer

Use un `<select>` nativo cuando las personas solo elijan de una lista corta, dé una etiqueta visible a cada combobox, mantenga al día `aria-expanded` y `aria-activedescendant` y deje que Escape cierre la lista.

**Don't:** Qué evitar

Sustituir `<select>` por un `div` que solo se abre con un clic, usar un botón de menú para mostrar un valor seleccionado, depender del texto de marcador de posición (placeholder) como única etiqueta, o mover el foco del teclado a la lista de forma que impida escribir.

## Cómo comprobar un desplegable accesible (combobox)



## Preguntas frecuentes

Q: ¿Cómo se hace accesible un desplegable?
A: Empiece con un `<select>` nativo y un `<label>`. Si necesita búsqueda o sugerencias, cree un combobox: `role="combobox"` en el campo, `aria-expanded`, `aria-controls` hacia un `listbox`, `aria-activedescendant` para la opción resaltada y compatibilidad total con las teclas de flecha.

Q: ¿Es accesible un select nativo?
A: Sí. Los controles HTML estándar cumplen el criterio WCAG 4.1.2 cuando se usan como se especifica, y los navegadores se encargan del teclado y de la compatibilidad con lectores de pantalla en `<select>`. Sus principales límites son el diseño visual y la falta de un campo de búsqueda.

Q: ¿Qué diferencia hay entre un combobox y un listbox?
A: Un listbox es una lista de opciones siempre visible. Un combobox es un campo de entrada que controla una ventana emergente, normalmente un listbox, que se abre y se cierra.

Q: ¿Debe el foco pasar a la lista del desplegable?
A: En el patrón del W3C para una ventana emergente de tipo listbox, el foco del DOM permanece en el campo y `aria-activedescendant` apunta a la opción resaltada. Así las personas pueden seguir escribiendo mientras recorren las sugerencias.

Q: ¿Son lo mismo los menús desplegables y los comboboxes?
A: No. Un botón de menú abre una lista de acciones; un combobox permite elegir o escribir un valor. El W3C señala que los botones de menú no pueden marcarse como obligatorios y no tienen valor, por lo que son la opción equivocada para los campos de los [formularios accesibles](https://allyway.ai/es/glossary/formularios-accesibles).
