CSS Container Queries nel 2026: Crea componenti responsive senza breakpoint del viewport
Scopri come le CSS container queries permettono ai componenti responsive di adattarsi allo spazio disponibile invece che al viewport del browser. Crea card riutilizzabili, usa container denominati e unità container, ed evita le comuni insidie di layout e compatibilità.
Le query container CSS nel 2026: Crea componenti responsive senza breakpoint di viewport
Il responsive web design si è tradizionalmente basato sulle query media. Gli sviluppatori scelgono breakpoint del viewport e modificano layout per telefoni, tablet e desktop. Questo funziona ancora bene per layout a livello di pagina, ma i componenti moderni spesso compaiono in molti contesti: sezioni a larghezza piena, sidebar strette, dashboard, modali e griglie.
Una scheda su un desktop da 1.440 pixel di larghezza può ancora avere solo 280 pixel disponibili all'interno di una sidebar. Un breakpoint del viewport non può descrivere in modo affidabile lo spazio di quel componente.
Le query container CSS permettono ai componenti di rispondere alle dimensioni di un antecedente elegibile piuttosto che solo al viewport. Questo le rende particolarmente utili in sistemi di design riutilizzabili, temi WordPress a blocchi, moduli Joomla e page builder.
Che cos'è le query container CSS?
Una query container di dimensioni valuta le dimensioni di un contenitore antesignano designato. Un componente può modificare il proprio layout interno quando lo spazio disponibile incrocia una soglia.
Ad esempio, una scheda potrebbe visualizzare l'immagine sopra il testo quando è stretta, ma spostare l'immagine accanto al testo quando il suo contenitore è di almeno 480 pixel di larghezza.
Le query media rimangono utili per la navigazione a livello di pagina e le preferenze del dispositivo. Le query container risolvono il problema separato della responsiveness a livello di componente.
Query media vs. query container: confronto visivo e demo live
L'illustrazione confronta i due approcci. Sposta il slider per cambiare la larghezza disponibile della scheda. La dimostrazione utilizza una reale query container CSS di dimensione, non un switch di layout controllato da 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.
Il breakpoint appartiene al design del componente piuttosto che a una categoria di dispositivi specifica. Su uno schermo di telefono stretto, la demo limita il contenitore alla larghezza del viewport disponibile.
Passo 1: Crea una scheda semantica
Inizia con una scheda che potrebbe apparire in un articolo, raccomandazione di prodotti o indice documentazione:
<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>
L'elemento esterno diventerà il contenitore della query. L'articolo interno è il discendente la cui presentazione cambia.
Questa distinzione è importante: una query container di dimensioni non stile l'elemento interrogato stesso. Valuta un contenitore antesignano e stile i discendenti corrispondenti.
Passo 2: Scrivi un layout predefinito robusto
Inizia con un layout che rimanga utilizzabile senza query container:
.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;
}
Il layout predefinito con immagine sopra il testo funziona in spazi stretti. La minmax(0, 1fr) grid track e la min-width: 0 riducono il rischio che il contenuto lungo superi il contenitore.
Passo 3: Dichiara il contenitore della query
Usa la proprietà container-type:
.card-container {
container-type: inline-size;
}
Il valore inline-size abilita query di dimensioni lungo l'asse inline, che solitamente corrisponde alla larghezza in modalità di scrittura orizzontale.
Potresti anche incontrare:
.card-container {
container-type: size;
}
Il valore size supporta entrambi gli assi ma introduce requisiti di contenimento più forti. Per la maggior parte delle schede responsive, inline-size è una scelta predefinita più pratica.
Il contenimento è importante perché i browser devono poter calcolare la dimensione del contenitore senza dipendenze circolari dagli stili discendenti.
Passo 4: Aggiungi la regola responsive
Ora modifica il layout interno solo quando il contenitore antesignano è abbastanza ampio:

@container (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
align-items: center;
}
.content-card__image {
height: 100%;
}
}
Una sidebar desktop larga che misura solo 300 pixel mantiene il layout a colonna. Una scheda in una colonna di contenuto di 600 pixel diventa orizzontale, anche se il viewport non è particolarmente largo.
Questo è il beneficio centrale: il componente risponde al proprio spazio disponibile.
Passo 5: Usa contenitori nominati per layout complessi
In un dashboard o template CMS, un componente può avere diversi contenitori annidati. Per default, una query di dimensioni trova il più vicino antecedente elegibile.
Dai un nome al contenitore intenduto quando necessiti di più controllo:
.article-list-item {
container: article-card / inline-size;
}
@container article-card (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
}
}
Il container shorthand definisce sia il nome che il tipo. Assegnare un nome aiuta a prevenire che un contenitore annidato non correlato diventi l'obiettivo della query.
Passo 6: Usa unità relative al contenitore
CSS include unità di lunghezza basate su un contenitore di query elegibile:
| Unità | Significato |
|---|---|
cqw |
1% della larghezza del contenitore |
cqh |
1% dell'altezza del contenitore |
cqi |
1% della dimensione inline del contenitore |
cqb |
1% della dimensione block del contenitore |
cqmin |
Minore tra cqi e cqb |
cqmax |
Maggiore tra cqi e cqb |
Per la tipografia fluida del componente:
.card-container {
container: article-card / inline-size;
}
.content-card h2 {
font-size: clamp(1.1rem, 4cqi, 1.8rem);
}
A differenza di vw, cqi può scalare il testo con il contenitore del componente. Controlla sempre la leggibilità, lo zoom del browser e lunghe intestazioni tradotte. Se non esiste un contenitore elegibile, le unità relative al contenitore seguono il comportamento di fallback specificato invece di diventare non valide.
Passo 7: Aggiungi il progressive enhancement
Mantieni il layout predefinito a colonna e abilita condizionalmente il comportamento più avanzato:
.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);
}
}
}
I browser senza la funzionalità pertinente mantengono un layout funzionale. Il fallback non deve corrispondere a ogni miglioramento; deve solo rimanere leggibile e utilizzabile.
Le query container non sostituiscono Grid o Flexbox
Grid e Flexbox organizzano gli elementi. Le query container determinano quando determinate regole CSS dovrebbero essere applicate.
Ad esempio, una raccolta response di scheda può aver bisogno solo di Grid:
.product-grid {
display: grid;
grid-template-columns:
repeat(auto-fit, minmax(min(100%, 240px), 1fr));
gap: 1.5rem;
}
Aggiungi query container quando il design interno di ogni scheda deve cambiare in base alla sua larghezza assegnata. Evita di introdurre contenitori di query dove Grid o Flexbox standard risolvono già il problema.
E le query container di stile?
Le query container possono anche testare alcune condizioni di stile calcolate, incluse proprietà personalizzate nei browser supportanti:
.feature-panel {
--panel-theme: dark;
}
@container style(--panel-theme: dark) {
.feature-panel__title {
color: white;
}
}
Questo illustra la sintassi; le query di stile e le nuove capacità di query hanno dettagli di supporto browser distinti. Il supporto per le query di dimensioni non garantisce il supporto per ogni query di stile, proprietà o caratteristica più recente dello scroll-state. Verifica la caratteristica esatta contro le tabelle di compatibilità aggiornate prima del deploy in produzione.
Cinque errori comuni
1. Interrogare la dimensione di un elemento per stilearlo

Questo non funziona come previsto:
.card {
container-type: inline-size;
}
@container (min-width: 480px) {
.card {
display: grid;
}
}
Il contenitore interrogato deve essere un antesignano dell'elemento stile. Introduci un wrapper esterno o sposta il contenimento su un antesignano adatto.
2. Dimenticare di dichiarare un contenitore
Una regola @container da sola non rende automaticamente il genitore più vicino un contenitore di dimensioni elegibile. Dichiara container-type: inline-size o usa il corrispondente shorthand.
3. Riutilizzare i breakpoint del viewport senza pensare
Non usare automaticamente 768px o 1024px solo perché quei numeri sono familiari. Scegli un breakpoint dove il contenuto del componente richiede effettivamente un diverso assetto.
4. Applicare il containment ovunque
Il containment cambia il comportamento di sizing. Troppi contenitori possono complicare il debug, specialmente quando un elemento si basa sui discendenti per le sue dimensioni. Istabilisci i contenitori intenzionalmente.
5. Supporre che ogni caratteristica delle query container sia ugualmente supportata
Le query di dimensioni, query di stile e capacità più recenti hanno storie di compatibilità diverse. Controlla la sintassi esatta che intendi spedire.
Considerazioni sulle prestazioni
Le query container funzionano nel motore CSS/layout del browser. Possono eliminare alcune observer di ridimensionamento JavaScript e misurazioni manuali del DOM.
Questa semplificazione architetturale è utile, ma le query container non garantiscono un sito più veloce. Il costo di rendering dipende dal foglio di stile, dalla complessità del DOM, dalla struttura layout e dalle scelte di contenimento.
Misura le prestazioni ed evita strati di query non necessari.
Applicazioni pratiche in WordPress e Joomla
Temi WordPress a blocchi: Lo stesso blocco può apparire in una sezione a larghezza piena, una colonna stretta o una sidebar. Le query container permettono al blocco di adattarsi senza varianti separate desktop e mobile.
Template e moduli Joomla: Un modulo può essere assegnato a diverse posizioni del template. Un layout basato sui componenti può adattarsi alla larghezza effettiva del modulo invece di indovinare dal viewport.
Page builder: Gli editor spostano frequentemente componenti tra colonne annidate. Le regole basate su contenitore possono rendere questi componenti più resilienti ai cambiamenti di layout.
Dashboard: Pannelli e widget ridimensionabili possono adattare i propri layout interni quando lo spazio disponibile cambia.
Quando dovresti ancora usare le query media?
Le query media rimangono appropriate per la navigazione dipendente dal viewport, stampe, preferenze per la riduzione del movimento, capacità del pointer e altre caratteristiche del dispositivo/utente.
Una line guida utile è query media per la pagina; query container per il componente. Non è una regola assoluta, ma è un modo chiaro per dividere le responsabilità.
Come testare le query container
Testa lo stesso componente in un'area di contenuto largo, sidebar stretta, griglia e modal. Ridimensiona il contenitore, non solo la finestra del browser.
Controlla overflow orizzontale, distorsione di immagini, titoli lunghi, zoom del browser, contenuto tradotto e modalità di scrittura da destra a sinistra dove rilevanti.
Usa gli strumenti di sviluppo del browser per ispezionare le proprietà del contenitore calcolate e confermare quali regole si applicano. Testa su dispositivi stretti reali così come su simulazioni desktop.
Conclusione
Le query container CSS affrontano una limitazione storica del design responsive basato sul viewport: lo spazio disponibile di un componente non corrisponde necessariamente alla larghezza del browser.
Combinando contenitori di dimensioni con Grid, Flexbox e fallback sensibili, gli sviluppatori possono creare componenti riutilizzabili che si adattano naturalmente attraverso temi, moduli, page builder e applicazioni.
Inizia con un layout predefinito funziona, dichiara solo contenitori significativi, scegli breakpoint basati sul contenuto e testa in contesti diversi.
Il responsive design non è più solo sulla dimensione dello schermo. È anche sullo spazio disponibile per ogni componente.