Адаптивные iframe без костылей: CSS-свойство frame-sizing в ChromiumСтатья · дайджест за 7 ноября
Инженерный натюрморт с браузерным окном и наглядным двусторонним замком между родительской страницей и адаптивным iframe со свойством frame-sizing.
Статья4 раздела≈ 6 мин

Адаптивные iframe без костылей: CSS-свойство frame-sizing в Chromium

Каждый фронтендер хотя бы раз в жизни наступал на грабли с адаптивными фреймами. Представь классическую задачу: тебе нужно встроить на сайт форму оплаты стороннего банка, виджет онлайн-записи или блок комментариев. Ты добавляешь <iframe>, задаешь ему width: 100%, и тут начинается кошмар. Если форма длинная, внутри страницы вырастает мерзкий внутренний скроллбар. На смартфонах это превращается в сущий ад: пользователь свайпает пальцем экран, попадает в область фрейма и намертво застревает во внутренней прокрутке.

Если же попытаться задать высоту с запасом — скажем, 800 пикселей, — то на коротких шагах формы (например, успешной оплате) под контентом образуется гигантская пустая дыра. Десять лет индустрия героически городила костыли на базе iframe-resizer, связок ResizeObserver и постоянной пересылки сообщений через postMessage. И вот в Chromium (начиная с версий Chrome 154 и Edge 154) наконец появилась нативная реализация спецификации CSS Frame Sizing, о которой в своем блоге подробно рассказал разработчик Ахмад Альфи.

Давай разберем эту механику по винтикам: как устроен нативный расчет высоты, почему браузер категорически запрещает делать это в одностороннем порядке и как безопасно внедрить новинку на продакшене.

Анатомия scroll trap: почему песочница iframe ломала верстку

Чтобы понять ценность нового решения, нужно вспомнить, почему вообще возникла эта проблема. Тег <iframe> появился еще в спецификации HTML 4.0 в конце девяностых. Его главная и неоспоримая суперсила — изоляция контекста выполнения по правилу одного источника (Same-Origin Policy). Код внутри дочернего документа не имеет доступа к DOM-дереву родительской страницы, кукам и сессиям, а родитель не может заглянуть внутрь фрейма.

Но эта же изоляция создавала глухую стену для CSS-движка. Браузер вычисляет геометрию элементов на этапе Layout. Чтобы родительский контейнер узнал, сколько места займет дочерний документ, ему нужно рассчитать высоту его корневого элемента. Но если дочерний документ загружен с другого домена (cross-origin), браузер исторически не позволял передавать эти размеры наружу.

В результате движок выставлял фрейму фиксированные дефолтные размеры — исторические 300 на 150 пикселей. Разработчикам приходилось выкручиваться:

  • Дочерняя страница вешала слушатель мутаций или ResizeObserver на свой document.body.
  • При каждом изменении высоты скрипт слал через postMessage текущий scrollHeight.
  • Родительский скрипт принимал событие, проверял домен и вручную менял инлайн-стиль iframe.style.height.

Такая схема ломалась при малейшем чихе: асинхронная подгрузка шрифтов или анимации аккордеонов приводили к рассинхронизации. Более того, постоянные ручные изменения инлайн-стилей вызывали layout thrashing — тяжелые перерисовки всей страницы прямо посреди пользовательского ввода.

Двусторонний контракт: свойство frame-sizing и метатег безопасности

Ключевой элемент спецификации — свойство frame-sizing: content-height (также поддерживаются значения content-width, content-inline-size и content-block-size). На стороне родительского сайта магия выглядит предельно лаконично:

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

Ты сейчас наверняка думаешь: «Неужели теперь можно взять любой чужой сайт, встроить во фрейм и он сам растянется?» Нет, и слава богу. Если бы браузер позволял родительской странице измерять любой произвольный фрейм, возникла бы чудовищная дыра в безопасности.

Представь атаку по размерам (cross-site leak): злоумышленник встраивает в скрытый фрейм страницу личного кабинета популярного банка. Страница авторизованного пользователя имеет высоту 1200 пикселей, а страница с ошибкой «Войдите в систему» — всего 400 пикселей. Измерив высоту фрейма, атакующий сайт моментально узнает, залогинен ли ты в сервисе.

Поэтому авторы спецификации заложили жесткий двусторонний контракт (two-way opt-in). Чтобы родитель мог регулировать размер фрейма, встроенная страница обязана явно дать на это согласие через специальный метатег в своей секции <head>:

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

Движок браузера проверяет этот метатег строго при первоначальном разборе HTML. Динамически добавить его через JavaScript не получится: Chromium намеренно блокирует позднюю инъекцию, чтобы исключить гонки состояний. Если метатег отсутствует или домен родителя не входит в список allow-origins, свойство frame-sizing тихо игнорируется, и фрейм сохраняет фиксированную высоту.

Никогда не используйте allow-origins=* для закрытых интерфейсов

Указание звездочки разрешает подгонку высоты любому сайту в сети. Если страница содержит конфиденциальные данные, баланс счета или персонализированный профиль, перечисляйте строго доверенные домены партнеров во избежание утечек через геометрию фрейма.

Динамический DOM и метод window.requestResize()

Если страница внутри фрейма статична — например, юридическая оферта, — браузер выполняет замер один раз сразу после завершения первоначального рендеринга. Но в реальных приложениях контент постоянно мутирует: выпадает список отделений доставки, раскрывается аккордеон или появляется плашка с ошибкой валидации.

Для этого в спецификации предусмотрен нативный браузерный API: метод window.requestResize().

Когда внутри встроенного документа происходит изменение габаритов, скрипт вызывает этот метод без аргументов:

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

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

Браузер планирует пересчет высоты в следующем кадре пайплайна рендеринга (в фазе Layout), синхронизируя размеры контейнера с композитором без визуальных рывков и дерганий текста.

Прогрессивное улучшение, защита от CLS и гибридный фолбэк

На конец 2026 года свойство frame-sizing работает в движке Blink (Google Chrome, Microsoft Edge, Opera). Команды WebKit (Safari) и Gecko (Firefox) участвуют в обсуждении рабочей группы W3C, но в их стабильных релизах нативная поддержка пока не открыта.

Это значит, что на продакшене мы обязаны использовать паттерн прогрессивного улучшения. Мы уже разбирали важность плавного перехода в материале о нативной подгонке высоты iframe, и здесь подход строится на CSS-директиве @supports.

Второй критический нюанс — предотвращение скачков макета (Cumulative Layout Shift, CLS). Чтобы страница не дергалась вниз при подгрузке фрейма, мы всегда задаем разумный min-height и ограничиваем верхний потолок через max-height:

/* Базовые стили: резервируем место и задаем фолбэк для Firefox и Safari */
.embedded-checkout-frame {
  width: 100%;
  height: 480px;
  min-height: 280px;
  border: none;
  overflow: hidden;
  transition: height 0.15s ease-out;
}

/* Прогрессивное улучшение для браузеров с поддержкой CSS Frame Sizing */
@supports (frame-sizing: content-height) {
  .embedded-checkout-frame {
    height: auto;
    max-height: 85vh;
    frame-sizing: content-height;
  }
}

А в JavaScript родительской страницы мы слушаем postMessage исключительно тогда, когда нативное свойство не поддерживается:

// Инициализируем слушатель только в браузерах без нативного frame-sizing
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`;
    }
  });
}

Такая связка дает лучшее из двух миров: пользователи Chromium получают идеальный, сверхплавный рендеринг без оверхеда JS-мостов, а в остальных браузерах продолжает работать надежный фолбэк.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 3