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

CKTIS / CSS

@container — consultar um contentor antepassado

A regra @container condiciona estilos de descendentes ao tamanho ou estilo de um contentor antepassado selecionado, em vez de depender apenas do viewport.

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

Sintaxe

@container <container-condition># {
  <block-contents>
}

@container [<container-name>]? <container-condition> { <stylesheet> } é uma regra de grupo condicional. Para cada elemento, o navegador escolhe o contentor antepassado mais próximo elegível para todas as características; um nome opcional filtra candidatos. Consultas de tamanho exigem container-type: inline-size ou size, enquanto consultas de estilo observam valores calculados expostos pelo contentor.

Assim, um componente muda de composição quando o seu próprio painel tem espaço, mesmo sem alteração do viewport. A condição estiliza descendentes: um elemento não pode consultar o próprio tamanho para se estilizar. Sem antepassado elegível, a consulta é desconhecida e o bloco não se aplica. Um nome permite selecionar intencionalmente um contexto exterior.

Combina and, or e not segundo a gramática. Unidades em na condição usam o tamanho de letra calculado do contentor. Consultas aninhadas podem escolher contentores diferentes e nem sempre podem ser fundidas. O exemplo lê --state a 300 px, reduz o contentor para 100 px e volta a ler o valor calculado real.

Exemplos

const style = document.createElement('style');
style.textContent = `.host { container-type: inline-size; width: 300px; }
.target { --state: base; }
@container (inline-size > 200px) { .target { --state: wide; } }`;
document.head.append(style);
const host = document.createElement('div');
host.className = 'host';
host.innerHTML = '<div class="target">card</div>';
document.body.append(host);
const target = host.firstElementChild;
const wide = getComputedStyle(target).getPropertyValue('--state').trim();
host.style.width = '100px';
await new Promise(requestAnimationFrame);
const narrow = getComputedStyle(target).getPropertyValue('--state').trim();
console.log('300px=' + wide + '; 100px=' + narrow);

Resultado

300px=wide; 100px=base

A regra @container condiciona estilos de descendentes ao tamanho ou estilo de um contentor antepassado selecionado, em vez de depender apenas do viewport.

Fontes