CKTIS / CSS
supports(): eine CSS-Bedingung mit kontextabhängiger Unterstützung
Unterscheiden Sie bedingte Stylesheet-Importe, die geplante @when-Notation, die @supports-Regel und die JavaScript-API.
Version: CSS Modules
Syntax
@import url("grid.css") supports(display: grid);supports() ist eine CSS-Funktionsbedingung, kein Eigenschaftswert und kein JavaScript-Aufruf. In @import lässt supports(display: grid) das importierte Stylesheet nur zu, wenn die Deklaration unterstützt wird. Auch eine vollständige supports-Bedingung ist möglich, etwa mit not oder geklammerten Kombinationen. Die Funktion folgt auf die URL und die optionale layer-Klausel, vor einer Medienabfrage. Importe gehören vor normale Stilregeln; eine falsche supports-Bedingung verhindert das Laden und Anwenden dieses importierten Stylesheets.
CSS Conditional Rules Level 5 definiert außerdem supports(declaration) innerhalb der vorgeschlagenen @when-Regel. Dieser Kontext hat einen eigenen Implementierungsstand. Seine Unterstützung lässt sich weder aus funktionierenden @import-Bedingungen noch aus der etablierten @supports-Regel oder CSS.supports() in JavaScript ableiten. Letzteres akzeptiert ein Eigenschaft/Wert-Paar oder eine Zeichenfolge mit einer supports-Bedingung, nicht die in diesen CSS-Kontexten verwendete Hülle supports(...). Die Syntax bedingter Importe ist separat in CSS Cascade definiert.
Das Beispiel verwendet lokale data-Stylesheets und liest eine von ihnen tatsächlich gesetzte Eigenschaft. Der unterstützte grid-Import wird angewendet; der absichtlich nicht unterstützte display-Wert überschreibt ihn nicht. Im geprüften Chromium 157 wird der @when-Block ausgelassen, sodass die Rückfalllösung bestehen bleibt. Sein CSSOM zeigt eine Importregel und keine @when-Regel. Der JavaScript-Deklarationstest ergibt true, die umhüllte Zeichenfolge dagegen false. Dies sind ausdrückliche Beobachtungen verschiedener Mechanismen, keine Zusage, dass alle supports()-Kontexte funktionieren.
Eine positive Funktionsabfrage bedeutet, dass der Browser Unterstützung meldet; sie beweist nicht, dass eine bestimmte Seite fehlerfrei, barrierefrei oder visuell korrekt ist. Behalten Sie brauchbare Rückfallstile und prüfen Sie das benötigte Verhalten. Das lokale Beispiel bestätigt die Anwendung eines Stils, nicht echten Netzwerkverkehr, Zwischenspeicherung oder die Verfügbarkeit eines entfernten Stylesheets.
Beispiele
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();Ergebnis
imported=grid; when=fallback imports=1; when-rules=0 js-declaration=true; js-wrapped=false
Die data-URLs enthalten ausschließlich die kleinen CSS-Testdaten aus dem Code. @when bleibt ein Entwurfskontext und war im geprüften Chromium 157 nicht implementiert; der funktionierende bedingte Import ändert dieses Ergebnis nicht.