CSS Container Queries в 2026 году: Создавайте адаптивные компоненты без точек останова viewport
Узнайте, как CSS container queries позволяют адаптивным компонентам подстраиваться под доступное пространство вместо viewport браузера. Создавайте переиспользуемые карточки, используйте именованные контейнеры и контейнерные единицы, и избегайте распространенных проблем с макетом и совместимостью.
CSS-контейнерные запросы в 2026 году: как создавать адаптивные компоненты без точек останова viewport
Адаптивный веб-дизайн traditionally основывается на медиа-запросах. Разработчики выбирают точки останова viewport и адаптируют верстку под телефоны, планшеты и десктопы. Это по-прежнему эффективно для макетов на уровне страницы, но современные компоненты часто используются в различных контекстах: полноширинных секциях, узких боковых панелях, панелях управления, модальных окнах и сетках.
Например, на десктопе шириной 1440 пикселей карточка может иметь внутри боковой панели всего 280 пикселей свободного пространства. Точка останова viewport не может точно описать пространство этого компонента.
CSS-контейнерные запросы позволяют компонентам реагировать на размер подходящего родителя, а не только на viewport. Это делает их особенно полезными в повторяемых системах дизайна, темах блоков WordPress, модулях Joomla и конструкторах страниц.
Что такое CSS-контейнерные запросы?
Запрос размера контейнера оценивает размеры указанного родительского контейнера. Компонент может изменить свой внутренний макет, когда доступное ему пространство пересекает порог.
Например, узкая карточка может отображать изображение над текстом, но при ширине контейнера 480 пикселей и более изображение может быть размещено рядом с текстом.
Медиа-запросы по-прежнему полезны для навигации на уровне страницы и для настройки под устройства. Контейнерные запросы решают другую проблему — адаптивность компонентов на уровне самих компонентов.
Медиа-запросы против контейнерных запросов: визуальное сравнение и демонстрация в режиме реального времени
Иллюстрация сравнивает два подхода. Переместите ползунок, чтобы изменить доступную ширину карточки. Демонстрация использует реальный CSS-запрос размера контейнера, а не переключение макета, управляемое JavaScript.
Media queries vs. container queries
Responds to browser viewport width.
Responds to available component space.
Try the 480px container breakpoint
A reusable card that adapts to the space available.
Read the guideHorizontal layout at 520px
Move the slider to change the container width. The card switches layout at 480px. On narrow screens the maximum width is limited to the available space.
Точка останова относится к дизайну компонента, а не к конкретной категории устройств. В демонстрации на узком экране телефона контейнер ограничивается доступной шириной viewport.
Шаг 1: Создайте семантическую карточку
Начните с карточки, которая может использоваться в списке статей, рекомендациях товаров или индексе документации:
<div class="card-container">
<article class="content-card">
<img class="content-card__image"
src="/images/example.webp"
alt="A laptop on a desk"
width="640" height="400">
<div class="content-card__body">
<h2>Building Better Web Components</h2>
<p>Learn how modern CSS makes layouts more reusable.</p>
<a href="/guide">Read the guide</a>
</div>
</article>
</div>
Внешний элемент станет контейнером запроса. Внутренний элемент <article> — это потомок, чьё представление изменяется.
Это важно: запрос размера контейнера не стилизует сам запрашиваемый элемент. Он оценивает контейнер-предка и стилизует соответствующие потомки.
Шаг 2: Напишите надёжный макет по умолчанию
Начните с макета, который остается работоспособным без контейнерных запросов:
.card-container {
width: 100%;
}
.content-card {
display: grid;
grid-template-columns: minmax(0, 1fr);
gap: 1rem;
padding: 1rem;
border: 1px solid #d9dee5;
border-radius: 12px;
background: #fff;
}
.content-card__image {
display: block;
width: 100%;
height: auto;
aspect-ratio: 8 / 5;
object-fit: cover;
border-radius: 8px;
}
.content-card__body {
min-width: 0;
}
Макет с изображением над текстом по умолчанию работает в узких пространствах. Grid track minmax(0, 1fr) и min-width: 0 снижают риск переполнения длинного контента.
Шаг 3: Объявите контейнер запроса
Используйте свойство container-type:
.card-container {
container-type: inline-size;
}
Значение inline-size позволяет выполнять запросы размера вдоль блоковой оси, что обычно соответствует ширине в горизонтальных режимах письма.
Вы также можете встретить:
.card-container {
container-type: size;
}
Значение size поддерживает обе оси, но вводит более строгие требования к содержаимости. Для большинства адаптивных карточек inline-size является более практичным значением по умолчанию.
Содержимость важна, потому что браузеры должны быть в состоянии рассчитать размер контейнера без циклических зависимостей от стилей потомков.
Шаг 4: Добавьте адаптивное правило
Теперь измените внутренний макет только тогда, когда родительский контейнер достаточно широк:

@container (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
align-items: center;
}
.content-card__image {
height: 100%;
}
}
Широкая боковая панель на десктопе шириной всего 300 пикселей сохраняет сложенный макет. Карточка в столбце контента шириной 600 пикселей становится горизонтальной, даже если viewport не особенно широк.
Это основное преимущество: компонент реагирует на своё собственное доступное пространство.
Шаг 5: Используйте именованные контейнеры для сложных макетов
В панели управления или шаблоне CMS компонент может иметь несколько вложенных контейнеров. По умолчанию запрос размера находит ближайшего подходящего предка.
Укажите желаемый контейнер, когда вам нужно большее управление:
.article-list-item {
container: article-card / inline-size;
}
@container article-card (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
}
}
Сокращение container определяет как имя, так и тип. Называние помогает предотвратить, чтобы не относящийся к делу вложенный контейнер стал целью запроса.
Шаг 6: Используйте относительные к контейнеру единицы измерения
CSS включает единицы длины, основанные на подходящем контейнере запроса:
| Единица | Значение |
|---|---|
cqw |
1% ширины контейнера |
cqh |
1% высоты контейнера |
cqi |
1% блоковой длины контейнера |
cqb |
1% строчной длины контейнера |
cqmin |
Меньшее из cqi и cqb |
cqmax |
Большее из cqi и cqb |
Для плавной типографики компонентов:
.card-container {
container: article-card / inline-size;
}
.content-card h2 {
font-size: clamp(1.1rem, 4cqi, 1.8rem);
}
В отличие от vw, cqi может масштабировать текст вместе с контейнером компонента. Всегда тестируйте читаемость, масштабирование браузера и длинные переведённые заголовки. Если подходящий контейнер не существует, относительные к контейнеру единицы измерения следуют указанному поведению по умолчанию, а не становятся недействительными.
Шаг 7: Добавьте прогрессивное улучшение
Сохраните стандартный сложенный макет и условно включите более продвинутое поведение:
.content-card {
display: grid;
grid-template-columns: 1fr;
}
@supports (container-type: inline-size) {
.card-container {
container-type: inline-size;
}
@container (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
}
}
}
Браузеры без соответствующей функции сохраняют функциональный макет. Резервный вариант не должен совпадать с каждым улучшением; он должен оставаться читаемым и пригодным для использования.
Контейнерные запросы не заменяют Grid или Flexbox
Grid и Flexbox располагают элементы. Контейнерные запросы определяют, когда определённые правила CSS должны применяться.
Например, адаптивный набор карточек может нуждаться только в Grid:
.product-grid {
display: grid;
grid-template-columns:
repeat(auto-fit, minmax(min(100%, 240px), 1fr));
gap: 1.5rem;
}
Добавляйте контейнерные запросы, когда внутренний дизайн каждой карточки должен изменяться в соответствии с её назначенной шириной. Избегайте введения контейнеров запросов там, где стандартный Grid или Flexbox уже решает проблему.
Что насчёт контейнерных стилевых запросов?
Контейнерные запросы также могут тестировать некоторые вычисляемые стилевые условия, включая пользовательские свойства в поддерживаемых браузерах:
.feature-panel {
--panel-theme: dark;
}
@container style(--panel-theme: dark) {
.feature-panel__title {
color: white;
}
}
Это иллюстрирует синтаксис; стилевые запросы и новые возможности запросов имеют разные детали поддержки браузеров. Поддержка запросов размера не гарантирует поддержку каждого стилевого запроса, свойства или новой функции состояния прокрутки. Проверьте точную функцию против текущих таблиц совместимости перед развертыванием в производстве.
Пять распространённых ошибок
1. Запрос размера элемента для стилизации самого элемента

Это не работает так, как задумывалось:
.card {
container-type: inline-size;
}
@container (min-width: 480px) {
.card {
display: grid;
}
}
Запрашиваемый контейнер должен быть родителем стилизуемого элемента. Введите внешний обертывающий элемент или перенесите содержаимость к подходящему родителю.
2. Забывание объявить контейнер
Правило @container само по себе не делает ближайшего родителя автоматически подходящим контейнером размера. Объявите container-type: inline-size или используйте соответствующее сокращение.
3. Беспомощное повторное использование точек останова viewport
Не используйте автоматически 768 пикселей или 1024 пикселя только потому, что эти цифры знакомы. Выберите точку останова там, где контент компонента действительно нуждается в другом расположении.
4. Применение содержаимости повсеместно
Содержимость изменяет поведение размера. Слишком много контейнеров может осложнить отладку, особенно когда элемент зависит от потомков для своих размеров. Создавайте контейнеры намеренно.
5. Предположение, что каждая функция контейнерного запроса поддерживается в равной степени
Запросы размера, стилевые запросы и новые возможности имеют разную историю совместимости. Проверьте точный синтаксис, который вы планируете использовать.
Соображения производительности
Контейнерные запросы работают в CSS/макетном механизме браузера. Они могут устранить некоторые JavaScript-наблюдатели за изменением размера и ручные измерения DOM.
Это архитектурное упрощение полезно, но контейнерные запросы не гарантируют более быстрый сайт. Стоимость рендеринга зависит от таблицы стилей, сложности DOM, структуры макета и выбора содержаимости.
Измеряйте производительность и избегайте ненужных слоёв запросов.
Практические применения в WordPress и Joomla
Темы блоков WordPress: Один и тот же блок может появляться в полноширинной секции, узком столбце или боковой панели. Контейнерные запросы позволяют блоку адаптироваться без отдельных десктопных и мобильных вариантов.
Шаблоны и модули Joomla: Модуль может быть назначен в различные позиции шаблона. Компонентный макет может адаптироваться к фактической ширине модуля, а не угадывать из viewport.
Конструкторы страниц: Редакторы часто перемещают компоненты между вложенными столбцами. Правила на основе контейнеров могут сделать эти компоненты более устойчивыми к изменениям макета.
Панели управления: Панели и виджеты с изменяемым размером могут корректировать свои внутренние макеты по мере изменения доступного пространства.
Когда всё ещё следует использовать медиа-запросы?
Медиа-запросы по-прежнему уместны для навигации, зависящей от viewport, стилей печати, предпочтений снижения движения, возможностей указателя и других характеристик пользователя/устройства.
Полезное правило: медиа-запросы для страницы; контейнерные запросы для компонента. Это не абсолютное правило, но это чёткий способ разделить обязанности.
Как протестировать контейнерные запросы
Протестируйте один и тот же компонент в широкой области контента, узкой боковой панели, сетке и модальном окне. Изменяйте контейнер, а не только окно браузера.
Проверьте горизонтальный переполнение, искажение изображений, длинные заголовки, масштабирование браузера, переведённый контент и режимы письма справа-налево, где это применимо.
Используйте инструменты разработчика браузера, чтобы проверить вычисляемые свойства контейнера и подтвердить, какие правила применяются. Тестируйте на реальных узких устройствах, а также на десктопных симуляторах.
Заключение
CSS-контейнерные запросы устраняют давнее ограничение адаптивного дизайна, основанного на viewport: доступное пространство компонента не обязательно совпадает с шириной браузера.
Сочетая контейнеры размера с Grid, Flexbox и разумными резервными вариантами, разработчики могут создавать повторяемые компоненты, которые естественно адаптируются к темам, модулям, конструкторам страниц и приложениям.
Начните с функционального макета по умолчанию, объявите только значимые контейнеры, выберите точки останова на основе контента и тестируйте в нескольких контекстах.
Адаптивный дизайн больше не сводится только к размеру экрана. Он также касается пространства, доступного каждому компоненту.