Skip to content

feat(a11y): teclado, aria-live, foco y contraste AA - #33

Merged
PabloCastroCastro merged 2 commits into
developfrom
feature/GH-4
Nov 4, 2026
Merged

PabloCastroCastro merged 2 commits into
developfrom
feature/GH-4

Conversation

@PabloCastroCastro

@PabloCastroCastro PabloCastroCastro commented Nov 4, 2026 •

Copy link
Copy Markdown
Owner

Qué cambia y por qué

Hasta ahora el swipe solo funcionaba con puntero o táctil, varios textos no llegaban a contraste AA y los lectores de pantalla no podían seguir la partida: al re-renderizar, el foco se perdía en <body> y muchos elementos solo se identificaban por su emoji.

Teclado

  • ← / → votan no / sí. Se ignoran el auto-repeat (mantener pulsada la tecla no vota varias cartas) y las combinaciones con modificadores.
  • Cada pantalla enfoca su control principal (data-autofocus): "Estoy listo/a", la carta, "Continuar" o "Jugar otra ronda". Así la partida entera se juega con Enter y flechas.
  • El foco se conserva al re-renderizar. Si − se deshabilita al llegar al mínimo, el foco pasa a +. Al abrir la app no se roba el foco.

Lectores de pantalla

  • Región aria-live que anuncia el turno ("Ronda 2 · Ingredientes de Pizza. Turno de Ana."), el resumen de cada ronda y el resultado ("¡Esta es vuestra cena! Margarita."). El stepper anuncia "4 jugadores".
  • Cartas con role="group" y un aria-label con nombre, ingredientes y posición ("Clásica: Pan brioche, Carne… Carta 1 de 6").
  • aria-label en ✕/♥ y −/+, en los inputs de nombre y en los botones ✎/✕ del admin.
  • Barra de progreso con role="progressbar".
  • Estructura semántica: h1/h2, listas, <main> y <aside> para el banner. El error lleva role="alert".

Sin depender de emojis

  • Los emojis son decorativos (helper emo() → aria-hidden) y el nombre va siempre en texto.
  • Antes solo había emojis en "También coincidisteis en", en el resultado sin acuerdo y en la lista de recetas del admin. Ahora salen los nombres.

Contraste (WCAG AA), medido con la fórmula de WCAG, mezclando las transparencias sobre el fondo real:

Elemento Antes Después
Texto de botones rellenos (.cta, chips seleccionados, pestaña activa) 3,86 sobre #E1472B 4,83 sobre #C93A1F
Textos secundarios (hint, row-label, player-tag, section-title…) 2,92–4,00 ≥ 6,0 (opacidad ≥ 0,62)
Texto de error 4,16 5,06 (#EE5C3F)

El título y los acentos se quedan en #E1472B: el título es texto grande, así que le basta 3:1, y lo cumple.

Otros

  • Anillo :focus-visible común en mostaza (7,4:1).
  • prefers-reduced-motion.
  • Admin: los chips de ingredientes de las recetas eran <span> y no se podían usar con teclado. Ahora son <button aria-pressed>.

Las convenciones quedan documentadas en CONTRIBUTING.md → "Accesibilidad".

Rama base

develop

Issue relacionada

Closes #4

Pruebas

  • node --test: 51/51.
  • E2E en Chrome headless (móvil 400×860), partida completa solo con teclado (Tab/Enter/flechas, 2 jugadores, 3 rondas):
    • ✅ foco correcto en cada pantalla y en cada carta, y vuelta al setup con el foco en "Empezar"
    • ✅ textos de aria-live verificados en turno, resumen 1, resumen 2 y resultado, sin emojis y sin puntuación doble
    • ✅ el auto-repeat no vota; el stepper conserva el foco y lo pasa a + en el mínimo
    • ✅ admin: un chip se conmuta con Espacio y actualiza aria-pressed
    • ✅ axe-core 4.10 sin violaciones (WCAG 2.0/2.1 A+AA + best-practice) en: setup, handoff, swipe (rondas 1-2 y 3), resumen 1, resumen 2, resultado y las 5 vistas del admin
    • ✅ sin excepciones JS
  • Capturas antes/después: el aspecto no cambia salvo el rojo de los botones (algo más oscuro) y la separación entre emoji y texto en chips y botones.

Fuera de alcance (detectado de paso, ya en el backlog)

Este PR incluye además el commit que añade #34 y #35 a backlog/issues.json.

Checklist

  • Probado en local
  • node --test pasa (y la CI está en verde)
  • No toqué js/shared.js
  • Documentación actualizada

🤖 Generated with Claude Code

PabloCastroCastro and others added 2 commits November 4, 2026 16:56
Juego (js/app.js, index.html):
- Flechas ← → para votar no/sí (ignorando auto-repeat y modificadores).
- Foco gestionado: cada pantalla/carta enfoca su control principal
  (data-autofocus) y el foco se conserva al re-renderizar (stepper); no se
  roba el foco al abrir la app.
- Región aria-live que anuncia turno, resumen de ronda y resultado
  (data-announce, sin leer los emojis); nº de jugadores al usar el stepper.
- Cartas con tabindex, role=group y aria-label (nombre, ingredientes y
  posición); botones ✕/♥ y −/+ con aria-label; inputs de nombre con
  aria-label; progressbar; h1/h2, listas y <main> semánticos; error con
  role=alert; banner de instalación como <aside>.
- Emojis decorativos (aria-hidden) y nombre siempre en texto, también en
  "También coincidisteis en" y en el resultado sin acuerdo.

Admin (js/admin.js, admin.html): inputs con label/aria-label, botones de
icono con aria-label, chips de ingredientes como <button aria-pressed>,
recetas listadas por nombre de ingrediente, pestañas con aria-pressed.

CSS: contraste WCAG AA (botones rellenos #C93A1F, texto secundario
≥ 0.62, error #EE5C3F), anillo :focus-visible común, .sr-only y
prefers-reduced-motion.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- #34 El banner de instalación tapa el último botón en pantallas largas
- #35 Admin: el foco se pierde al cambiar de pestaña o guardar

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@PabloCastroCastro
PabloCastroCastro merged commit 52b1ab3 into develop Nov 4, 2026
1 check passed
@PabloCastroCastro
PabloCastroCastro deleted the feature/GH-4 branch November 4, 2026 16:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant