Clase 05 · Módulo 05
Accesibilidad desde el inicio
Accesibilidad desde el inicio
Qué logras en esta clase
Dejas tu web utilizable por personas que navegan de formas distintas a la tuya, y sabes comprobarlo.
- Revisas la estructura semántica de una página.
- Haces la prueba de teclado completa.
- Escribes textos alternativos con criterio.
- Sabes qué detecta una herramienta automática y qué no.
02
Accesible es usable por más gente
Una web accesible funciona sin mouse, sin ver bien la pantalla y sin oír. También funciona mejor para todos los demás.
03
A quién le sirve
- A quien usa un lector de pantalla, un programa que lee la página en voz alta.
- A quien navega solo con teclado, por una lesión o por costumbre.
- A quien ve poco, o mira el celular a pleno sol.
- A quien tiene una mano ocupada o una conexión lenta.
Varias de estas situaciones son temporales. Todos pasamos por alguna.
04
La norma de referencia
WCAG es el conjunto de pautas de accesibilidad web del W3C, el organismo que define los estándares de la web. La versión vigente es la 2.2.
Tiene tres niveles: A, AA y AAA. El objetivo razonable para una web de negocio es el nivel AA.
05
Cuatro frentes para una web de contenido
| Frente | Pregunta de control |
|---|---|
| Semántica | ¿La estructura se entiende sin ver el diseño? |
| Teclado | ¿Se puede hacer todo sin mouse? |
| Percepción | ¿Se lee con poco contraste o sin imágenes? |
| Formularios | ¿Cada campo dice qué pide y qué falló? |
Si los cuatro están bien, cubriste la mayor parte de los problemas reales de un sitio pequeño.
06
La semántica es el significado del HTML
Cada etiqueta le dice al navegador qué es ese contenido, no cómo se ve. Los lectores de pantalla navegan con esa información.
07
Las zonas de una página
| Etiqueta | Zona |
|---|---|
header | Encabezado del sitio |
nav | Navegación |
main | Contenido principal, una sola vez por página |
footer | Pie |
section y article | Bloques de contenido con sentido propio |
Con estas zonas, quien usa un lector de pantalla salta directo al contenido o al menú. Si todo son contenedores genéricos, tiene que escuchar la página entera.
08
Encabezados en orden
- Un solo
h1por página: el título de esa página. - Los
h2son las secciones; losh3, sus partes. - No se saltan niveles para conseguir un tamaño de letra.
09
Una página bien estructurada
<header>
<nav aria-label="Principal">...</nav>
</header>
<main>
<h1>Tratamientos dentales</h1>
<section>
<h2>Ortodoncia</h2>
</section>
</main>
<footer>...</footer>Lee solo las etiquetas, sin el diseño. Si entiendes de qué trata la página y cómo está dividida, la estructura es correcta.
10
Enlace o botón
| Elemento | Para qué | Etiqueta |
|---|---|---|
| Enlace | Lleva a otra página o a otra parte | a con href |
| Botón | Hace algo aquí: abrir, enviar, cerrar | button |
Ambos funcionan con teclado sin trabajo adicional.
11
La prueba de teclado
- Abre tu página y suelta el mouse.
- Presiona
Tabpara avanzar yShift+Tabpara retroceder. - Activa enlaces con
Entery botones conEntero la barra espaciadora. - Abre y cierra el menú móvil. Prueba
Esc. - Llega hasta el final de la página y envía el formulario.
Toma dos minutos y encuentra la mayoría de los problemas graves.
12
Qué debe pasar durante la prueba
- Siempre ves dónde estás: el elemento activo tiene un borde o resalte visible.
- El orden sigue el de lectura, sin saltos raros.
- Ningún elemento te deja atrapado.
- Nada importante queda fuera de alcance.
13
Saltar al contenido
Quien usa teclado tiene que pasar por todo el menú en cada página antes de llegar al contenido. La solución es un enlace al inicio del documento, «Saltar al contenido», que lleva directo al main.
Suele estar oculto y aparece al recibir el foco.
14
Texto alternativo según la imagen
| Imagen | Atributo alt |
|---|---|
| Aporta información | Describe lo que muestra, en una frase |
| Decorativa | Vacío: alt="" |
| Es un enlace o botón | Dice a dónde lleva o qué hace |
| Contiene texto | Repite ese texto |
Un alt vacío no es lo mismo que no ponerlo: vacío le dice al lector de pantalla que la omita. Sin atributo, puede leer el nombre del archivo.
15
Cómo se escribe un buen alt
No empieces con «imagen de»: el lector de pantalla ya lo anuncia. Los textos alternativos los escribes tú o los revisas tú; Claude no sabe qué hay en tus fotos si no se las muestras.
16
Formularios que se entienden
- Cada campo tiene una etiqueta
labelvisible y asociada. - El texto de ejemplo dentro del campo no reemplaza a la etiqueta: desaparece al escribir.
- Los errores se explican con palabras, junto al campo, no solo con un borde rojo.
- Los campos obligatorios se indican con texto.
El formulario completo se construye en el módulo 7. Estas cuatro reglas se piden desde el primer borrador.
17
Contraste y color
WCAG nivel AA pide una relación de contraste mínima entre el texto y su fondo:
| Texto | Mínimo |
|---|---|
| Normal | 4,5 a 1 |
| Grande | 3 a 1 |
Si definiste tu paleta en el módulo 4, ya lo cumples en los tokens. El riesgo aparece en las combinaciones nuevas: texto sobre una foto, gris claro sobre blanco, un botón deshabilitado.
Y el color nunca va solo: un error se marca con color y con texto.
18
Tres detalles que se olvidan
- Idioma:
lang="es"en la etiquetahtml. Sin él, el lector de pantalla puede leer el español con pronunciación de otro idioma. - Zoom: agranda la página al 200 % y comprueba que nada se corta ni se superpone.
- Movimiento: quien pide menos animación en su sistema debe recibir menos. Se trabaja en el módulo 6.
19
Las herramientas automáticas no bastan
Lighthouse, incluido en las herramientas de desarrollo de Chrome, revisa una página y lista fallos concretos de accesibilidad.
Detecta lo mecánico: un alt ausente, un contraste bajo, un campo sin etiqueta. No puede juzgar si el alt describe bien la foto, si el orden del teclado tiene sentido o si un texto se entiende.
20
Qué pedirle a Claude y qué revisar tú
| Claude hace bien | Lo revisas tú |
|---|---|
| Usar etiquetas semánticas | Que el h1 diga lo correcto |
| Asociar etiquetas y campos | Que cada alt describa la foto real |
| Agregar foco visible y enlace de salto | La prueba de teclado completa |
| Auditar el código y listar fallos | Que los textos se entiendan |
Deja en CLAUDE.md las reglas de esta clase, para que valgan en cada sección nueva y no solo cuando te acuerdes.
21
Lo que te llevas
- La semántica le da significado a la página: zonas, encabezados en orden, enlaces y botones reales.
- Todo debe poder hacerse con teclado, con el foco siempre visible.
- El
altdescribe las imágenes informativas y queda vacío en las decorativas. - Contraste AA: 4,5 a 1 en texto normal y 3 a 1 en texto grande.
- Las herramientas automáticas ayudan, pero no reemplazan tu revisión.
22
Hazlo ahora
En 15 minutos, sobre tu página de inicio:
- Haz la prueba de teclado completa y anota cada tropiezo.
- Revisa que haya un solo
h1y que los niveles estén en orden. - Lee el
altde cada imagen y corrige los que no describen. - Ejecuta Lighthouse en la categoría de accesibilidad.
- Entrégale a Claude tus notas y el informe, corrige y haz commit.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026