CKTIS / CSS
@container — interrogare un contenitore antenato
La regola @container condiziona gli stili dei discendenti alla dimensione o allo stile di un contenitore antenato selezionato, non solo al viewport.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
@container <container-condition># {
<block-contents>
}@container [<container-name>]? <container-condition> { <stylesheet> } è una regola di gruppo condizionale. Per ogni elemento il browser sceglie il contenitore antenato più vicino idoneo a tutte le caratteristiche della condizione; un nome facoltativo filtra i candidati. Le query dimensionali richiedono container-type: inline-size o size, mentre quelle di stile esaminano valori calcolati esposti dal contenitore.
Un componente può quindi cambiare impaginazione quando il proprio pannello ha spazio sufficiente, senza variazioni del viewport. La condizione stila i discendenti: un elemento non può interrogare la propria dimensione per stilare sé stesso. Senza un antenato idoneo la query è sconosciuta e il blocco non si applica. Un nome può selezionare un contesto esterno specifico.
Combina and, or e not secondo la grammatica. Le unità em nella condizione usano la dimensione del carattere calcolata sul contenitore. Query annidate possono scegliere contenitori diversi e non sempre sono unificabili. L’esempio legge --state a 300 px, restringe il contenitore a 100 px e legge il valore calcolato reale.
Esempi
const style = document.createElement('style');
style.textContent = `.host { container-type: inline-size; width: 300px; }
.target { --state: base; }
@container (inline-size > 200px) { .target { --state: wide; } }`;
document.head.append(style);
const host = document.createElement('div');
host.className = 'host';
host.innerHTML = '<div class="target">card</div>';
document.body.append(host);
const target = host.firstElementChild;
const wide = getComputedStyle(target).getPropertyValue('--state').trim();
host.style.width = '100px';
await new Promise(requestAnimationFrame);
const narrow = getComputedStyle(target).getPropertyValue('--state').trim();
console.log('300px=' + wide + '; 100px=' + narrow);Risultato
300px=wide; 100px=base
La regola @container condiziona gli stili dei discendenti alla dimensione o allo stile di un contenitore antenato selezionato, non solo al viewport.