CSS Container Queries 2026: Görünüm Penceresi Kırılma Noktası Olmadan Duyarlı Bileşenler Oluşturun
CSS container queries'ın, duyarlı bileşenlerin, tarayıcı görünüm penceresi yerine mevcut alanlarına uyum sağlamasını nasıl sağladığını öğrenin. Yeniden kullanılabilir kartlar oluşturun, adlandırılmış konteynerler ve konteyner birimleri kullanın ve yaygın düzen ve uyumluluk hatalarından kaçının.
CSS Konteyner Sorguları 2026'da: Görünüm Alanı (Viewport) Kesme Noktaları Olmadan Duyarlı Bileşenler Oluşturun
Duyarlı web tasarımı geleneksel olarak medya sorgularına dayanmıştır. Geliştiriciler görüntü alanı kesme noktalarını seçer ve düzenleri telefonlar, tabletler ve masaüstleri için ayarlar. Bu hâlâ sayfa düzeyindeki düzenler için iyi çalışsa da, modern bileşenler genellikle birçok bağlamda görünür: tam genişlikli bölümler, dar yan çubuklar, panolar, modallar ve ızgaralar.
1.440 piksel genişliğinde bir masaüstündeki bir kart, bir yan çubuğun içindeki yalnızca 280 piksel alanına sahip olabilir. Bir görüntü alanı kesme noktası, o bileşenin alanını güvenilir bir şekilde tanımlayamaz.
CSS konteyner sorguları, bileşenlerin yalnızca görüntü alanı yerine uygun bir atalarının boyutuna yanıt vermesini sağlar. Bu da onları yeniden kullanılabilir tasarım sistemleri, WordPress blok temaları, Joomla modülleri ve sayfa oluşturucularda özellikle yararlı kılar.
CSS konteyner sorguları nedir?
Bir boyut konteyner sorgusu, belirlenen bir atası konteynerin boyutlarını değerlendirir. Bileşen, kendisine ayrılan alan bir eşiği aştığında iç düzenini değiştirebilir.
Örneğin, bir kart dar olduğunda resmini metnin üzerinde gösterirken, konteyneri en az 480 piksel genişliğindeyken resmi metnin yanına taşıyabilir.
Medya sorguları sayfa genelindeki gezinme ve cihaz tercihleri için hâlâ faydalıdır. Konteyner sorguları bileşen düzeyinde duyarlılık sorununu ayrı ayrı çözer.
Medya sorguları ve konteyner sorguları: görsel karşılaştırma ve canlı demo
İllüstrasyon iki yaklaşımı karşılaştırır. Kartın kullanılabilir genişliğini değiştirmek için kaydırıcıyı hareket ettirin. Gösterim, bir JavaScript kontrollü düzen anahtarı yerine gerçek bir CSS boyut konteyner sorgusu kullanır.
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.
Kesme noktası, belirli bir cihaz kategorisine değil, bileşenin tasarımına aittir. Dar bir telefon ekranında, demo konteyneri kullanılabilir görüntü alanı genişliğiyle sınırlandırır.
1. Adım: Anlamsal bir kart oluşturun
Bir makale listesi, ürün önerisi veya belgeler dizininde görünebilecek bir kartla başlayın:
<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>
Dış öğe sorgu konteyneri olacak. İç article, sunumu değişen torun öğesidir.
Bu ayrım önemlidir: bir boyut konteyner sorgusu, sorgulanan öğeyi kendisini stillendirmez. Bir atası konteyneri değerlendirir ve eşleşen torunları stillendirir.
2. Adım: Sağlam bir varsayılan düzen yazın
Konteyner sorguları olmadan kullanılabilir kalan bir düzenle başlayın:
.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;
}
Varsayılan resim-üstte-metin-altta düzeni dar alanlarda çalışır. minmax(0, 1fr) ızgara yolu ve min-width: 0 uzun içeriğin taşma riskini azaltır.
3. Adım: Sorgu konteynerini bildirin
container-type özelliğini kullanın:
.card-container {
container-type: inline-size;
}
inline-size değeri, yatay yazım modlarında genellikle genişliğe karşılık gelen satır içi eksen boyunca boyut sorgularını etkinleştirir.
Ayrıca şunu da görebilirsiniz:
.card-container {
container-type: size;
}
size değeri her iki ekseni de destekler ancak daha güçlü içerme gereksinimleri getirir. Çoğu duyarlı kart için inline-size daha pratik bir varsayılandır.
İçerme (containment) önemlidir çünkü tarayıcılar, torun stilleriyle döngüsel bağımlılıklar olmadan konteyner boyutunu hesaplayabilmelidir.
4. Adım: Duyarlı kuralı ekleyin
Artık atası konteyner yeterince geniş olduğunda yalnızca iç düzeni değiştirin:

@container (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
align-items: center;
}
.content-card__image {
height: 100%;
}
}
Sadece 300 piksel genişliğinde olan geniş bir masaüstü yan çubuğu yığınlanmış düzeni korur. Bir kart 600 piksel genişliğinde bir içerik sütununda yatay hale gelir, hatta görüntü alanı özellikle geniş değilse bile.
Bu, temel faydadır: bileşen kendi kullanılabilir alanına yanıt verir.
5. Adım: Karmaşık düzenler için adlandırılmış konteynerler kullanın
Bir panoda veya CMS şablonunda, bir bileşenin birkaç iç içe konteyneri olabilir. Varsayılan olarak, bir boyut sorgusu en yakın uygun atayı bulur.
Daha fazla kontrol gerektiğinde hedeflenen konteyneri adlandırın:
.article-list-item {
container: article-card / inline-size;
}
@container article-card (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
}
}
container kısayolu hem adı hem de türü tanımlar. İsimlendirme, alakasız bir iç içe konteynerin sorgu hedefi olmasını engeller.
6. Adım: Konteyner-göreli birimleri kullanın
CSS, uygun bir sorgu konteynerine dayalı uzunluk birimlerini içerir:
| Birim | Anlamı |
|---|---|
cqw |
Konteyner genişliğinin %1'i |
cqh |
Konteyner yüksekliğinin %1'i |
cqi |
Konteyner satır içi boyutunun %1'i |
cqb |
Konteyner blok boyutunun %1'i |
cqmin |
cqi ve cqb'in küçük olanı |
cqmax |
cqi ve cqb'in büyük olanı |
Akıcı bileşen tipografisi için:
.card-container {
container: article-card / inline-size;
}
.content-card h2 {
font-size: clamp(1.1rem, 4cqi, 1.8rem);
}
vw'den farklı olarak, cqi metni bileşenin konteyneriyle ölçeklendirebilir. Her zaman okunabilirliği, tarayıcı yakınlaştırmasını ve uzun çevrilen başlıkları test edin. Uygun bir konteyner yoksa, konteyner-göreli birimler geçersiz olmak yerine belirtilen yedek davranışı izler.
7. Adım: Kademeli geliştirme ekleyın
Varsayılan yığınlanmış düzeni koruyun ve daha gelişmiş davranışı koşullu olarak etkinleştirin:
.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);
}
}
}
İlgili özelliği desteklemeyen tarayıcılar işlevsel bir düzeni korur. Yedek, her geliştirmeyle eşleşmek zorunda değildir; okunabilir ve kullanılabilir kalması gerekir.
Konteyner sorguları Grid veya Flexbox'ı değiştirmez
Grid ve Flexbox öğeleri düzenler. Konteyner sorguları belirli CSS kurallarının ne zaman uygulanacağını belirler.
Örneğin, duyarlı bir kart koleksiyonu yalnızca Grid'e ihtiyaç duyabilir:
.product-grid {
display: grid;
grid-template-columns:
repeat(auto-fit, minmax(min(100%, 240px), 1fr));
gap: 1.5rem;
}
Her kartın iç tasarımı atanan genişliğine göre değişmesi gerektiğinde konteyner sorguları ekleyin. Standart Grid veya Flexbox zaten sorunu çözüyorsa sorgu konteynerleri eklemeyin.
Peki, konteyner stil sorguları ne durumda?
Konteyner sorguları, destekleyen tarayıcılarda özel özellikler de dahil olmak üzere bazı hesaplanmış stil koşullarını da test edebilir:
.feature-panel {
--panel-theme: dark;
}
@container style(--panel-theme: dark) {
.feature-panel__title {
color: white;
}
}
Bu sözdizimini gösterir; stil sorguları ve daha yeni sorgu yeteneklerinin farklı tarayıcı destek detayları vardır. Boyut sorguları için destek, her stil sorgusu, özellik veya daha yeni kaydırma durumu özelliği için destek garanti etmez. Üretim dağıtımından önce kullandığınız tam sözdizimini mevcut uyumluluk tablolarına göre doğrulayın.
Beş yaygın hata
1. Bir öğeyi stillendirmek için kendi boyutunu sorgulama

Bu beklenildiği gibi çalışmaz:
.card {
container-type: inline-size;
}
@container (min-width: 480px) {
.card {
display: grid;
}
}
Sorgulanan konteyner, stillendirilen öğenin atası olmalıdır. Dış bir sarmalayıcı ekleyin veya içermeyi uygun bir ataya taşıyın.
2. Konteyner bildirmeyi unutma
Tek başına bir @container kuralı, en yakın ebeveyni otomatik olarak uygun bir boyut konteyneri yapmaz. container-type: inline-size bildirin veya karşılık gelen kısayolu kullanın.
3. Görüntü alanı kesme noktalarını körü körüne yeniden kullanma
Bu sayılar tanıdık geldiği için 768px veya 1024px'i otomatik olarak kullanmayın. Bileşenin içeriğinin gerçekten farklı bir düzeni gerektirdiği bir kesme noktası seçin.
4. İçermeyi her yere uygulamak
İçerme boyutlandırma davranışını değiştirir. Çok fazla konteyner, bir öğe boyutları için torunlara güveniyorsa hata ayıklamayı zorlaştırabilir. Konteynerleri kasıtlı olarak oluşturun.
5. Her konteyner sorgu özelliğinin eşit desteklendiğini varsayma
Boyut sorguları, stil sorguları ve daha yeni yeteneklerin farklı uyumluluk geçmişleri vardır. Üretime göndermeyi planladığınız tam sözdizimi kontrol edin.
Performans hususları
Konteyner sorguları tarayıcının CSS/düzen motorunda çalışır. Bazı JavaScript tabanlı boyutlandırma gözlemcilerini ve manuel DOM ölçümlerini ortadan kaldırabilirler.
Bu mimari basitleştirme faydalıdır, ancak konteyner sorguları daha hızlı bir web sitesi garanti etmez. İşleme maliyeti stillendirme sayfasına, DOM karmaşıklığına, düzen yapısına ve içerme seçeneklerine bağlıdır.
Performansı ölçün ve gereksiz sorgu katmanlarından kaçının.
WordPress ve Joomla'da pratik uygulamalar
WordPress blok temaları: Aynı blok tam genişlikli bir bölümde, dar bir sütunda veya bir yan çubuğunda görünebilir. Konteyner sorguları, blokun ayrı masaüstü ve mobil varyantları olmadan uyarlanmasını sağlar.
Joomla şablonları ve modülleri: Bir modül farklı şablon pozisyonlarına atanabilir. Bir bileşen tabanlı düzen, görüntü alanından tahmin etmek yerine gerçek modül genişliğine uyarlanabilir.
Sayfa oluşturucular: Editörler sık sık bileşenleri iç içe sütunlar arasında taşır. Konteyner tabanlı kurallar bu bileşenleri düzen değişikliklerine karşı daha dayanıklı hale getirebilir.
Panolar: Yeniden boyutlandırılabilen paneller ve bileşenler, kullanılabilir alan değiştikçe iç düzenlerini ayarlayabilir.
Hala medya sorgularını ne zaman kullanmalısınız?
Medya sorguları, görüntü alanı bağımlı gezinme, baskı stilleri, azaltılmış hareket tercihleri, işaretçi yetenekleri ve diğer kullanıcı/cihaz özellikleri için hâlâ uygundur.
Yararlı bir kural medya sorguları sayfa için; konteyner sorguları bileşen için şeklindedir. Bu mutlak bir kural değil, ama sorumlulukları ayırmanın net bir yoludur.
Konteyner sorgularını nasıl test edersiniz?
Aynı bileşeni geniş bir içerik alanında, dar yan çubuğunda, ızgarada ve modalda test edin. Sadece tarayıcı penceresini değil, konteyneri yeniden boyutlandırın.
Yatay taşma, resim bozulması, uzun başlıklar, tarayıcı yakınlaştırması, çevrilen içerik ve ilgiliyse sağdan-sola yazım modlarını kontrol edin.
Tarayıcı geliştirici araçlarını kullanarak hesaplanmış konteyner özelliklerini inceleyin ve hangi kuralların uygulandığını onaylayın. Gerçek dar cihazlarda ve masaüstü simülasyonlarında test edin.
Sonuç
CSS konteyner sorguları, görüntü alanı tabanlı duyarlı tasarımın uzun yıllık bir kısıtlamasını ele alır: bir bileşenin kullanılabilir alanı, tarayıcının genişliğiyle özdeş olmak zorunda değildir.
Boyut konteynerlerini Grid, Flexbox ve akıllı yedeklerle birleştirerek, geliştiriciler temalar, modüller, sayfa oluşturucular ve uygulamalar arasında doğal olarak uyum sağlayan yeniden kullanılabilir bileşenler oluşturabilir.
İşlevsel bir varsayılan düzenle başlayın, yalnızca anlamlı konteynerleri bildirin, içeriğe dayalı kesme noktaları seçin ve birden fazla bağlamda test edin.
Duyarlı tasarım artık sadece ekran boyutu hakkında değil. Her bileşenin kullanılabilir alanı hakkında da.