Web Accessibility Academy · Lección

Combobox y autocompletado bien implementados

Cree un selector con búsqueda que los lectores de pantalla comprendan.

Lección 2 de 413 pasos

Combobox y autocompletado bien implementados es una lección gratuita de Web Accessibility Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Web Accessibility Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Web Accessibility Academy incluye 4 lecciones en total.

Qué es un combobox

Un combobox es un campo de entrada asociado a una ventana emergente de sugerencias. Piense en los cuadros de búsqueda que muestran resultados coincidentes a medida que escribe. 🔍

Dos partes que trabajan juntas

Un combobox tiene un campo de texto donde escribe el usuario y un listbox emergente independiente con las opciones. ARIA conecta ambos para que los lectores de pantalla los relacionen.

El rol del campo de entrada

Coloque role="combobox" directamente en el campo de texto. Esto indica a las tecnologías de asistencia que escribir aquí mostrará una lista de opciones.

<input role="combobox" aria-expanded="false"
  aria-controls="results" type="text">

Apunte a la ventana emergente

Use aria-controls en el campo de entrada y establézcalo con el id de la ventana emergente. Así vincula el campo con el listbox que abre y cierra.

Anuncie si está abierta o cerrada

Cambie aria-expanded a true cuando se muestre la lista y a false cuando se oculte. Los lectores de pantalla anuncian el estado de la ventana emergente a partir de este atributo.

La ventana emergente es un listbox

El contenedor de sugerencias recibe role="listbox" y cada sugerencia recibe role="option". Esto proporciona a los usuarios una lista familiar y navegable.

<ul id="results" role="listbox">
  <li role="option" id="o1">Apple</li>
</ul>

El foco permanece en el campo de entrada

Este es el truco: el foco del teclado nunca abandona el campo de entrada. El usuario sigue escribiendo mientras las teclas de flecha desplazan el resaltado por las opciones.

aria-activedescendant

Haga que aria-activedescendant del campo de entrada apunte al id de la opción resaltada. Así el lector de pantalla lee la opción activa sin mover el foco real.

<input role="combobox"
  aria-activedescendant="o1">

Las teclas esperadas

Flecha abajo y Flecha arriba recorren las opciones, Enter selecciona la activa y Escape cierra la ventana emergente. Estas teclas proceden directamente del APG.

Marque la opción elegida

Establezca aria-selected="true" en la opción resaltada y false en las demás. En un combobox de selección única, solo debe haber una opción seleccionada a la vez.

Comportamiento de autocompletado

Use aria-autocomplete para describir cómo aparecen las sugerencias: «list» para un menú filtrado o «both» cuando el texto también se completa en línea.

Comprobación rápida

El usuario baja con las flechas por las sugerencias de su combobox. ¿Qué atributo indica al lector de pantalla qué opción está activa?

Resumen

Un combobox es un campo de entrada más un listbox: conéctelos mediante aria-controls y aria-expanded, mantenga el foco en el campo y controle la opción activa con aria-activedescendant. ✅

Gratis para empezar

Aprende HTML con un tutor de IA — gratis

Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.

Cursos
30
Lecciones
120

Preguntas frecuentes

¿La lección «Combobox y autocompletado bien implementados» es gratis?

Sí — el texto completo de «Combobox y autocompletado bien implementados» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Web Accessibility Academy, actualiza a CoddyKit PRO. El curso de Web Accessibility Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Combobox y autocompletado bien implementados»?

Cree un selector con búsqueda que los lectores de pantalla comprendan. Practicas Web Accessibility Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Web Accessibility Academy?

No se requiere experiencia previa. Web Accessibility Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «Combobox y autocompletado bien implementados»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Web Accessibility Academy?

Sí. Cada lección de Web Accessibility Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Lectura de la APG: patrones, teclas y ejemplos
  2. Combobox y autocompletado bien implementados
  3. Menu, Menubar y el botón de menú
  4. Treegrid y otros patrones avanzados
← Volver a Web Accessibility Academy