Container Queries در CSS چیست؟

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;
    }
}

این یکی از مهم‌ترین تغییرات

دیدگاه‌ها

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

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *