Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

CSS.supports() — zjišťování podpory funkcí CSS

CSS.supports() ověřuje, zda prohlížeč uvádí podporu konkrétní dvojice vlastnost–hodnota nebo podmínky dotazu na funkce CSS. Vrací logickou hodnotu a pomáhá vybírat náhradní řešení bez rozpoznávání prohlížeče podle názvu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

CSS.supports(propertyName, value)
CSS.supports(supportCondition)

CSS.supports() je operace jmenného prostoru CSS ve Web IDL. Volá se přímo na CSS, bez vytvoření instance. Jde o webové API prohlížeče, nikoli o funkci definovanou standardem ECMAScript; samotné použití Node 24 nedokazuje, že je dostupná. Před zavoláním můžete ověřit, zda existují CSS i tato metoda, jak ukazuje příklad.

Varianta CSS.supports(propertyName, value) přijímá dva řetězce: název vlastnosti CSS, například "background-color" místo "backgroundColor", a testovanou hodnotu. Vrací true nebo false. Testujte konkrétní hodnotu, protože podpora vlastnosti neznamená podporu všech jejích hodnot.

Varianta CSS.supports(supportCondition) přijímá podmínku podobnou podmínce @supports, ale bez samotného @supports a bloku pravidel. Příkladem je "(color: red)"; podmínky lze kombinovat pomocí and, or a not. CSS.supports() pouze vrací výsledek — styly nepoužije. Pokud podmíněné stylování nevyžaduje JavaScript, můžete použít @supports přímo v CSS.

Kladný výsledek znamená deklarovanou podporu testované syntaxe, nikoli záruku správného vzhledu nebo nepřítomnosti chyb či částečných implementací. Zachovejte základní styly a vylepšení přidávejte podmíněně. Dostupnost samotné metody nezaručuje podporu každé testované funkce.

Příklady

if (typeof CSS === "undefined" || typeof CSS.supports !== "function") {
  console.log("CSS.supports unavailable");
} else {
  console.log(CSS.supports("color", "red"));
  console.log(CSS.supports("(color: red)"));
  console.log(CSS.supports("color", "not-a-color"));
}

Výsledek

true
true
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje