KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

supports(): een CSS-voorwaarde met ondersteuning per context

Onderscheid een voorwaardelijke stylesheetimport, de voorgestelde @when-notatie, de @supports-regel en de JavaScript-API.

Versie: CSS Modules

Syntax

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

supports() is een CSS-functievoorwaarde, geen eigenschapswaarde of JavaScript-aanroep. In @import staat supports(display: grid) de geïmporteerde stylesheet alleen toe als de declaratie wordt ondersteund. Ook een volledige supports-voorwaarde is mogelijk, met not of combinaties tussen haakjes. De functie volgt op de URL en de optionele layer-clausule, vóór een eventuele mediaquery. Plaats imports vóór gewone stijlregels; een onware supports-voorwaarde voorkomt het ophalen en toepassen van die geïmporteerde stylesheet.

CSS Conditional Rules Level 5 definieert ook supports(declaration) in de voorgestelde @when-regel. Die context heeft een eigen implementatiestatus. Leid die niet af uit werkende @import-voorwaarden, de gevestigde @supports-regel of CSS.supports() in JavaScript. De laatste API accepteert een eigenschap/waarde-paar of een tekenreeks met een supports-voorwaarde, niet de supports(...)-omsluiting uit deze CSS-contexten. De syntaxis van voorwaardelijke imports staat afzonderlijk in CSS Cascade.

Het voorbeeld gebruikt lokale data-stylesheets en leest een eigenschap die ze daadwerkelijk instellen. De ondersteunde grid-import wordt toegepast; de opzettelijk niet-ondersteunde display-waarde overschrijft die niet. In het geteste Chromium 157 wordt het @when-blok overgeslagen en blijft de terugvalwaarde staan. Het CSSOM toont één importregel en geen @when-regel. De JavaScript-declaratietest geeft true terug, terwijl de omsloten tekenreeks false geeft. Dit zijn expliciete waarnemingen van verschillende mechanismen, geen bewering dat alle supports()-contexten werken.

Een positieve functietest betekent dat de browser ondersteuning meldt; het bewijst niet dat een bepaalde pagina foutloos, toegankelijk of visueel correct is. Behoud bruikbare terugvalstijlen en test het benodigde gedrag. Het lokale voorbeeld controleert het toepassen van stijlen, niet werkelijk netwerkverkeer, caching of de beschikbaarheid van een externe stylesheet.

Voorbeelden

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();

Resultaat

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

De data-URL’s bevatten alleen de kleine CSS-testbladen die in de code staan. @when blijft een conceptcontext en was niet geïmplementeerd in het geteste Chromium 157; de werkende voorwaardelijke import verandert dat resultaat niet.

Bronnen