CKTIS / CSS
supports(): podmínka CSS s podporou závislou na kontextu
Rozlište podmíněný import stylů, návrh zápisu @when, pravidlo @supports a rozhraní JavaScript.
Verze: CSS Modules
Syntaxe
@import url("grid.css") supports(display: grid);supports() je podmínka podpory CSS, nikoli hodnota vlastnosti nebo volání JavaScriptu. V @import povolí supports(display: grid) importovaný styl pouze při podpoře dané deklarace. Lze použít i úplnou podmínku supports včetně not nebo kombinací v závorkách. Funkce následuje po URL a volitelné klauzuli layer, před případným dotazem na média. Importy pište před běžná pravidla stylů; nepravdivá podmínka supports zabrání načtení a použití tohoto importovaného stylu.
CSS Conditional Rules Level 5 definuje supports(declaration) také uvnitř navrhovaného pravidla @when. Tento kontext má samostatný stav implementace. Nelze jej odvodit z fungujících podmínek @import, zavedeného pravidla @supports ani CSS.supports() v JavaScriptu. Poslední rozhraní přijímá dvojici vlastnost/hodnota nebo řetězec s podmínkou supports, nikoli obal supports(...) používaný v těchto kontextech CSS. Podmíněný import samostatně definuje CSS Cascade.
Příklad používá místní styly data a čte vlastnost, kterou skutečně nastavily. Import s podporovaným grid se uplatní; záměrně nepodporovaná hodnota display jej nepřepíše. V testovaném Chromium 157 je blok @when vynechán a zůstává náhradní hodnota. CSSOM zpřístupní jedno pravidlo importu a žádné @when. Test deklarace v JavaScriptu vrací true, zabalený řetězec false. Jde o výslovná pozorování odlišných mechanismů, ne o tvrzení, že fungují všechny kontexty supports().
Kladný dotaz na funkci znamená, že prohlížeč uvádí podporu; nedokazuje bezchybnost, přístupnost ani správný vzhled konkrétní stránky. Zachovejte užitečné náhradní styly a testujte potřebné chování. Místní příklad ověřuje použití stylu, nikoli skutečný síťový provoz, mezipaměť nebo dostupnost vzdáleného stylu.
Příklady
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();Výsledek
imported=grid; when=fallback imports=1; when-rules=0 js-declaration=true; js-wrapped=false
Adresy data obsahují pouze malé testovací styly zobrazené v kódu. @when zůstává návrhem a testované Chromium 157 jej neimplementovalo; funkční podmíněný import tento výsledek nemění.