Formación

Un curso a tu ritmo para un equipo que adopta Lily: ocho módulos, cada uno con un objetivo, algo que leer, un ejercicio en un navegador real y una autoevaluación con respuestas. Alrededor de un día en total; un módulo por sesión funciona bien.

Antes de empezar

Elige un tutorial de framework y termínalo primero. Ejecuta una de las aplicaciones de ejemplo en local, o usa las páginas de componentes de este sitio, para los ejercicios. Necesitas un teclado y, para el módulo 8, un lector de pantalla: VoiceOver en macOS e iOS, NVDA en Windows o TalkBack en Android, todos gratuitos.

Módulo 1 — Qué significa headless

Objetivo: saber qué decide Lily y qué decides tú.

Lee: la página Acerca de, y una página de componente, como Button, de principio a fin.

Haz: muestra un Button y un TextInput sin hoja de estilos. Luego enlaza un tema, y después otro. Anota qué cambió y qué no.

Autoevaluación: ¿qué no incluye nunca un componente de Lily? ¿Qué incluye siempre?

Nunca: CSS, fuentes, iconos ni imágenes (salvo los iconos de los selectores), texto en inglés, obtención de datos, idioma o moneda por defecto. Siempre: el elemento HTML más específico, su clase en kebab-case primero, ARIA donde el HTML no basta, comportamiento de teclado y tus otros atributos transmitidos.

Autoevaluación: quieres un borde rojo en un botón. ¿Dónde va?

En tu CSS, sobre la clase (.button) o sobre una clase que añadas. Nunca en el componente.

Módulo 2 — Teclado y foco

Objetivo: usar y probar cada componente sin ratón.

Lee: la tabla de interacciones de teclado de TabBar, Listbox y Dialog.

Haz: desconecta el ratón. En cada una de esas tres páginas, llega a la demo con Tab y haz todo lo que indica la tabla. Abre el diálogo, pulsa Escapey fíjate dónde queda el foco.

Autoevaluación: ¿por qué una barra de pestañas ocupa una sola parada de Tab y no una por pestaña?

El patrón compuesto de la APG: Tab se mueve entre widgets y las flechas se mueven dentro de uno (un índice de tabulación itinerante). Una barra con diez paradas obliga a quien usa el teclado a pulsar Tab diez veces para pasarla.

Autoevaluación: al cerrarse un diálogo modal, ¿dónde debe estar el foco?

En el control que lo abrió. Los diálogos modales de Lily usan showModal(), que además mantiene Tab dentro del diálogo mientras está abierto.

Módulo 3 — Nombres, roles y estados

Objetivo: dar a cada control un nombre que un lector de pantalla pueda decir, con tus palabras.

Lee: la sección ARIA de IconButton y SwitchButton.

Haz: en tu propia aplicación, con su servidor de desarrollo, muestra un IconButton sin su label. Abre la consola del navegador: Lily avisa de que el control no tiene nombre accesible. Añade la etiqueta y comprueba que el aviso desaparece. (Los avisos solo existen en una compilación de desarrollo, así que una página de producción, como este sitio, no muestra nada.)

Autoevaluación: ¿cuándo usar aria-labely cuándo texto visible?

Texto visible siempre que puedas: todos lo ven y quienes usan entrada por voz pueden decirlo. aria-label solo donde no hay texto visible, como en un icono. Si existen ambos, el nombre debe contener las palabras visibles (WCAG 2.5.3).

Autoevaluación: un estado mostrado solo en rojo. ¿Qué falta?

Texto. El color puede repetir un significado pero nunca transmitirlo solo (WCAG 1.4.1); el estado necesita palabras.

Módulo 4 — Formularios

Objetivo: construir un formulario cuyos errores cualquiera pueda encontrar y corregir.

Lee y haz: el tutorial de formularios accesibles, los cinco pasos.

Autoevaluación: el formulario no supera la validación. ¿Adónde va el foco y qué se lee?

Al resumen de errores, que se anuncia con su encabezado y su lista de enlaces, uno por error, cada uno hacia su campo.

Autoevaluación: ¿por qué no desactivar el botón de envío hasta que el formulario sea válido?

Un botón desactivado no puede decir qué está mal, y mucha gente no entiende por qué no hace nada.

Módulo 5 — Temas y contraste

Objetivo: cambiar el estilo de Lily sin romper el contraste ni el foco.

Lee: el tutorial de temas y la tabla de contraste de los temas .

Haz: sustituye --color-primary por el color de tu marca. Comprueba que su pareja, --color-primary-content, alcanza 4,5:1, y que el anillo de foco sigue viéndose sobre la página.

Autoevaluación: el color de tu marca es demasiado claro para texto blanco. ¿Puedes seguir usándolo?

Sí, como decoración (--lily-brand: una franja de cabecera, una línea, el fondo de un logotipo), nunca para texto ni para el borde de un control. El texto y los bordes usan las parejas de contenido del tema.

Módulo 6 — Todo el mundo

Objetivo: que ningún país sea el predeterminado.

Lee y haz: un formulario que funciona en todo el mundo.

Autoevaluación: ¿por qué CurrencyInput no tiene moneda por defecto?

Cualquier valor por defecto sería el dinero de un solo país, erróneo en silencio en todos los demás. Un currencyCode que falta es un defecto de quien llama.

Autoevaluación: una página en árabe. ¿Qué estableces y qué debe hacer tu CSS?

lang="ar" y dir="rtl" (el selector de idioma establece ambos); tu CSS usa propiedades lógicas para que el diseño se refleje solo.

Módulo 7 — Movimiento

Objetivo: animar sin perjudicar a nadie.

Lee: las recetas de movimiento.

Haz: activa «reducir movimiento» en tu sistema operativo y recarga una página con la receta de la marquesina. Debe quedarse quieta y ajustarse en líneas. Luego llega a su botón de pausa con el teclado.

Autoevaluación: algo se mueve solo durante más de cinco segundos. ¿Qué debe tener?

Una forma de pausarlo, detenerlo u ocultarlo (WCAG 2.2.2), accesible con el teclado, no solo al pasar el puntero.

Módulo 8 — Comprueba tu trabajo

Objetivo: probar una página como Lily prueba las suyas.

Haz: toma una página que hayas construido en este curso y haz cuatro comprobaciones:

  1. axe (la extensión del navegador, o @axe-core/playwright en una prueba): ninguna infracción.
  2. Solo teclado: cada tarea completada, foco siempre visible, nunca atrapado.
  3. Zoom al 400 % y ventana reducida a 320 píxeles: sin desplazamiento horizontal, nada cortado.
  4. Un lector de pantalla: cada control tiene nombre, rol y estado, y los errores se anuncian.
Autoevaluación: axe no informa de infracciones. ¿La página es accesible?

Aún no está demostrado. Las pruebas automáticas encuentran quizá un tercio de los problemas; las comprobaciones de teclado, zoom y lector de pantalla encuentran buena parte del resto. Consulta la página de calidad para ver qué ha verificado Lily y qué no.

Después del curso