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

CKTIS / CSS

container — abreviatura para contentores de consulta

A propriedade CSS container define em conjunto container-name e container-type. Dá um nome ao contentor e especifica que consultas o podem utilizar para aplicar estilos condicionais aos descendentes.

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

Sintaxe

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

container é a abreviatura de container-name e container-type, não da regra @container. Os nomes ficam antes de / e o tipo depois. A declaração container: demo / inline-size atribui o nome demo e permite consultas de tamanho ao longo do eixo em linha do contentor.

inline-size diz respeito ao eixo em linha, enquanto size diz respeito a ambos os eixos. Estes tipos também limitam a forma como o tamanho do contentor depende do seu conteúdo; por isso, assegura dimensões adequadas através do esquema da página. Um nome, por si só, não permite consultas de tamanho.

Se o tipo for omitido, container-type é reposto para normal: container: demo não mantém um inline-size definido anteriormente. container: none remove os nomes e também repõe o tipo. Nenhuma das propriedades longas é herdada.

A regra @container demo (...) seleciona o antepassado elegível mais próximo com o nome demo; um elemento comum não pode consultar-se a si próprio desta forma. No exemplo, a condição altera o fundo de .card, não o de .panel. A consulta depende do tamanho do contentor, não diretamente do tamanho da janela de visualização.

Exemplos

<!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>

Resultado

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

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