CKTIS / CSS
supports(): pogoj CSS s podporo, odvisno od konteksta
Ločite pogojni uvoz slogovne datoteke, predlagani zapis @when, pravilo @supports in vmesnik JavaScript.
Različica: CSS Modules
Sintaksa
@import url("grid.css") supports(display: grid);supports() je pogoj podpore zmožnosti CSS, ne vrednost lastnosti ali klic JavaScript. V @import supports(display: grid) dovoli uvoženo slogovno datoteko le, kadar je deklaracija podprta. Dovoljen je tudi celoten pogoj supports, vključno z not ali kombinacijami v oklepajih. Funkcija sledi URL-ju in neobvezni določbi layer, pred morebitno medijsko poizvedbo. Uvoze postavite pred običajna slogovna pravila; neresničen pogoj supports prepreči prenos in uporabo te uvožene datoteke.
CSS Conditional Rules Level 5 določa supports(declaration) tudi znotraj predlaganega pravila @when. Ta kontekst ima ločeno stanje implementacije. Ne sklepajte o njem iz delujočih pogojev @import, uveljavljenega pravila @supports ali CSS.supports() v JavaScriptu. Slednji sprejema par lastnost/vrednost ali niz s pogojem supports, ne ovoja supports(...), uporabljenega v teh kontekstih CSS. Pogojni uvoz posebej določa CSS Cascade.
Primer uporablja lokalne slogovne datoteke data in odčita lastnost, ki jo dejansko nastavijo. Podprti uvoz grid se uporabi; namerno nepodprta vrednost display ga ne prepiše. V preverjenem Chromium 157 se blok @when izpusti in ostane nadomestna vrednost. CSSOM pokaže eno pravilo uvoza in nobenega @when. Preizkus deklaracije v JavaScriptu vrne true, niz z ovojem pa false. To so izrecna opažanja različnih mehanizmov, ne trditev, da delujejo vsi konteksti supports().
Pozitivna poizvedba pomeni, da brskalnik poroča o podpori; ne dokazuje, da je določena stran brez napak, dostopna ali vizualno pravilna. Ohranite uporabne nadomestne sloge in preizkusite potrebno vedenje. Lokalni primer preverja uporabo sloga, ne dejanskega omrežnega prometa, predpomnilnika ali razpoložljivosti oddaljene datoteke.
Primeri
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();Rezultat
imported=grid; when=fallback imports=1; when-rules=0 js-declaration=true; js-wrapped=false
URL-ji data vsebujejo samo majhne testne sloge, prikazane v kodi. @when ostaja predlagan kontekst in ga preverjeni Chromium 157 ni implementiral; delujoči pogojni uvoz tega rezultata ne spremeni.