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.