CKTIS / CSS
supports(): una condizione CSS con supporto dipendente dal contesto
Distingui l’importazione condizionale, la notazione @when proposta, la regola @supports e l’API JavaScript.
Versione: CSS Modules
Sintassi
@import url("grid.css") supports(display: grid);supports() è una condizione di supporto CSS, non un valore di proprietà né una chiamata JavaScript. In @import, supports(display: grid) consente il foglio importato soltanto se la dichiarazione è supportata. È possibile usare anche una condizione supports completa, con not o combinazioni tra parentesi. La funzione segue l’URL e l’eventuale clausola layer, prima di qualsiasi media query. Mantieni le importazioni prima delle normali regole di stile; una condizione supports falsa impedisce il recupero e l’applicazione di quel foglio importato.
CSS Conditional Rules Level 5 definisce inoltre supports(declaration) all’interno della regola @when proposta. Questo contesto ha uno stato di implementazione distinto. Non va dedotto dal funzionamento delle condizioni @import, dalla regola consolidata @supports o da CSS.supports() in JavaScript. Quest’ultima API accetta una coppia proprietà/valore o una stringa con una condizione supports, non l’involucro supports(...) usato in questi contesti CSS. La sintassi dell’importazione condizionale è definita separatamente in CSS Cascade.
L’esempio usa fogli data locali e legge una proprietà che impostano realmente. Viene applicata l’importazione grid supportata; il valore display volutamente non supportato non la sovrascrive. Nel Chromium 157 verificato, il blocco @when viene omesso e resta l’alternativa. Il suo CSSOM espone una regola di importazione e nessuna regola @when. Il test della dichiarazione JavaScript restituisce true, mentre la stringa avvolta restituisce false. Sono osservazioni esplicite di meccanismi distinti, non una promessa che funzionino tutti i contesti supports().
Una query positiva su una funzionalità significa che il browser ne dichiara il supporto; non dimostra che una determinata pagina sia priva di errori, accessibile o visivamente corretta. Conserva stili alternativi utili e verifica il comportamento necessario. L’esempio locale controlla l’applicazione dello stile, non il traffico di rete reale, la cache o la disponibilità di un foglio remoto.
Esempi
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();Risultato
imported=grid; when=fallback imports=1; when-rules=0 js-declaration=true; js-wrapped=false
Gli URL data contengono soltanto i piccoli fogli CSS di prova mostrati nel codice. @when resta un contesto in bozza e non era implementato nel Chromium 157 verificato; l’importazione condizionale funzionante non cambia tale risultato.