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.