Menú móvil premium
Un menú móvil son cuatro cosas conectadas a un solo booleano: un botón que se transforma, un panel que se revela, la página detrás que se mantiene quieta, y el foco contenido en su interior. Casi todos los menús rotos lo están porque esas cuatro cosas se desincronizan — una de ellas se activa en otro lugar, por otra cosa.
Maneja todo desde una única función set(state). Sin classList.toggle() disperso por los manejadores de clic, sin una ruta de "cerrar" separada que olvide el bloqueo de scroll. Una función, todos los atributos, ambas direcciones.
Estructura
El encabezado tiene prioridad sobre el panel, y el panel lo cubre todo lo demás:
.nav { position: fixed; inset: 0 0 auto; z-index: 210 } /* la hamburguesa vive aquí */
.menu { position: fixed; inset: 0 0 auto; z-index: 200; height: 100dvh }
<header class="nav">
<a class="brand" href="/">silva</a>
<button class="burger" id="menuBtn" type="button"
aria-label="Abrir menú" aria-expanded="false" aria-controls="menu">
<i></i><i></i>
</button>
</header>
<div class="menu" id="menu" role="dialog" aria-label="Menú" tabindex="-1" inert>
<nav class="menu__nav">
<a href="#about"><span class="menu__idx">01</span> Acerca de</a>
<a href="#work"><span class="menu__idx">02</span> Trabajo</a>
</nav>
<div class="menu__foot">…</div>
</div>
La hamburguesa permanece en el encabezado y se transforma en su lugar. Es el control de apertura y el control de cierre, por lo que el encabezado debe estar por encima del panel — ver Trampa 1.
El botón
Objetivo de 44×44, barra visible de 22px. Las barras están posicionadas de forma absoluta y centradas con márgenes, no con transformaciones, para que la propiedad transform quede libre para la transformación:
.burger {
position: relative; display: grid; place-items: center;
width: 44px; height: 44px;
background: none; border: 0; padding: 0; cursor: pointer;
color: currentColor;
-webkit-tap-highlight-color: transparent;
}
.burger i {
position: absolute; left: 50%; top: 50%;
margin: -.75px 0 0 -11px; /* el centrado está aquí, no en transform */
width: 22px; height: 1.5px;
background: currentColor; border-radius: 2px;
transition: transform .45s var(--ease);
}
.burger i:first-child { transform: translateY(-4px) }
.burger i:last-child { transform: translateY(4px) }
html.is-menu-open .burger i:first-child { transform: rotate(45deg) }
html.is-menu-open .burger i:last-child { transform: rotate(-45deg) }
Ambas barras comparten un mismo punto central, por lo que rotarlas ±45° produce una X simétrica sin necesidad de un segundo fotograma clave ni nada que ajustar. Si centras con translate(-50%,-50%) en su lugar, cada estado de transformación tiene que re-declarar ese translate y las dos barras se separan un píxel.
Usa dos barras, no tres. La X de tres barras necesita que la del medio se desvanezca mientras las dos exteriores convergen, y el desvanecimiento se ve como una mancha gris a mitad de la transición. Dos barras se transforman limpiamente. Si un estado de reposo de tres barras es innegociable, anima las barras exteriores con translateY + rotate y dale a la del medio una duración de opacity más corta para que desaparezca antes de que comience la rotación.
Nunca animes top/margin para mover las barras. Solo transform.
El panel
.menu {
position: fixed; left: 0; right: 0; top: 0;
height: 100dvh; /* no inset:0 — ver Trampa 2 */
z-index: 200;
display: flex; flex-direction: column; justify-content: space-between;
padding: clamp(96px, 24vw, 150px) var(--gutter)
max(clamp(28px, 7vw, 52px), env(safe-area-inset-bottom));
background: var(--black); color: var(--white);
overflow-y: auto; overscroll-behavior: contain;
opacity: 0; visibility: hidden; transform: translateY(-12px);
transition: opacity .45s var(--ease),
transform .55s var(--ease),
visibility 0s linear .45s; /* ocultar solo después de que termine el desvanecimiento */
}
.menu.is-open {
opacity: 1; visibility: visible; transform: none;
transition-delay: 0s; /* cancelar el retardo de visibilidad en la entrada */
}
visibility es lo que hace que esto sea seguro para el teclado: elimina el panel cerrado del orden de tabulación, algo que opacity: 0 por sí solo no hace. La transición de visibility con retardo es todo el truco: visible inmediatamente al abrir, oculto solo después de que se haya reproducido el desvanecimiento.
La revelación escalonada de enlaces es lo que se percibe como costoso:
.menu__nav a {
opacity: 0; transform: translateY(18px);
transition: opacity .6s var(--ease), transform .6s var(--ease);
}
.menu.is-open .menu__nav a { opacity: 1; transform: none }
.menu.is-open .menu__nav a:nth-child(1) { transition-delay: .10s }
.menu.is-open .menu__nav a:nth-child(2) { transition-delay: .16s }
.menu.is-open .menu__nav a:nth-child(3) { transition-delay: .22s }
.menu.is-open .menu__nav a:nth-child(4) { transition-delay: .28s }
.menu.is-open .menu__nav a:nth-child(5) { transition-delay: .34s }
Separados por 60ms. Por debajo de ~40ms se percibe como un bloque; por encima de ~90ms el último elemento parece llegar tarde. Para una lista de longitud desconocida, pon style="--i:3" en cada elemento y usa transition-delay: calc(.10s + var(--i) * .06s).
A la salida, elimina los retardos (.menu:not(.is-open) .menu__nav a { transition-delay: 0s }). Una salida escalonada hace que el cierre se sienta lento: el cierre debe ser inmediato.
La función de estado
(function () {
var btn = document.getElementById('menuBtn');
var panel = document.getElementById('menu');
var root = document.documentElement;
var open = false;
var scrollY = 0;
var FOCUSABLE = 'a[href], button:not([disabled]), input, select, textarea,' +
'[tabindex]:not([tabindex="-1"])';
// la hamburguesa es el control de cierre y vive fuera del panel, así que pertenece al ciclo
function focusables() {
return [btn].concat([].slice.call(panel.querySelectorAll(FOCUSABLE)));
}
function set(state) {
if (state === open) return;
open = state;
panel.classList.toggle('is-open', open);
root.classList.toggle('is-menu-open', open);
btn.setAttribute('aria-expanded', String(open));
btn.setAttribute('aria-label', open ? 'Cerrar menú' : 'Abrir menú');
if (open) panel.removeAttribute('inert');
else panel.setAttribute('inert', '');
if (open) {
scrollY = window.scrollY;
document.body.style.position = 'fixed';
document.body.style.top = -scrollY + 'px';
document.body.style.left = '0';
document.body.style.right = '0';
panel.focus({ preventScroll: true });
} else {
document.body.style.position = '';
document.body.style.top = '';
document.body.style.left = '';
document.body.style.right = '';
window.scrollTo(0, scrollY);
btn.focus({ preventScroll: true });
}
}
btn.addEventListener('click', function () { set(!open); });
panel.querySelectorAll('a').forEach(function (a) {
a.addEventListener('click', function () { set(false); });
});
document.addEventListener('keydown', function (e) {
if (!open) return;
if (e.key === 'Escape') { set(false); return; }
if (e.key !== 'Tab') return;
var list = focusables();
var first = list[0];
var last = list[list.length - 1];
if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
});
// cruzar el punto de interrupción no debe dejar la página en un estado bloqueado
matchMedia('(min-width: 1101px)').addEventListener('change', function (e) {
if (e.matches) set(false);
});
})();
inert reemplaza a aria-hidden aquí. Nunca pongas aria-hidden="true" en un panel que pueda contener el foco — si el foco está dentro, has ocultado el elemento enfocado del árbol de accesibilidad, lo que es un error de autoría que los lectores de pantalla manejan mal. inert bloquea el foco y oculta del árbol en un solo atributo.
Observa el role="dialog" sin aria-modal="true". aria-modal le dice a la tecnología de asistencia que ignore todo lo que está fuera del diálogo, y el botón de cierre está fuera de él. O bien omite aria-modal (como se muestra arriba) o coloca un botón de cierre real dentro del panel.
Trampa 1: el encabezado debe tener prioridad sobre el panel
La hamburguesa se transforma en la X, por lo que debe permanecer cliqueable mientras el panel está abierto. Si el z-index del panel es mayor que el del encabezado, la X se renderiza (está pintada en el encabezado) pero cada clic cae en la superposición. El menú se convierte en una trampa sin salida visible — reportado como "el botón de cierre no funciona".
Dale al encabezado un z-index mayor que el del panel y verifica ambos contra cualquier otra capa fija en la página (las barras de cookies y los CTA pegajosos son las colisiones habituales). Un conjunto funcional: panel 200, encabezado 210, toasts 9000.
Los elementos fijos solo se apilan entre sí cuando comparten un contexto de apilamiento. Un transform, filter, opacity < 1, o will-change en cualquier ancestro crea uno nuevo y silenciosamente re-padrea toda la comparación.
Trampa 2: overflow: hidden en el body no funciona en iOS
document.body.style.overflow = 'hidden' bloquea los navegadores de escritorio y no hace nada contra un arrastre táctil en iOS Safari. La página rebota detrás del panel y, al soltar, el usuario está en otro lugar por completo.
El bloqueo que funciona es fijar el body y restaurar el desplazamiento, que es lo que hace set() arriba. Dos detalles que lo acompañan:
overscroll-behavior: containen el panel evita que el propio scroll del panel se encadene a la página cuando llega a un extremo.- Restaura con
window.scrollTo(0, scrollY)en la misma llamada que limpiaposition. LeerscrollYdespués de que el body se ha desanclado da 0.
Si tu encabezado es position: sticky en lugar de fixed, este bloqueo lo rompe. Un body fijado no tiene puerto de scroll, por lo que sticky se resuelve contra el documento y el encabezado salta a la parte superior de la página — fuera de la pantalla, llevándose la hamburguesa consigo. Cámbialo a fixed mientras el menú esté abierto (html.is-menu-open .nav { position: fixed; top: 0 }). La habilidad lenis-smooth-scroll cubre el mismo fallo desde el lado de Lenis; si esa biblioteca está en la página, usa lenis.stop() en lugar de un segundo bloqueo en lugar de apilar ambos.
Prueba el bloqueo en un desplazamiento de scroll distinto de cero. En scroll 0, un bloqueo roto es idéntico píxel a píxel a uno que funciona. Desplázate a ~1200, abre, arrastra, cierra: la posición debe ser 1200 en todo momento.
Trampa 3: display: none no se puede transicionar
Alternar display salta la animación por completo: el panel aparece y desaparece de golpe. El patrón de visibility con transición retardada anterior es la versión que funciona en todas partes.
El equivalente moderno, si estás dispuesto a requerir una línea base de 2024+:
.menu { display: none; opacity: 0;
transition: opacity .45s var(--ease), display .45s allow-discrete }
.menu.is-open { display: flex; opacity: 1 }
@starting-style { .menu.is-open { opacity: 0 } }
@starting-style es necesario — sin él la entrada no tiene valor inicial y solo la salida se anima.
Trampa 4: el panel es el lugar equivocado para un desenfoque de fondo
backdrop-filter en un panel a pantalla completa vuelve a muestrear todo lo que hay detrás cada fotograma, y en Android de gama media reduce la animación de entrada a fps de un solo dígito. En una compilación, eliminar una mezcla/desenfoque de viewport completo redujo los fotogramas perdidos del 34% al 3%.
Un menú premium es casi siempre un panel opaco de color de marca, no vidrio esmerilado. Si el diseño requiere vidrio, desenfoca un elemento pequeño (una hoja que cubre parte de la pantalla), nunca el viewport completo, y consulta la habilidad liquid-glass.
Trampa 5: los estados que nadie prueba
- Redimensionar más allá del punto de interrupción mientras está abierto. Manejado arriba con
matchMedia, no un listener deresize, por lo que se dispara una vez al cruzar en lugar de en cada fotograma de un arrastre. - Cambio de ruta del lado del cliente. En navegación Next/Astro/SPA, el panel sobrevive a la navegación. Llama a
set(false)en el evento del enrutador y limpia los estilos del body al desmontar. - Botón de retroceso después de abrir. Si insertas una entrada de historial cuando se abre el menú, el botón de retroceso debe cerrarlo en lugar de salir de la página.
- Zoom al 200%. El panel debe desplazarse en lugar de recortar su pie de página.
- Teléfono en horizontal.
100dvhcon un panel desplazable lo maneja; una lista centrada verticalmente conjustify-content: centerno.
Movimiento reducido
@media (prefers-reduced-motion: reduce) {
.menu, .menu__nav a, .burger i {
transition-duration: .01ms !important;
transition-delay: 0s !important;
}
}
Mantén los cambios de estado, elimina la coreografía. El panel debe seguir apareciendo y desapareciendo.
Qué lo hace percibir como premium
Los mecanismos anteriores son lo básico. Estas son las elecciones que lo diferencian de un cajón de bootstrap:
- Easing.
cubic-bezier(.16, 1, .3, 1)(expo-out) en el panel y los enlaces. Salida rápida, asentamiento largo. Nuncaeaseolinear. - Tiempo. Panel 450–600ms, enlaces 600ms con un escalonado de 60ms, transformación de la hamburguesa 450ms. Por debajo de 300ms nada se registra como movimiento; por encima de 700ms se siente lento.
- Tipografía. La lista de enlaces es el diseño.
clamp(1.65rem, 8.4vw, 2.9rem), peso de visualización 300,line-height: 1, mayúsculas, tracking ajustado. Reglas finas entre filas. - Numeración de índice.
01 / 02 / 03en mono pequeño o mayúsculas con espaciado antes de cada etiqueta, en un tono apagado. Barato de añadir, hace más por la calidad percibida que cualquier efecto. - Áreas táctiles de fila completa. Relleno vertical de
clamp(14px, 3.4vw, 22px)en el propio ancla, no un margen a su alrededor, para que toda la fila sea táctil. - Un estado
:active, no un estado:hover. Los teléfonos no hacen hover, y un estilo hover que persiste después de un toque se ve roto. - Un bloque de pie de página — línea de contacto, redes sociales, un único CTA tipo píldora — fijado con
justify-content: space-between. El espacio vacío inferior es lo que hace que un menú parezca un marcador de posición. - Sin rebote o resorte en el panel mismo. Sobrepasar en una superficie a pantalla completa se percibe como barato. Reserva el easing de resorte para elementos pequeños.
Lista de verificación
- Una única función
set(state)posee la clase,aria-expanded, la etiqueta,inert, y el bloqueo de scroll - El
z-indexdel encabezado está por encima del del panel, verificado contra cualquier otro elemento fijo - El bloqueo de scroll se ha probado en iOS con scroll > 0
-
overscroll-behavior: containen el panel -
inerten el panel cerrado, noaria-hidden -
aria-modalno está presente en el panel del diálogo - El menú se cierra con Escape
- El foco de tabulación se cicla dentro del panel
-
event.preventDefault()se llama en los límites de la lista de elementos enfocables - La hamburguesa está incluida como primer/último elemento enfocable
- No hay
display: noneen el panel -
visibility: hiddense usa con un retardo en la transición de salida - Los enlaces tienen una transición de retardo en la entrada, y sin retardo en la salida
-
@starting-styleo el patrón de visibilidad se usa para animar la entrada - El menú se cierra al cambiar de ruta
- El menú se cierra al redimensionar más allá del punto de interrupción
-
prefers-reduced-motion: reduceestablece duraciones de transición a ~0ms - El botón hamburguesa se centra con márgenes, no con transformaciones
- Dos barras
<i>, no tres -
aria-labelcambia entre "Abrir menú" / "Cerrar menú" -
aria-expandedse actualiza correctamente - No se usan
top,margin, ni desplazamientos de píxeles para animar las barras hamburguesa - Se elimina
inertcuando el panel está abierto