Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / CSS

supports(): uvjet CSS-a čija podrška ovisi o kontekstu

Razlikujte uvjetni uvoz stilskog lista, predloženi zapis @when, pravilo @supports i JavaScript API.

Verzija: CSS Modules

Sintaksa

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

supports() je uvjet podrške mogućnosti CSS-a, a ne vrijednost svojstva ili JavaScript poziv. U @import supports(display: grid) dopušta uvezeni stilski list samo ako je deklaracija podržana. Može se koristiti i pun uvjet supports, uključujući not ili kombinacije u zagradama. Funkcija dolazi nakon URL-a i neobvezne klauzule layer, prije medijskog upita. Uvoze stavite ispred običnih stilskih pravila; neistinit uvjet supports sprječava dohvat i primjenu tog uvezenog lista.

CSS Conditional Rules Level 5 definira supports(declaration) i unutar predloženog pravila @when. Taj kontekst ima zaseban status implementacije. Ne smije se zaključivati iz rada uvjeta @import, ustaljenog pravila @supports ili CSS.supports() u JavaScriptu. Posljednji API prihvaća par svojstvo/vrijednost ili niz s uvjetom supports, a ne omotač supports(...) koji se upotrebljava u tim CSS kontekstima. Uvjetni uvoz zasebno definira CSS Cascade.

Primjer koristi lokalne stilske listove data i očitava svojstvo koje stvarno postavljaju. Podržani uvoz grid primjenjuje se; namjerno nepodržana vrijednost display ne prepisuje ga. U testiranom Chromiumu 157 blok @when izostavljen je i ostaje zamjenska vrijednost. CSSOM izlaže jedno pravilo uvoza i nijedno @when. Test deklaracije u JavaScriptu vraća true, a omotani niz false. To su izričita opažanja različitih mehanizama, a ne tvrdnja da svi konteksti supports() rade.

Pozitivan upit znači da preglednik prijavljuje podršku; ne dokazuje da je određena stranica bez pogrešaka, pristupačna ili vizualno ispravna. Zadržite korisne zamjenske stilove i provjerite ponašanje koje trebate. Lokalni primjer provjerava primjenu stila, a ne stvarni mrežni promet, predmemoriju ili dostupnost udaljenog stilskog lista.

Primjeri

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-ovi data sadrže samo male testne CSS listove prikazane u kodu. @when ostaje nacrt i testirani Chromium 157 nije ga implementirao; rad uvjetnog uvoza ne mijenja taj rezultat.

Izvori