CKTIS / CSS
container-name — atribuir nomes a contentores de consulta
A propriedade container-name atribui nomes a um elemento para que as regras @container possam selecionar um contentor. Atribuir um nome, por si só, não ativa consultas de tamanho: estas requerem um container-type adequado.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
container-name: none | <custom-ident>+;container-name atribui a um elemento um ou mais nomes que filtram os contentores considerados por @container. Uma consulta seleciona o antepassado elegível mais próximo com o nome indicado; não consulta o próprio elemento ao qual se aplicam os estilos. Os nomes não têm de ser únicos.
O valor inicial none significa que não existe um nome, não que todas as consultas estejam desativadas. A notação <custom-ident>+ significa um ou mais nomes separados por espaços, sem vírgulas nem aspas, como panel sidebar. A distinção entre maiúsculas e minúsculas é relevante. none, and, not e or não podem ser nomes; as palavras-chave globais de CSS também não são nomes.
A propriedade aplica-se a todos os elementos, não é herdada e não é animável. Não substitui container-type. Num modo de escrita horizontal, container-type: inline-size permite consultas sobre a largura física (width). Num modo de escrita vertical, porém, o eixo em linha corresponde à altura, pelo que um contentor com inline-size não é elegível para uma consulta sobre width. Nesse caso, use container-type: size para permitir consultas nos dois eixos. A forma abreviada container: panel / inline-size define ambas as propriedades; omitir a parte depois de / repõe container-type em normal.
O exemplo usa o modo de escrita horizontal predefinido e o contentor tem 320px de largura, pelo que a consulta com nome e limiar de 300px dá um preenchimento de 16px ao descendente .card. Se o nome do contentor mudar para other, a consulta deixa de corresponder e o preenchimento mantém-se em 4px.
Exemplos
<!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>Resultado
16px
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.