CKTIS / CSS
supports(): условие в CSS с поддръжка според контекста
Разграничете условния импорт на стилове, проектния запис @when, правилото @supports и JavaScript API.
Версия: CSS Modules
Синтаксис
@import url("grid.css") supports(display: grid);supports() е условие за поддръжка на CSS възможност, а не стойност на свойство или JavaScript извикване. В @import supports(display: grid) допуска импортирания стил само ако декларацията се поддържа. Може да се използва и пълно условие supports, включително not или комбинации в скоби. Функцията следва URL адреса и незадължителната клауза layer, преди медийната заявка. Поставяйте импортите преди обикновените стилови правила; невярно условие supports предотвратява изтеглянето и прилагането на този импортиран стил.
CSS Conditional Rules Level 5 определя supports(declaration) и в предложеното правило @when. Този контекст има отделен статус на реализация. Той не може да се извежда от работещи условия @import, утвърденото правило @supports или CSS.supports() в JavaScript. Последният API приема двойка свойство/стойност или низ с условие supports, а не обвивката supports(...), използвана в тези CSS контексти. Условният импорт е определен отделно в CSS Cascade.
Примерът използва локални стилове data и отчита свойство, което действително задават. Поддържаният импорт grid се прилага; умишлено неподдържаната стойност display не го презаписва. В проверения Chromium 157 блокът @when е пропуснат и остава резервната стойност. CSSOM показва едно правило за импорт и нито едно @when. JavaScript тестът за декларация връща true, а обвитият низ — false. Това са изрични наблюдения на различни механизми, не твърдение, че всички контексти supports() работят.
Положителна заявка означава, че браузърът заявява поддръжка; не доказва, че конкретна страница е без грешки, достъпна или визуално правилна. Запазете полезни резервни стилове и тествайте нужното поведение. Локалният пример проверява прилагането на стил, а не реален мрежов трафик, кеширане или наличност на отдалечен стилов файл.
Примери
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();Резултат
imported=grid; when=fallback imports=1; when-rules=0 js-declaration=true; js-wrapped=false
Адресите data съдържат само малките тестови CSS стилове, показани в кода. @when остава проектен контекст и не беше реализиран в проверения Chromium 157; работещият условен импорт не променя този резултат.