Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes