Каждый фронтендер хотя бы раз в жизни наступал на грабли с адаптивными фреймами. Представь классическую задачу: тебе нужно встроить на сайт форму оплаты стороннего банка, виджет онлайн-записи или блок комментариев. Ты добавляешь <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 тихо игнорируется, и фрейм сохраняет фиксированную высоту.
Указание звездочки разрешает подгонку высоты любому сайту в сети. Если страница содержит конфиденциальные данные, баланс счета или персонализированный профиль, перечисляйте строго доверенные домены партнеров во избежание утечек через геометрию фрейма.
Динамический 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-мостов, а в остальных браузерах продолжает работать надежный фолбэк.




