Por qué «salta» un botón al cargar la página y cómo curar el CLS de raízNota · digest del 19 de noviembre
Por qué «salta» un botón al cargar la página y cómo curar el CLS de raíz
Nota3 secciones≈ 5 min

Por qué «salta» un botón al cargar la página y cómo curar el CLS de raíz

Abres un sitio desde el teléfono, vas a pulsar el botón «Comprar» y en el último segundo termina de cargar /desk.jpg justo encima. El diseño se corre hacia abajo y el dedo toca otro enlace. Da muchísima rabia.

En Google miden ese problema con la métrica CLS (Cumulative Layout Shift, desplazamiento acumulado del diseño), parte del trío Core Web Vitals junto a LCP e INP. El CLS no se mide en segundos, sino con un número sin unidades: qué fracción de la pantalla se movió y cuánto recorrió. El rango sano es ≤ 0.1 en al menos el 75% de las visitas, y > 0.25 ya está en zona roja. En la guía actualizada de web.dev, Addy Osmani y Barry Pollard mostraron cómo eliminar estos saltos de forma sistemática.

Cómo reserva espacio el navegador antes de descargar el archivo

Con el auge del diseño adaptable se quitaron width y height de <img>, dejando max-width: 100%; height: auto;. Mientras /desk.jpg se descarga, su altura vale cero; luego el diseño se abre de golpe y empuja el botón hacia abajo.

Los navegadores modernos resolvieron eso hace tiempo: basta con devolver width y height enteros sin px:

<!-- Dimensiones sin px: el navegador calcula la proporción al instante -->
<img
  src="/desk.jpg"
  width="1200"
  height="800"
  alt="Escritorio"
>

Ya al parsear el HTML, el navegador deduce aspect-ratio: auto 1200 / 800 y reserva la altura. La palabra clave auto protege frente a erratas: si las proporciones reales difieren un poco, tras cargar la imagen se aplican las verdaderas. En Chrome y Safari la regla se ve en el inspector, y Firefox la aplica por debajo. Para bloques fluidos dejamos en CSS:

/* En pantallas estrechas la foto se encoge, pero su hueco ya está reservado */
img {
  max-width: 100%;
  height: auto;
}

Si sirves distintas resoluciones con srcset, cuida que todos los archivos compartan la misma proporción. Y si cambias el recorte entre móvil y escritorio (art direction), ahora puedes poner width y height directo en cada <source> dentro de <picture>; funciona en Chrome, Firefox y Safari:

<!-- Distintas proporciones para móvil y escritorio en <source> -->
<picture>
  <source
    media="(max-width: 799px)"
    srcset="desk-480w-cropped.jpg"
    width="480"
    height="400"
  />
  <source
    media="(min-width: 800px)"
    srcset="desk-800w.jpg"
    width="800"
    height="400"
  />
  <img
    src="desk-800w.jpg"
    width="800"
    height="400"
    alt="Escritorio"
  />
</picture>

El navegador conoce de antemano la altura tanto del recorte móvil como de la versión ancha, así que el botón bajo la imagen no se mueve en ninguna pantalla.

Anuncios, widgets, fuentes y la trampa de los 500 milisegundos

¿Ya arreglaste las imágenes y la página sigue dando tirones? Casi siempre la culpa es de anuncios, mapas incrustados, videos en <iframe> o banners. Resérvales el espacio antes con min-height (para el tamaño mínimo o más frecuente del anuncio, usando @media si hace falta) o con aspect-ratio:

/* Espacio publicitario: mantenemos altura y no colapsamos si queda vacío */
.ad-slot {
  min-height: 250px;
}

/* Video o widget incrustado con proporción conocida */
.embed-wrapper {
  width: 100%;
  aspect-ratio: 16 / 9;
}

Aquí hay una trampa común: si no llega ningún anuncio y tu script colapsa el hueco a 0px, el navegador cuenta ese movimiento igual como un salto. Deja un espacio de reserva. Tampoco insertes banners encima del texto sin acción del usuario: muestra un esqueleto o sácalos en una capa flotante.

Otra trampa es la ventana de 500 ms. Los desplazamientos en el medio segundo posterior a un clic o pulsación de tecla no suman al CLS (si la carga tarda más, dibuja un esqueleto dentro de esa ventana). Pero el scroll y el hover no tienen exención: una carga diferida sin altura reservada golpea la métrica al instante. De paso, cambia animaciones de top/left por transform: translate(...), doma las fuentes web con font-display: optional, size-adjust/ascent-override y <link rel="preload">, y no rompas la bfcache, la caché de retorno instantáneo al pulsar «Atrás».

Por qué Lighthouse marca cero mientras CrUX está en rojo

Pasas la página por Lighthouse y sale cero limpio, pero el informe de Google marca alerta roja. No hay misterio: Lighthouse mide solo la carga inicial, mientras que CrUX (Chrome UX Report) recoge datos reales de campo durante todo el ciclo de vida de la página, incluidos scroll y transiciones en SPA.

Compara ambas cifras en PageSpeed Insights (revisa arriba a la derecha que sean datos de esa URL y no de todo el dominio). Si CrUX y Lighthouse coinciden, el fallo está al inicio: graba una recarga en Chrome DevTools → Performance y abre la pista Layout Shifts. Las franjas moradas agrupan clústeres, los rombos marcan saltos (su tamaño refleja el impacto) y un clic reproduce la animación con detalles en Summary e Insights. Recuerda: Lighthouse y web-vitals muestran las víctimas que se desplazaron hacia abajo, pero el culpable se insertó arriba.

Si Lighthouse sale limpio y CrUX protesta, abre Performance → Live Metrics, haz scroll y clic: el contador de CLS atrapará al culpable en vivo (las regresiones se prueban bien en Lighthouse User Flows). Lo único que no ven los scripts RUM de la página son los saltos dentro de <iframe> de otros dominios, aunque CrUX sí los contabiliza.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 2