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

CKTIS / CSS

@supports — regras CSS condicionais

A regra @supports ativa estilos aninhados apenas quando o motor satisfaz a condição de suporte indicada.

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

Sintaxe

@supports <supports-condition> { <block-contents> }

@supports avalia uma condição de suporte antes de o bloco participar na cascata. O teste de declaração (display: grid) é verdadeiro quando o motor aceita esse par propriedade-valor, enquanto selector(...) verifica a sintaxe do seletor. As condições podem ser negadas e combinadas com not, and e or; and e or não podem ser misturados no mesmo nível sem parênteses.

O exemplo define valores base para --display-check e --selector-check. O teste verdadeiro de Grid muda o primeiro para yes; o seletor propositadamente desconhecido não ativa o respetivo ramo, pelo que o segundo permanece no. A leitura das condições CSSOM e das propriedades personalizadas calculadas demonstra o efeito na cascata, não apenas uma consulta a uma API auxiliar.

Um teste sintático bem-sucedido não garante o comportamento em cada caso nem a acessibilidade do resultado. Uma declaração de propriedade personalizada aceita quase qualquer sequência de tokens e, por isso, não testa de forma fiável uma funcionalidade específica. Uma condição desconhecida ou inválida é falsa e o bloco não afeta o estilo.

Exemplos

const style = document.createElement('style');
style.textContent = `.probe { --display-check: no; --selector-check: no; }
@supports (display: grid) { .probe { --display-check: yes; } }
@supports selector(:definitely-unknown) { .probe { --selector-check: yes; } }`;
document.head.append(style);
const probe = document.createElement('div');
probe.className = 'probe';
document.body.append(probe);
const computed = getComputedStyle(probe);
const trueRule = style.sheet.cssRules[1];
const falseRule = style.sheet.cssRules[2];
console.log('true=' + trueRule.conditionText + ':' + computed.getPropertyValue('--display-check').trim() + '; false=' + falseRule.conditionText + ':' + computed.getPropertyValue('--selector-check').trim());

Resultado

true=(display: grid):yes; false=selector(:definitely-unknown):no

A regra @supports ativa estilos aninhados apenas quando o motor satisfaz a condição de suporte indicada.

Fontes