Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

@supports — warunkowe stosowanie reguł CSS

Reguła @supports włącza zagnieżdżone style tylko wtedy, gdy silnik spełnia podany warunek obsługi.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

@supports <supports-condition> { <block-contents> }

@supports ocenia warunek obsługi przed udziałem zawartości bloku w kaskadzie. Test deklaracji (display: grid) jest prawdziwy, gdy silnik akceptuje parę właściwość–wartość, a selector(...) sprawdza obsługę składni selektora. Warunki można negować i łączyć operatorami not, and oraz or; operatorów and i or nie wolno mieszać na jednym poziomie bez nawiasów.

Przykład ustawia wartości bazowe --display-check i --selector-check. Prawdziwy test siatki zmienia pierwszą z nich na yes, natomiast celowo nieznany selektor nie aktywuje drugiej gałęzi, więc pozostaje no. Odczyt CSSOM oraz wartości obliczonych pokazuje skutek warunku w kaskadzie, a nie tylko wynik pomocniczego API.

Test poprawnej składni nie dowodzi, że funkcja działa odpowiednio we wszystkich przypadkach ani że wynik jest dostępny. Szczególnie deklaracja właściwości niestandardowej przyjmuje niemal dowolny strumień tokenów, dlatego nie jest wiarygodnym testem konkretnej funkcji. Nieznany lub niepoprawny warunek daje wynik fałszywy i blok nie wpływa na styl.

Przykłady

const style = document.createElement('style');
style.textContent = `.probe { --display-check: no; --selector-check: no; }
@supports (display: grid) { .probe { --display-check: yes; } }
@supports selector(:definitely-unknown) { .probe { --selector-check: yes; } }`;
document.head.append(style);
const probe = document.createElement('div');
probe.className = 'probe';
document.body.append(probe);
const computed = getComputedStyle(probe);
const trueRule = style.sheet.cssRules[1];
const falseRule = style.sheet.cssRules[2];
console.log('true=' + trueRule.conditionText + ':' + computed.getPropertyValue('--display-check').trim() + '; false=' + falseRule.conditionText + ':' + computed.getPropertyValue('--selector-check').trim());

Wynik

true=(display: grid):yes; false=selector(:definitely-unknown):no

Reguła @supports włącza zagnieżdżone style tylko wtedy, gdy silnik spełnia podany warunek obsługi.

Źródła