CKTIS / JavaScript
Window.CSS.supports — zjišťování podpory funkcí CSS
V JavaScriptu ověřte, zda prohlížeč podporuje konkrétní dvojici vlastnosti a hodnoty CSS nebo splňuje podmínku podpory CSS, než zapnete rozšířené chování.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
window.CSS.supports(propertyName, value)
window.CSS.supports(supportCondition)Window.CSS.supports označuje metodu supports jmenného prostoru CSS v okně prohlížeče. V kódu stránky volejte window.CSS.supports() nebo použijte CSS.supports(), pokud globální název CSS nic nezastiňuje. Jde o webové API, nikoli o součást ECMAScriptu 2024 ani o statickou metodu konstruktoru Window.
Při volání se dvěma argumenty předejte název vlastnosti CSS a její hodnotu jako samostatné řetězce, například CSS.supports("font-size", "1rem"). Použijte zápis z CSS (font-size, nikoli fontSize). Při volání s jedním argumentem předejte jen podmínku bez @supports, například "(font-size: 1rem)" nebo "selector(:has(a))". Uvnitř řetězce kombinujte podmínky klíčovými slovy CSS and, or a not, nikoli operátory JavaScriptu &&, || a !.
true znamená, že v daném prohlížeči test podpory prošel. Nepodporovaná dvojice nebo nesprávně zapsaná podmínka vrátí false. Metoda nepoužije žádné styly ani neověřuje, zda selektor odpovídá některému prvku. Ani true nezaručuje bezchybné vykreslení.
Mimo stránky prohlížeče, například ve workeru nebo na serveru, s tímto API automaticky nepočítejte. Před voláním můžete ověřit typeof globalThis.CSS?.supports === "function". Chybějící metoda není totéž co výsledek false, ale v obou případech lze použít stejnou náhradní variantu. Pokud podmínka ovládá pouze styly, použijte pravidlo @supports přímo v CSS.
Příklady
<!doctype html>
<meta charset="utf-8">
<title>CSS.supports example</title>
<script>
console.log(window.CSS.supports("color", "red"));
console.log(window.CSS.supports("color", "123px"));
console.log(window.CSS.supports("(color: red) and (color: blue)"));
</script>Výsledek
true false true
V konzoli stránky prohlížeče, který tuto metodu zpřístupňuje, očekávejte postupně `true`, `false` a `true`. Poslední podmínka ověřuje podporu obou deklarací, nikoli to, zda se obě barvy použijí současně.
Související lekce
- JavaScript · Lekce 37 · Pokročilá · Verze: 4