Iframes adaptativos sin chapuzas: la propiedad CSS frame-sizing en ChromiumArtículo · digest del 7 de noviembre
Bodegón de ingeniería con una ventana de navegador y un candado bidireccional visual entre la página padre y un iframe adaptativo con la propiedad frame-sizing.
Artículo4 secciones≈ 8 min

Iframes adaptativos sin chapuzas: la propiedad CSS frame-sizing en Chromium

Todo desarrollador frontend ha tropezado al menos una vez con los marcos adaptativos. Imagina una tarea clásica: necesitas incrustar en tu sitio el formulario de pago de un banco externo, un widget de reserva online o un bloque de comentarios. Añades un <iframe>, le asignas width: 100%, y ahí empieza la pesadilla. Si el formulario es largo, dentro de la página aparece una horrible barra de desplazamiento interna. En los smartphones esto se convierte en un infierno: el usuario desliza el dedo por la pantalla, cae dentro del área del marco y queda atrapado en el scroll interno.

Si intentas fijar la altura con margen —digamos, 800 píxeles—, en los pasos cortos del formulario (por ejemplo, el pago completado) queda un hueco vacío gigante debajo del contenido. Durante diez años la industria ha levantado chapuzas heroicas basadas en iframe-resizer, combinaciones de ResizeObserver y el envío constante de mensajes mediante postMessage. Y por fin en Chromium (a partir de las versiones Chrome 154 y Edge 154) ha llegado la implementación nativa de la especificación CSS Frame Sizing, sobre la que el desarrollador Ahmad Alfy escribió en detalle en su blog.

Desmontemos esta mecánica pieza por pieza: cómo funciona el cálculo nativo de la altura, por qué el navegador prohíbe terminantemente hacerlo de forma unilateral y cómo desplegar la novedad de manera segura en producción.

Anatomía de la scroll trap: por qué el sandbox del iframe rompía la maquetación

Para entender el valor de la nueva solución, hay que recordar por qué surgió este problema. La etiqueta <iframe> apareció ya en la especificación HTML 4.0 a finales de los noventa. Su superpoder principal e indiscutible es el aislamiento del contexto de ejecución según la política del mismo origen (Same-Origin Policy). El código dentro del documento hijo no tiene acceso al árbol DOM de la página padre, ni a las cookies ni a las sesiones, y el padre no puede mirar dentro del marco.

Pero ese mismo aislamiento levantaba un muro ciego para el motor CSS. El navegador calcula la geometría de los elementos en la fase de Layout. Para que el contenedor padre sepa cuánto espacio ocupará el documento hijo, necesita calcular la altura de su elemento raíz. Pero si el documento hijo se carga desde otro dominio (cross-origin), históricamente el navegador no permitía transmitir esas dimensiones hacia fuera.

Como resultado, el motor asignaba al marco unas dimensiones fijas por defecto: los históricos 300 por 150 píxeles. Los desarrolladores tenían que ingeniárselas:

  • La página hija colgaba un observador de mutaciones o un ResizeObserver en su document.body.
  • En cada cambio de altura, el script enviaba mediante postMessage el scrollHeight actual.
  • El script padre recibía el evento, comprobaba el dominio y cambiaba manualmente el estilo en línea iframe.style.height.

Ese esquema se rompía al menor estornudo: la carga asíncrona de fuentes o las animaciones de acordeones provocaban desincronizaciones. Es más, los cambios manuales continuos de estilos en línea causaban layout thrashing: pesados repintados de toda la página justo en medio de la interacción del usuario.

Contrato bidireccional: la propiedad frame-sizing y la metaetiqueta de seguridad

El elemento clave de la especificación es la propiedad frame-sizing: content-height (también se admiten los valores content-width, content-inline-size y content-block-size). Del lado del sitio padre, la magia resulta sumamente concisa:

iframe.responsive-widget {
  width: 100%;
  height: auto;
  frame-sizing: content-height;
}

Seguro que ahora mismo piensas: «¿De verdad ya se puede coger cualquier sitio ajeno, incrustarlo en un marco y se estirará solo?» No, y menos mal. Si el navegador permitiera a la página padre medir cualquier marco arbitrario, se abriría una brecha de seguridad descomunal.

Imagina un ataque por dimensiones (cross-site leak): un atacante incrusta en un marco oculto la página del área personal de un banco popular. La página de un usuario autenticado tiene una altura de 1,200 píxeles, mientras que la página con el error «Inicie sesión» mide solo 400 píxeles. Al medir la altura del marco, el sitio atacante sabría al instante si tienes la sesión iniciada en el servicio.

Por eso los autores de la especificación establecieron un estricto contrato bidireccional (two-way opt-in). Para que el padre pueda ajustar el tamaño del marco, la página incrustada debe dar su consentimiento explícito mediante una metaetiqueta especial en su sección <head>:

<meta name="responsive-embedded-sizing" content="allow-origins=https://shop.example.com https://checkout.example.com">

El motor del navegador comprueba esta metaetiqueta estrictamente durante el análisis inicial del HTML. No es posible añadirla dinámicamente con JavaScript: Chromium bloquea deliberadamente la inyección tardía para evitar condiciones de carrera. Si falta la metaetiqueta o el dominio del padre no figura en la lista allow-origins, la propiedad frame-sizing se ignora en silencio y el marco conserva una altura fija.

Nunca uses allow-origins=* en interfaces privadas

Indicar un asterisco autoriza el ajuste de altura a cualquier sitio de la red. Si la página contiene datos confidenciales, saldo de cuenta o un perfil personalizado, enumera estrictamente los dominios de socios de confianza para evitar fugas a través de la geometría del marco.

DOM dinámico y el método window.requestResize()

Si la página dentro del marco es estática —por ejemplo, un aviso legal—, el navegador realiza la medición una sola vez justo después de completar el renderizado inicial. Pero en las aplicaciones reales el contenido muta constantemente: se despliega una lista de puntos de entrega, se abre un acordeón o aparece un aviso de error de validación.

Para ello, la especificación prevé una API nativa del navegador: el método window.requestResize().

Cuando dentro del documento incrustado cambia el tamaño, el script llama a este método sin argumentos:

<script>
  function handleFormValidation(hasError) {
    const errorBox = document.getElementById('validation-error');
    errorBox.hidden = !hasError;

    if (typeof window.requestResize === 'function') {
      window.requestResize();
    } else {
      sendLegacyResizeMessage();
    }
  }
</script>

El navegador programa el recálculo de la altura en el siguiente fotograma del pipeline de renderizado (en la fase de Layout), sincronizando las dimensiones del contenedor con el compositor sin saltos visuales ni tirones de texto.

Mejora progresiva, protección contra CLS y respaldo híbrido

A finales de 2026 la propiedad frame-sizing funciona en el motor Blink (Google Chrome, Microsoft Edge, Opera). Los equipos de WebKit (Safari) y Gecko (Firefox) participan en los debates del grupo de trabajo del W3C, pero en sus versiones estables el soporte nativo aún no está habilitado.

Esto significa que en producción estamos obligados a usar el patrón de mejora progresiva. Ya analizamos la importancia de una transición fluida en el artículo sobre el ajuste nativo de altura de iframe, y aquí el enfoque se apoya en la directiva CSS @supports.

El segundo matiz crítico es evitar los saltos de diseño (Cumulative Layout Shift, CLS). Para que la página no dé tirones hacia abajo al cargar el marco, siempre definimos un min-height razonable y limitamos el techo superior mediante max-height:

/* Estilos base: reservamos espacio y definimos el respaldo para Firefox y Safari */
.embedded-checkout-frame {
  width: 100%;
  height: 480px;
  min-height: 280px;
  border: none;
  overflow: hidden;
  transition: height 0.15s ease-out;
}

/* Mejora progresiva para navegadores con soporte de CSS Frame Sizing */
@supports (frame-sizing: content-height) {
  .embedded-checkout-frame {
    height: auto;
    max-height: 85vh;
    frame-sizing: content-height;
  }
}

Y en el JavaScript de la página padre escuchamos postMessage únicamente cuando la propiedad nativa no está soportada:

// Inicializamos el listener solo en navegadores sin frame-sizing nativo
if (!CSS.supports('frame-sizing', 'content-height')) {
  window.addEventListener('message', (event) => {
    if (event.origin !== 'https://payments.example.com') return;
    if (event.data?.type !== 'widget-resize') return;

    const frame = document.querySelector('.embedded-checkout-frame');
    if (frame && typeof event.data.height === 'number') {
      frame.style.height = `${Math.min(event.data.height, window.innerHeight * 0.85)}px`;
    }
  });
}

Esta combinación ofrece lo mejor de ambos mundos: los usuarios de Chromium obtienen un renderizado perfecto y ultrafluido sin la sobrecarga de los puentes JS, mientras que en el resto de navegadores sigue funcionando un respaldo fiable.

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