CKTIS / CSS
supports() : une condition CSS dont la prise en charge dépend du contexte
Distinguez l’importation conditionnelle, la notation @when en projet, la règle @supports et l’API JavaScript.
Version : CSS Modules
Syntaxe
@import url("grid.css") supports(display: grid);supports() est une condition de fonctionnalité CSS, ni une valeur de propriété ni un appel JavaScript. Dans @import, supports(display: grid) autorise la feuille importée uniquement si la déclaration est prise en charge. Une condition supports complète est également possible, notamment avec not ou des combinaisons entre parenthèses. La fonction suit l’URL et la clause layer facultative, avant toute requête média. Placez les importations avant les règles de style ordinaires ; une condition supports fausse empêche le chargement et l’application de cette feuille importée.
CSS Conditional Rules Level 5 définit aussi supports(declaration) dans la règle @when proposée. Ce contexte possède son propre état d’implémentation. Il ne faut pas le déduire du fonctionnement des conditions @import, de la règle établie @supports ou de CSS.supports() en JavaScript. Cette dernière API accepte un couple propriété/valeur ou une chaîne de condition supports, pas l’enveloppe supports(...) employée dans ces contextes CSS. La syntaxe d’importation conditionnelle est définie séparément dans CSS Cascade.
L’exemple emploie des feuilles data locales et lit une propriété qu’elles définissent réellement. L’importation grid prise en charge s’applique ; la valeur display volontairement inconnue ne la remplace pas. Dans Chromium 157 testé, le bloc @when est omis et la solution de repli reste active. Son CSSOM expose une règle d’importation et aucune règle @when. Le test de déclaration JavaScript renvoie true, tandis que la chaîne enveloppée renvoie false. Ce sont des observations explicites de mécanismes distincts, pas une affirmation que tous les contextes supports() fonctionnent.
Une requête de fonctionnalité positive signifie que le navigateur annonce sa prise en charge ; elle ne prouve pas qu’une page précise soit sans bug, accessible ou visuellement correcte. Conservez des styles de repli utiles et testez le comportement nécessaire. L’exemple local vérifie l’application du style, pas le trafic réseau réel, le cache ou la disponibilité d’une feuille distante.
Exemples
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();Résultat
imported=grid; when=fallback imports=1; when-rules=0 js-declaration=true; js-wrapped=false
Les URL data ne contiennent que les petites feuilles CSS de test visibles dans le code. @when reste un contexte en projet et n’était pas implémenté dans Chromium 157 testé ; l’importation conditionnelle fonctionnelle ne change pas ce résultat.