Navegación con Teclado
Permite a todos los usuarios navegar eficientemente sin ratón
Atajos de teclado
- Tab
- Navegar entre elementos interactivos
- Shift + Tab
- Navegación hacia atrás
- Entrée / Espace
- Activar botones y enlaces
- Échap
- Cerrar modales y menús
- ↑ ↓
- Navegar en listas y menús
Navegación con teclado en listas
❌ Mal ejemplo
Menú solo con navegación Tab:
<!-- Malo: Solo navegación Tab -->
<div class="menu">
<div tabindex="0">🏠 Inicio</div>
<div tabindex="0">📋 Proyectos</div>
<div tabindex="0">👥 Equipo</div>
<div tabindex="0">📊 Estadísticas</div>
<div tabindex="0">⚙️ Configuración</div>
</div>
<!-- El usuario debe presionar Tab 5 veces -->
<!-- Sin navegación de flechas -->
<!-- Sin semántica de menú -->✅ Buen ejemplo
Menú con navegación de flechas:
💡 Usa ↑ ↓ para navegar, Enter para seleccionar
<!-- Bueno: navegación de flechas con roving tabindex -->
<div
role="menu"
@keydown="handleKeydown"
>
<div
v-for="(item, i) in items"
role="menuitem"
:tabindex="selected === i ? 0 : -1"
@focus="selected = i"
:class="{ selected: selected === i }"
>
{{ item }}
</div>
</div>// Navegación de flechas con roving tabindex
function handleKeydown(e) {
switch(e.key) {
case 'ArrowDown':
selected = (selected + 1) % items.length
break
case 'ArrowUp':
selected = selected === 0
? items.length - 1
: selected - 1
break
case 'Enter':
selectItem(selected)
break
}
}Explicación: Las listas navegables con teclado permiten usar las teclas de flecha para moverse entre elementos, además de la navegación clásica con Tab.
Estilos de enfoque visibles
❌ Mal ejemplo
Intenta navegar con Tab en esta área:
/* ❌ Elimina todos los indicadores de enfoque */
*:focus {
outline: none !important;
}
button:focus,
a:focus,
input:focus {
outline: none !important;
}<!-- ❌ Problemas de accesibilidad: -->
<button>Botón 1</button> <!-- Sin tipo, enfoque invisible -->
<button>Botón 2</button> <!-- Sin tipo, enfoque invisible -->
<a href="#">Enlace</a> <!-- Enfoque invisible -->
<input type="text" /> <!-- Enfoque invisible -->
<!-- Navegación con teclado imposible de seguir visualmente -->✅ Buen ejemplo
Intenta navegar con Tab en esta área:
/* ✅ Indicadores de enfoque visibles y accesibles */
button:focus-visible {
outline: 3px solid #4F46E5;
outline-offset: 2px;
}
input:focus-visible {
border-color: #4F46E5;
outline: 2px solid #4F46E5;
outline-offset: 1px;
}<button type="button">Botón 1</button>
<button type="button">Botón 2</button>
<a href="#">Enlace a página</a>
<input type="text" placeholder="Ingresa texto" />Explicación: Los usuarios que navegan con teclado necesitan indicadores visuales claros para saber dónde están en la página.
Enlace de salto (Skip to content)
❌ Mal ejemplo
Contenido principal
El usuario debe navegar por todos los enlaces de navegación...
<!-- Malo: sin enlace de salto -->
<header>
<nav>
<a href="#">Inicio</a>
<a href="#">Productos</a>
<a href="#">Servicios</a>
<!-- 10+ enlaces de navegación... -->
</nav>
</header>
<main>
<!-- El usuario debe atravesar toda la navegación -->
<h1>Contenido principal</h1>
</main>✅ Buen ejemplo
Contenido principal
¡El usuario puede acceder directamente aquí gracias al enlace de salto!
/* Enlace de salto oculto por defecto, visible al enfocar */
.skip-link {
position: absolute;
top: -100px;
left: 1rem;
z-index: 1000;
padding: 0.5rem 1rem;
background: var(--color-primary);
color: white;
text-decoration: none;
border-radius: 0.625rem;
}
.skip-link:focus {
top: 1rem;
}<a href="#main-content" class="skip-link">
Saltar al contenido principal
</a>
<header>
<nav aria-label="Navegación principal">
<ul>
<li><a href="/">Inicio</a></li>
<li><a href="/produits">Productos</a></li>
<li><a href="/services">Servicios</a></li>
</ul>
</nav>
</header>
<main id="main-content">
<h1>Contenido principal</h1>
</main>Explicación: Los enlaces de salto permiten a los usuarios de teclado saltar directamente al contenido principal sin tener que pasar por toda la navegación.
Modal con trampa de enfoque
❌ Mal ejemplo
<!-- Malo: modal sin gestión de enfoque -->
<div v-if="modalOpen" class="modal-overlay" @click="close">
<div class="modal-content" @click.stop>
<div class="modal-header">
<h3>Confirmar acción</h3>
<button @click="close">×</button>
</div>
<div class="modal-body">
<p>¿Estás seguro de que quieres continuar?</p>
<input type="text" placeholder="Razón (opcional)" />
</div>
<div class="modal-footer">
<button @click="close">Cancelar</button>
<button @click="confirm">Confirmar</button>
</div>
</div>
</div>✅ Buen ejemplo
<!-- Bueno: modal con trampa de enfoque -->
<div
v-if="modalOpen"
class="modal-overlay"
@click="closeModal"
@keydown.esc="closeModal"
>
<div
class="modal-content"
role="dialog"
aria-modal="true"
aria-labelledby="modal-title"
@click.stop
>
<header class="modal-header">
<h2 id="modal-title">Confirmar acción</h2>
<button
type="button"
@click="closeModal"
aria-label="Cerrar modal"
class="close-btn"
>×</button>
</header>
<div class="modal-body">
<p>¿Estás seguro de que quieres continuar?</p>
<input
ref="firstInput"
type="text"
placeholder="Razón (opcional)"
@keydown.tab="handleFocusTrap"
/>
</div>
<footer class="modal-footer">
<button
type="button"
@click="closeModal"
@keydown.tab="handleFocusTrap"
>Cancelar</button>
<button
type="button"
ref="lastButton"
@click="confirmAction"
@keydown.tab="handleFocusTrap"
>Confirmar</button>
</footer>
</div>
</div>// Funciones esenciales :
// - Auto enfoque en el primer elemento
// - Trampa de enfoque (Tab/Shift+Tab)
// - Cerrar con Escape
// - Devolver enfoque al elemento activador
function handleFocusTrap(event) {
const focusableElements = modalContent.querySelectorAll(
'button, input, [tabindex]:not([tabindex="-1"])'
)
const firstElement = focusableElements[0]
const lastElement = focusableElements[focusableElements.length - 1]
if (event.shiftKey && document.activeElement === firstElement) {
event.preventDefault()
lastElement.focus()
} else if (!event.shiftKey && document.activeElement === lastElement) {
event.preventDefault()
firstElement.focus()
}
}Explicación: Los modales deben mantener el enfoque dentro y permitir cerrar con la tecla Escape. El enfoque debe volver al elemento que abrió el modal.