Container Queries یکی از قابلیتهای مدرن CSS است که اجازه میدهد یک کامپوننت بر اساس اندازهی والد خودش تغییر کند، نه بر اساس اندازهی کل صفحه (viewport).
قبل از Container Query معمولاً از Media Query استفاده میکردیم:
@media (max-width: 768px) {
.card {
flex-direction: column;
}
}
اینجا CSS میگوید:
اگر صفحه کوچک شد، کارت را عمودی کن.
اما مشکل این است که ممکن است همان کارت در جاهای مختلف استفاده شود:
صفحه اصلی
└── ستون بزرگ
└── Card
Sidebar
└── ستون کوچک
└── Card
در هر دو جا viewport یکی است، ولی فضای واقعی کارت متفاوت است.
Container Query این مشکل را حل میکند:
اگر فضای والد این کامپوننت کوچک شد، خودش را تغییر بده.
مثال ساده
فرض کنیم یک کارت داریم:
<div class="card-container">
<article class="card">
<img src="image.jpg">
<div>
<h2>Title</h2>
<p>Description...</p>
</div>
</article>
</div>
1. تعریف Container
روی والد میگوییم:
.card-container {
container-type: inline-size;
}
یعنی:
اندازه عرض این عنصر را برای Query قابل استفاده کن.
2. نوشتن Container Query
@container (min-width: 500px) {
.card {
display: flex;
}
}
حالا:
- اگر
.card-containerبیشتر از 500px باشد:
+----------------------+
| image | text |
+----------------------+
- اگر کمتر باشد:
+----------------+
| image |
| text |
+----------------+
تفاوت Media Query و Container Query
Media Query
بر اساس صفحه:
Browser Window
|
|
viewport
|
component
مثال:
@media (max-width: 600px) {}
یعنی:
صفحه کوچک شده؟
Container Query
بر اساس والد:
Browser Window
|
Layout
|
Container
|
Component
مثال:
@container (max-width: 600px) {}
یعنی:
فضای من کوچک شده؟
مثال واقعی در طراحی UI
فرض کنید یک Card در Odoo Website دارید:
Desktop:
+--------------------------------+
| Image | Title |
| | Description |
+--------------------------------+
Mobile sidebar:
+------------+
| Image |
| Title |
| Text |
+------------+
با Media Query:
@media(max-width:768px)
ممکن است فقط روی موبایل درست شود.
اما با Container Query:
.card-wrapper {
container-type: inline-size;
}
@container(max-width:400px) {
.card {
display:block;
}
}
هر جایی که Card قرار بگیرد، خودش را تطبیق میدهد.
Container Units
همراه Container Query چند واحد جدید داریم:
cqw
Container Query Width
مثلاً:
font-size: 5cqw;
یعنی:
۵ درصد عرض container
cqh
Container Query Height
height: 50cqh;
یعنی:
۵۰ درصد ارتفاع container
Container Name
میتوانیم اسم بدهیم:
.sidebar {
container-type: inline-size;
container-name: sidebar;
}
بعد:
@container sidebar (min-width: 300px) {
.card {
display:flex;
}
}
این برای پروژههای بزرگ خیلی بهتر است.
نکته مهم: چه چیزی Container نیست؟
این کار اشتباه است:
.card {
container-type:inline-size;
}
@container(max-width:500px) {
.card {
color:red;
}
}
چون یک عنصر نمیتواند خودش را بر اساس خودش Query کند.
باید والد باشد:
container
|
└── component
پشتیبانی مرورگر
امروزه Container Queries در مرورگرهای مدرن پشتیبانی میشود:
- Chrome 105+
- Edge 105+
- Safari 16+
- Firefox 110+
کاربردهای مهم
در طراحی سیستمهای کامپوننتی مثل:
- Design System
- React Components
- Web Components
- Odoo Website Snippets
- UI Kit
خیلی مفید است.
مثلاً در UI Kit شما:
c-cards-001
c-cards-002
c-list
c-pricing
به جای اینکه برای هر breakpoint کلاس بسازید:
@media(max-width:768px)
میتوانید خود کامپوننت را responsive کنید:
.c-card {
container-type:inline-size;
}
@container(max-width:450px) {
.c-card__body {
grid-template-columns:1fr;
}
}
این یکی از مهمترین تغییرات

دیدگاهتان را بنویسید