Что такое «Контейнерный запрос»

Долгое время подстраивать вёрстку можно было только под ширину экрана. Это неудобно для переиспользуемых блоков: одна и та же карточка товара стоит то в широкой сетке каталога, то в узкой боковой колонке, а экран в обоих случаях один и тот же. Приходилось писать отдельные классы-модификаторы под каждое место. Контейнерные запросы позволили компоненту смотреть на доступное ему пространство и перестраиваться самому.

Возможность появилась в основных браузерах в 2022–2023 годах. Для старых версий нужен резервный вариант — например, базовая одноколоночная раскладка, которая выглядит прилично и без запроса.

Как это записывается

Сначала родителя объявляют контейнером, затем внутри пишут условие:

.product-slot {
  container-type: inline-size;
  container-name: product;
}
.product-card { display: grid; gap: 12px; }

@container product (min-width: 420px) {
  .product-card { grid-template-columns: 160px 1fr; }
}

В узком слоте картинка стоит над текстом, в широком — слева от него. Внутри контейнера доступны свои единицы измерения: cqw равна одному проценту ширины контейнера, а cqi — его размера вдоль строки (в горизонтальном тексте это та же ширина), их удобно использовать для размера шрифта заголовка карточки.

Чем отличается от медиазапроса

Медиазапрос отвечает на вопрос о среде: какой ширины окно, есть ли у устройства мышь, включена ли тёмная тема. Контейнерный запрос — на вопрос о месте: сколько пространства выделено этому блоку. На практике они дополняют друг друга. Общую сетку страницы по-прежнему перестраивают медиазапросами, а внутреннее устройство компонентов — контейнерными.

На что наткнуться при внедрении

  • Элемент не может запрашивать сам себя. Условие проверяется по ближайшему предку-контейнеру, поэтому нужна обёртка.
  • container-type: inline-size включает изоляцию по ширине: размер контейнера больше не вычисляется из содержимого. Если у обёртки нет явной ширины и она стоит, например, во флекс-ряду без растяжения, она может сжаться почти до нуля.
  • Без container-name запрос сработает по ближайшему контейнеру любого имени. Во вложенных компонентах это даёт неожиданные результаты, поэтому имена лучше задавать явно.

Удачные кандидаты для внедрения — карточки, виджеты в сайдбаре, блоки, которые редактор сайта может ставить в колонки разной ширины.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «Frontend» ↗