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

CKTIS / CSS

supports(): uma condição CSS cujo suporte depende do contexto

Distinga a importação condicional, a notação @when proposta, a regra @supports e a API JavaScript.

Versão: CSS Modules

Sintaxe

@import url("grid.css") supports(display: grid);

supports() é uma condição de suporte de funcionalidades CSS, não um valor de propriedade nem uma chamada JavaScript. Em @import, supports(display: grid) permite a folha importada apenas se a declaração for suportada. Também pode ser utilizada uma condição supports completa, incluindo not ou combinações entre parênteses. A função surge depois do URL e da cláusula layer opcional, antes de qualquer consulta de media. Mantenha as importações antes das regras de estilo normais; uma condição supports falsa impede a obtenção e aplicação dessa folha importada.

CSS Conditional Rules Level 5 também define supports(declaration) na regra @when proposta. Esse contexto tem um estado de implementação próprio. Não deve ser deduzido do funcionamento das condições @import, da regra consolidada @supports ou de CSS.supports() em JavaScript. Esta última API aceita um par propriedade/valor ou uma cadeia com uma condição supports, não o invólucro supports(...) utilizado nestes contextos CSS. A sintaxe da importação condicional é definida separadamente em CSS Cascade.

O exemplo usa folhas data locais e lê uma propriedade que estas realmente definem. A importação grid suportada é aplicada; o valor display deliberadamente não suportado não a substitui. No Chromium 157 testado, o bloco @when é omitido e mantém-se a alternativa. O seu CSSOM expõe uma regra de importação e nenhuma regra @when. O teste de declaração JavaScript devolve true, enquanto a cadeia com o invólucro devolve false. São observações explícitas de mecanismos distintos, não uma afirmação de que todos os contextos supports() funcionam.

Uma consulta de funcionalidade positiva significa que o navegador declara suporte; não prova que uma página concreta esteja isenta de erros, seja acessível ou visualmente correta. Mantenha estilos alternativos úteis e teste o comportamento necessário. O exemplo local verifica a aplicação do estilo, não tráfego de rede real, cache ou disponibilidade de uma folha remota.

Exemplos

const box=document.createElement('div');box.id='supports-probe';document.body.append(box);
const style=document.createElement('style');
const sheet=value=>'data:text/css,'+encodeURIComponent('#supports-probe { --imported: '+value+'; }');
style.textContent='@import url("'+sheet('grid')+'") supports(display: grid);\n@import url("'+sheet('invalid')+'") supports(display: definitely-not-a-display);\n#supports-probe { --when: fallback; }\n@when supports(display: grid) { #supports-probe { --when: matched; } }';
await new Promise((resolve,reject)=>{const timer=setTimeout(()=>reject(new Error('Stylesheet load timed out')),3000);style.onload=()=>{clearTimeout(timer);resolve()};style.onerror=()=>{clearTimeout(timer);reject(new Error('Stylesheet failed'))};document.head.append(style)});
const value=getComputedStyle(box);
console.log('imported='+value.getPropertyValue('--imported').trim()+'; when='+value.getPropertyValue('--when').trim());
console.log('imports='+[...style.sheet.cssRules].filter(rule=>rule.type===CSSRule.IMPORT_RULE).length+'; when-rules='+[...style.sheet.cssRules].filter(rule=>rule.cssText.startsWith('@when')).length);
console.log('js-declaration='+CSS.supports('display','grid')+'; js-wrapped='+CSS.supports('supports(display: grid)'));
style.remove();box.remove();

Resultado

imported=grid; when=fallback
imports=1; when-rules=0
js-declaration=true; js-wrapped=false

Os URL data contêm apenas as pequenas folhas CSS de teste apresentadas no código. @when continua a ser um contexto em projeto e não estava implementado no Chromium 157 testado; a importação condicional funcional não altera esse resultado.

Fontes