CKTIS / CSS
supports(): warunek CSS zależny od kontekstu użycia
Odróżnij warunkowy import arkusza, projektowaną składnię @when, regułę @supports oraz interfejs JavaScript.
Wersja: CSS Modules
Składnia
@import url("grid.css") supports(display: grid);supports() jest warunkiem obsługi funkcji CSS, a nie wartością właściwości ani wywołaniem JavaScript. W @import zapis supports(display: grid) dopuszcza importowany arkusz tylko wtedy, gdy deklaracja jest obsługiwana. Można też podać pełny warunek supports, w tym not lub kombinacje w nawiasach. Funkcja występuje po adresie URL i opcjonalnej klauzuli layer, przed zapytaniem o media. Umieszczaj importy przed zwykłymi regułami stylu; fałszywy warunek supports zapobiega pobraniu i zastosowaniu tego arkusza.
CSS Conditional Rules Level 5 definiuje także supports(declaration) w projektowanej regule @when. Ten kontekst ma osobny stan wdrożenia. Nie wolno wywodzić jego obsługi z działających warunków @import, utrwalonej reguły @supports ani CSS.supports() w JavaScript. Ten ostatni interfejs przyjmuje parę właściwość/wartość lub ciąg z warunkiem supports, a nie opakowanie supports(...) używane w tych kontekstach CSS. Składnię importu warunkowego określa osobno CSS Cascade.
Przykład korzysta z lokalnych arkuszy data i odczytuje rzeczywiście ustawioną przez nie właściwość. Import z obsługiwaną deklaracją grid zostaje zastosowany; celowo nieobsługiwana wartość display go nie nadpisuje. W sprawdzonym Chromium 157 blok @when jest pomijany i pozostaje wariant zapasowy. CSSOM pokazuje jedną regułę importu i żadnej reguły @when. Test deklaracji w JavaScript zwraca true, a ciąg z opakowaniem false. To jawne obserwacje różnych mechanizmów, a nie zapewnienie, że działa każdy kontekst supports().
Pozytywne zapytanie o funkcję oznacza deklarowaną przez przeglądarkę obsługę; nie dowodzi, że konkretna strona nie ma błędów, jest dostępna lub wygląda poprawnie. Zachowaj użyteczne style zapasowe i sprawdzaj potrzebne zachowanie. Lokalny przykład potwierdza zastosowanie stylu, a nie rzeczywisty ruch sieciowy, pamięć podręczną czy dostępność zdalnego arkusza.
Przykłady
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();Wynik
imported=grid; when=fallback imports=1; when-rules=0 js-declaration=true; js-wrapped=false
Adresy data zawierają wyłącznie małe arkusze testowe widoczne w kodzie. @when pozostaje kontekstem projektowanym i nie działało w sprawdzonym Chromium 157; działający import warunkowy nie zmienia tego wyniku.