# Trampa de teclado (WCAG 2.1.2): qué es y cómo corregirla

Source: https://allyway.ai/es/glossary/trampa-de-teclado

Una trampa de teclado es una parte de la página en la que el foco del teclado puede entrar, pero de la que no puede salir usando solo el teclado. El criterio WCAG 2.1.2 Sin trampas para el foco del teclado la prohíbe en el nivel A.

Una trampa de teclado es un punto de la página en el que el foco del teclado se queda atascado: los usuarios pueden entrar con Tab en un elemento (un [reproductor de vídeo](https://allyway.ai/es/glossary/reproductor-de-video-accesible) incrustado, un mapa, un widget de chat, un cuadro de diálogo defectuoso), pero ninguna tecla les permite volver a salir. Para quien no puede usar el ratón, el resto de la página deja de estar al alcance y, con frecuencia, la única salida es cerrar la pestaña.

## Qué significa

El criterio [WCAG 2.1.2 Sin trampas para el foco del teclado](https://www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html) es de nivel A y forma parte de las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2). Exige lo siguiente: si el foco puede moverse a un componente con el teclado, también debe poder moverse fuera de él usando solo el teclado. Si salir requiere algo más que las flechas o la tecla Tab sin modificar, u otros métodos de salida estándar, hay que informar a los usuarios de cómo hacerlo. A través de la [norma EN 301 549](https://allyway.ai/es/regulations/en-301-549) (cláusula 9.2.1.2), este criterio también se aplica en el marco de la [Ley Europea de Accesibilidad](https://allyway.ai/es/regulations/eaa).

Este criterio tiene un estatus especial. Como una trampa puede dejar toda la página inutilizable, las WCAG lo incluyen entre los requisitos que debe cumplir *todo* el contenido de una página, incluso los widgets de terceros que usted no utiliza para cumplir ningún otro criterio.

No toda restricción del foco es una trampa. El W3C permite expresamente mantener el foco dentro de un [cuadro de diálogo modal](https://allyway.ai/es/glossary/dialogo-modal-accesible), siempre que los usuarios puedan cerrarlo:

| Situación | Veredicto |
|---|---|
| **Cuadro de diálogo modal**: Tab circula por su interior; Esc o «Cerrar» lo cierra | Permitido |
| **Editor de texto enriquecido**: Tab inserta una sangría y un aviso en pantalla indica la tecla de salida | Permitido (se informa a los usuarios) |
| **Reproductor incrustado**: Tab y Esc no hacen nada y no hay ningún aviso | **Trampa de teclado**: no cumple el criterio 2.1.2 |
| **Widget personalizado** que intercepta todas las teclas | **Trampa de teclado**: no cumple el criterio 2.1.2 |

> **Note:** > **Trampa de foco intencionada o trampa de teclado**
> Los desarrolladores hablan de «focus trap» (trampa de foco) para el patrón deliberado de los cuadros de diálogo modales. Solo se convierte en una trampa de teclado en el sentido de las WCAG cuando no existe ninguna forma de salir con el teclado.

## Ejemplos

```html title="Ejemplo"
<!-- Keyboard trap: Tab is caught and Esc is ignored -->
<div class="widget" tabindex="0" onkeydown="event.preventDefault()">…</div>

<!-- Accessible modal: focus stays inside, Esc and the button close it -->
<dialog id="newsletter" aria-labelledby="nl-title">
  <h2 id="nl-title">Get our newsletter</h2>
  <label for="nl-mail">Email</label>
  <input id="nl-mail" type="email">
  <button type="button" onclick="this.closest('dialog').close()">Close</button>
</dialog>
<script>document.getElementById('newsletter').showModal();</script>
```

Un `<dialog>` nativo abierto con `showModal()` se cierra por defecto con Esc. Tras cerrarlo, devuelva el foco al botón que abrió el cuadro de diálogo, para que los usuarios continúen donde lo dejaron.

**Do:** Qué hacer

Permita cerrar con Esc los cuadros de diálogo y los menús, devuelva el foco al activador tras cerrarlos, dé a los reproductores y mapas incrustados una salida clara con el teclado y explique en pantalla cualquier tecla de salida no estándar.

**Don't:** Qué evitar

Llamar a `preventDefault()` en cada evento keydown, incrustar widgets de terceros sin probarlos con el teclado, o abrir un cuadro modal sin botón de cierre.

Una trampa suele aparecer durante una prueba general de [navegación por teclado](https://allyway.ai/es/glossary/navegacion-por-teclado). Pruebe con un indicador de foco visible: sin [foco visible](https://allyway.ai/es/glossary/foco-visible), es difícil saber si el foco está atascado o simplemente es invisible.

## Cómo detectar una trampa de teclado



## Preguntas frecuentes

Q: ¿Qué es una trampa de teclado?
A: Una parte de la página en la que el foco del teclado puede entrar, pero de la que no puede salir con el teclado. El criterio WCAG 2.1.2 Sin trampas para el foco del teclado (nivel A) la prohíbe.

Q: ¿Una trampa de foco en un cuadro de diálogo modal incumple las WCAG?
A: No. Mantener el foco dentro de un cuadro modal abierto es lo esperado, siempre que los usuarios puedan cerrarlo con el teclado, por ejemplo con Esc o con un botón Cerrar.

Q: ¿Qué teclas cuentan como métodos de salida estándar?
A: Las WCAG mencionan las teclas Tab y de flecha sin modificar. Esc es una salida estándar habitual en los teclados físicos. Si su widget necesita otra tecla, como Alt+F10, informe a los usuarios en pantalla.

Q: ¿Los contenidos incrustados de terceros también cuentan para el criterio WCAG 2.1.2?
A: Sí. Una trampa de teclado en cualquier punto de la página bloquea toda la página, por eso las WCAG exigen que todo el contenido cumpla el criterio 2.1.2, incluidos los reproductores, los mapas y los widgets de chat incrustados.

Q: ¿Cómo detecto una trampa de teclado en mi sitio web?
A: Recorra con Tab cada plantilla de página y cada widget, sin ratón. Para detectar además problemas relacionados en todo su sitio, como controles sin rol o sin nombre, utilice también el [comprobador WCAG gratuito](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites).
