Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / CSS

supports(): podmienka CSS s podporou závislou od kontextu

Rozlíšte podmienený import štýlov, navrhovaný zápis @when, pravidlo @supports a rozhranie JavaScript.

Verzia: CSS Modules

Syntax

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

supports() je podmienka podpory CSS, nie hodnota vlastnosti ani volanie JavaScriptu. V @import povolí supports(display: grid) importovaný štýl len pri podpore deklarácie. Možno použiť aj úplnú podmienku supports vrátane not alebo kombinácií v zátvorkách. Funkcia nasleduje po URL a voliteľnej klauzule layer, pred prípadným dotazom na médiá. Importy uvádzajte pred bežnými pravidlami štýlov; nepravdivá podmienka supports zabráni načítaniu a použitiu tohto importovaného štýlu.

CSS Conditional Rules Level 5 definuje supports(declaration) aj v navrhovanom pravidle @when. Tento kontext má osobitný stav implementácie. Nemožno ho odvodiť z fungujúcich podmienok @import, zavedeného pravidla @supports ani CSS.supports() v JavaScripte. Posledné rozhranie prijíma dvojicu vlastnosť/hodnota alebo reťazec s podmienkou supports, nie obal supports(...) používaný v týchto kontextoch CSS. Podmienený import osobitne definuje CSS Cascade.

Príklad používa miestne štýly data a číta vlastnosť, ktorú skutočne nastavili. Import s podporovaným grid sa uplatní; zámerne nepodporovaná hodnota display ho neprepíše. V testovanom Chromium 157 sa blok @when vynechá a zostáva náhradná hodnota. CSSOM sprístupní jedno pravidlo importu a žiadne @when. Test deklarácie v JavaScripte vracia true, zabalený reťazec false. Sú to výslovné pozorovania rôznych mechanizmov, nie tvrdenie, že fungujú všetky kontexty supports().

Kladný dotaz na funkciu znamená, že prehliadač uvádza podporu; nedokazuje bezchybnosť, prístupnosť ani správny vzhľad konkrétnej stránky. Zachovajte užitočné náhradné štýly a testujte potrebné správanie. Miestny príklad overuje použitie štýlu, nie skutočnú sieťovú prevádzku, vyrovnávaciu pamäť alebo dostupnosť vzdialeného štýlu.

Prí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ýsledok

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

Adresy data obsahujú iba malé testovacie štýly zobrazené v kóde. @when zostáva návrhom a testované Chromium 157 ho neimplementovalo; funkčný podmienený import tento výsledok nemení.

Zdroje