Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

container — abbreviazione per i contenitori di query

La proprietà CSS container imposta insieme container-name e container-type. Assegna un nome al contenitore e specifica quali query possono usarlo per applicare stili condizionali ai discendenti.

Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintassi

container: <'container-name'> [ / <'container-type'> ]?;

container è l’abbreviazione di container-name e container-type, non della regola @container. I nomi vanno prima di / e il tipo dopo. La dichiarazione container: demo / inline-size assegna il nome demo e abilita le query di dimensionamento lungo l’asse inline del contenitore.

inline-size riguarda l’asse inline, mentre size riguarda entrambi gli assi. Questi tipi limitano anche il modo in cui la dimensione del contenitore dipende dal suo contenuto; assicurati quindi di prevedere dimensioni adeguate nel layout della pagina. Il solo nome non abilita le query di dimensionamento.

Se il tipo viene omesso, container-type viene reimpostato su normal: container: demo non mantiene un precedente inline-size. container: none rimuove i nomi e reimposta anche il tipo. Nessuna delle due proprietà estese è ereditata.

La regola @container demo (...) seleziona l’antenato idoneo più vicino chiamato demo; un elemento ordinario non può interrogare se stesso in questo modo. Nell’esempio, la condizione cambia lo sfondo di .card, non quello di .panel. La query dipende dalla dimensione del contenitore, non direttamente da quella della finestra di visualizzazione.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Named container query at two widths</title>
  <style>
    .panel {
      container: demo / inline-size;
      writing-mode: horizontal-tb;
      margin-block-end: 8px;
    }
    .wide { inline-size: 320px; }
    .narrow { inline-size: 280px; }
    .card { background-color: lightgray; color: black; padding: 8px; }
    @container demo (inline-size >= 300px) {
      .card { background-color: lightgreen; }
    }
  </style>
</head>
<body>
  <div class="panel wide"><div class="card">Card in the 320px container</div></div>
  <div class="panel narrow"><div class="card">Card in the 280px container</div></div>
  <script>
    for (const panel of document.querySelectorAll('.panel')) {
      const width = getComputedStyle(panel).inlineSize;
      const color = getComputedStyle(panel.querySelector('.card')).backgroundColor;
      console.log(`${width}: ${color}`);
    }
  </script>
</body>
</html>

Risultato

320px: rgb(144, 238, 144)
280px: rgb(211, 211, 211)

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti