Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti