CKTIS / CSS
supports(): una condición CSS cuya compatibilidad depende del contexto
Distingue una importación condicional, la notación @when propuesta, la regla @supports y la API de JavaScript.
Versión: CSS Modules
Sintaxis
@import url("grid.css") supports(display: grid);supports() es una condición de compatibilidad de CSS, no un valor de propiedad ni una llamada de JavaScript. En @import, supports(display: grid) permite la hoja importada solo si se admite la declaración. También puede utilizarse una condición supports completa, con not o combinaciones entre paréntesis. La función aparece después de la URL y de la cláusula layer opcional, antes de cualquier consulta de medios. Sitúa las importaciones antes de las reglas de estilo ordinarias; una condición supports falsa impide descargar y aplicar esa hoja importada.
CSS Conditional Rules Level 5 también define supports(declaration) dentro de la regla @when propuesta. Ese contexto tiene su propio estado de implementación. No debe deducirse de que funcionen las condiciones de @import, la regla consolidada @supports o CSS.supports() en JavaScript. Esta última acepta un par propiedad/valor o una cadena con una condición supports, no la envoltura supports(...) usada en estos contextos CSS. La sintaxis de importación condicional se define por separado en CSS Cascade.
El ejemplo utiliza hojas data locales y lee una propiedad que realmente establecen. Se aplica la importación grid admitida; el valor display deliberadamente incompatible no la sobrescribe. En el Chromium 157 probado, el bloque @when se omite y se conserva la alternativa. Su CSSOM expone una regla de importación y ninguna regla @when. La comprobación de declaración de JavaScript devuelve true, mientras que la cadena envuelta devuelve false. Son observaciones explícitas de mecanismos distintos, no una afirmación de que funcionen todos los contextos de supports().
Una consulta de característica positiva significa que el navegador declara compatibilidad; no prueba que una página concreta esté libre de errores, sea accesible o visualmente correcta. Mantén estilos alternativos útiles y comprueba el comportamiento necesario. El ejemplo local verifica la aplicación del estilo, no el tráfico real de red, la caché ni la disponibilidad de una hoja remota.
Ejemplos
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();Resultado
imported=grid; when=fallback imports=1; when-rules=0 js-declaration=true; js-wrapped=false
Las URL data contienen únicamente las pequeñas hojas CSS de prueba mostradas en el código. @when sigue siendo un contexto en borrador y no estaba implementado en el Chromium 157 probado; la importación condicional funcional no cambia ese resultado.