Tutorial

CSS Container Queries: Kartı Kapsayıcısına Göre Tasarlamak

Mehmet Fatih Ünal
10 Kasım 2026
7 dk okuma
#CSS#Container Queries#Responsive Tasarım#Frontend#Bileşen Tasarımı
CSS Container Queries: Kartı Kapsayıcısına Göre Tasarlamak

Container query hangi sorunu çözer?

Container query, bir bileşenin stilini yalnızca ekranın genişliğine göre değil, uygun bir üst kapsayıcının ölçüsüne göre değiştirebilir. MDN container queries rehberi, bu yaklaşımın temelini açıklar.

Aynı ürün kartı ana içerik alanında geniş, yan panelde dar bir yere yerleşebilir. Viewport her ikisi için de aynıdır; kullanılabilir alan aynı değildir. Kartın yatay veya dikey düzen seçimini bulunduğu yere göre yapması, onu farklı sayfalarda yeniden kullanmayı kolaylaştırır.

container-type: inline-size nereye yazılır?

Sorgulanacak kapsayıcıyı kartın dışındaki bir öğede tanımlayın. inline-size, yatay yazı düzeninde genişlik yönündeki boyut için sorgu bağlamı kurar. container-type başvurusu, uygulanan containment davranışını açıklar.

Bu örnekte .card-host kapsayıcıdır; .product-card ise düzeni değişen alt öğedir. Bir kartın kendi ölçüsünü sorgulayarak aynı öğenin ölçüsünü değiştirmeye çalışmak yerine bu iki rolü ayırın.

İki farklı alanda aynı kart nasıl kullanılır?

Aşağıdaki HTML iki aynı kartı ana alan ve yan panel için oluşturur. Renkli bölüm dekoratiftir; gerçek bir ürün görseli kullanılacaksa anlamına uygun alternatif metin ayrıca sağlanmalıdır:

<div class="demo-layout">
  <section class="card-host" aria-label="Ana alan">
    <article class="product-card">
      <div class="card-art" aria-hidden="true"></div>
      <div class="card-copy">
        <h3>Çalışma masası</h3>
        <p>Uzun açıklamalar ve farklı metin boyutlarıyla da denenmesi gereken bir ürün kartı.</p>
        <a href="/products/desk">Ürünü incele</a>
      </div>
    </article>
  </section>
  <aside class="card-host" aria-label="Yan panel">
    <article class="product-card">
      <div class="card-art" aria-hidden="true"></div>
      <div class="card-copy">
        <h3>Çalışma masası</h3>
        <p>Uzun açıklamalar ve farklı metin boyutlarıyla da denenmesi gereken bir ürün kartı.</p>
        <a href="/products/desk">Ürünü incele</a>
      </div>
    </article>
  </aside>
</div>

Önce her kart için kullanılabilir bir tek sütunlu temel düzen kurun. Sonra kapsayıcı yeterince geniş olduğunda kartı iki sütuna geçirin:

.demo-layout {
  display: grid;
  grid-template-columns: minmax(0, 1fr) 18rem;
  gap: 1.5rem;
}
.card-host {
  container-type: inline-size;
  min-width: 0;
}
.product-card {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: 1rem;
  padding: 1rem;
  border: 1px solid #94a3b8;
  border-radius: 0.75rem;
}
.card-art {
  aspect-ratio: 8 / 5;
  border-radius: 0.5rem;
  background: linear-gradient(135deg, #1d4ed8, #7c3aed);
}
.card-copy { min-width: 0; overflow-wrap: anywhere; }
.card-copy h3 { margin-top: 0; }
.card-copy a:focus-visible {
  outline: 3px solid #2563eb;
  outline-offset: 3px;
}
@container (min-width: 32rem) {
  .product-card {
    grid-template-columns: 9rem minmax(0, 1fr);
    align-items: start;
  }
}
@media (max-width: 50rem) {
  .demo-layout { grid-template-columns: minmax(0, 1fr); }
}

Geniş ekranda ana alandaki kapsayıcı 32rem eşiğini aşabilir ve yatay karta dönüşür. 18rem genişliğindeki yan panel aynı viewport içinde dikey kart kullanır. Dar ekranda dış düzen tek sütuna iner. Buradaki eşikler örnek tasarım kararlarıdır; her ürün için evrensel değerler değildir.

@media ile @container birbirinin yerine mi geçer?

Hayır. Örnekte @media sayfanın dış yerleşimini, @container ise kartın iç yerleşimini yönetir. İkisi birlikte çalışır. Bir sayfanın navigasyon düzeni ekran alanıyla ilişkiliyken, tekrar kullanılan bir kartın görünümü onu saran alanla daha yakından ilişkili olabilir.

@container başvurusu, sorgunun hangi kapsayıcı üzerinden değerlendirildiğini ve alt öğelere uygulanan kuralları açıklar. İç içe kapsayıcılar arttığında hangi üst öğenin sorgulandığını bilin. Gerekirse container-name ile bağlamı adlandırabilirsiniz.

Neden bazen beklenen genişlik oluşmaz?

inline-size containment, öğenin içeriğinin boyut hesabına katkısını değiştirir. Üstteki grid veya flex düzeni alanı nasıl dağıtacağını açıkça bilmiyorsa kapsayıcı, içerikten beklediğiniz genişliği alamayabilir. Önce dış yerleşimi, sonra sorgu koşulunu kontrol edin.

Bu örnekte minmax(0, 1fr) ve min-width: 0, daralmayı mümkün kılan düzenin parçalarıdır. Container query tek başına uzun bir kelimenin kırılmasını veya kodun kaydırılmasını çözmez. CSS Grid rehberi, bu taşma kararlarını daha ayrıntılı ele alır.

Bileşen hangi durumlarda test edilmelidir?

Aynı viewport içinde iki farklı kapsayıcı genişliği deneyin. Ardından 32rem eşiğinin hemen altında ve üstünde kartın düzenini kontrol edin. Başlığı uzun bir sözcükle değiştirin; metin büyütüldüğünde bağlantının görünür ve klavyeyle ulaşılabilir kaldığını doğrulayın.

Sorgu desteklenmeyen bir ortamda temel tek sütunlu düzenin hâlâ kullanılabilir olması faydalıdır. Hedef tarayıcılarınız için desteği kontrol edin; bütün yeni container özelliklerinin aynı kapsamda desteklendiğini varsaymayın. Bu yazı yalnızca boyut sorgusu kullanır, style veya scroll-state sorguları uygulamaz.

Sık sorulan sorular

Geniş ekran neden yatay kartı garanti etmez? Kartın uygun kapsayıcısı dar bir yan panel olabilir. Sorgu viewport yerine o alanı ölçer.

container-type kartın üstünde mi olmalı? Bu örnekte üst kapsayıcıdadır; kart onun ölçüsüne göre stil alan alt öğedir.

@media artık gereksiz mi? Hayır. Dış sayfa düzeni ile bileşenin kendi düzeni farklı ölçütler kullanabilir.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar