Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

container-name — assegnare nomi ai contenitori di query

La proprietà container-name assegna nomi a un elemento, così le regole @container possono selezionare un contenitore. Assegnare un nome non abilita da solo le query sulle dimensioni: serve un container-type appropriato.

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

Sintassi

container-name: none | <custom-ident>+;

container-name assegna a un elemento uno o più nomi che filtrano i contenitori presi in considerazione da @container. Una query seleziona l’antenato idoneo più vicino con il nome indicato; non interroga l’elemento a cui si applicano gli stili. I nomi non devono essere univoci.

Il valore iniziale none significa che non è assegnato alcun nome, non che tutte le query siano disabilitate. La notazione <custom-ident>+ indica uno o più nomi separati da spazi, senza virgole né virgolette, come panel sidebar. Le maiuscole e le minuscole sono distinte. none, and, not e or non possono essere usati come nomi; nemmeno le parole chiave globali di CSS sono nomi.

La proprietà si applica a tutti gli elementi, non è ereditata e non è animabile. Non sostituisce container-type. In una modalità di scrittura orizzontale, container-type: inline-size consente le query sulla larghezza fisica (width). In una modalità di scrittura verticale, invece, l’asse inline corrisponde all’altezza, quindi un contenitore con inline-size non è idoneo per una query su width. In tal caso, usa container-type: size per consentire le query su entrambi gli assi. La forma abbreviata container: panel / inline-size imposta entrambe le proprietà; omettere la parte dopo / reimposta container-type a normal.

L’esempio usa la modalità di scrittura orizzontale predefinita e il contenitore è largo 320px, quindi la query con nome e soglia di 300px assegna al discendente .card un padding di 16px. Cambiando il nome del contenitore in other, la query non corrisponde e il padding resta di 4px.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>container-name</title>
<style>
  .panel {
    width: 320px;
    container-type: inline-size;
    container-name: panel sidebar;
  }
  .card { padding: 4px; }
  @container panel (min-width: 300px) {
    .card { padding: 16px; }
  }
</style>
<div class="panel">
  <div class="card">Card</div>
</div>
<script>
  const card = document.querySelector('.card');
  console.log(getComputedStyle(card).paddingTop);
</script>

Risultato

16px

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