KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

CSS.supports() — ondersteuning voor CSS-functies detecteren

CSS.supports() controleert of de browser ondersteuning meldt voor een specifieke eigenschap-waardepaar of een voorwaarde voor een CSS-functiequery. De methode geeft een boolean terug en helpt fallbacks te kiezen zonder de browser aan de hand van zijn naam te herkennen.

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

Syntax

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

CSS.supports() is een operatie van de Web IDL-naamruimte CSS. Je roept de operatie rechtstreeks op CSS aan, zonder een instantie te maken. Het is een browser-Web-API, geen functie die door ECMAScript is gedefinieerd; alleen het gebruik van Node 24 bewijst niet dat de methode beschikbaar is. Net als in het voorbeeld kun je vóór het aanroepen controleren of CSS en de methode bestaan.

De vorm CSS.supports(propertyName, value) accepteert twee tekenreeksen: een CSS-eigenschapsnaam, zoals "background-color" in plaats van "backgroundColor", en de waarde die wordt getest. De methode geeft true of false terug. Test de specifieke waarde, want ondersteuning voor een eigenschap betekent niet dat al haar waarden worden ondersteund.

De vorm CSS.supports(supportCondition) accepteert een voorwaarde zoals een @supports-voorwaarde, maar zonder @supports zelf of een regelblok. Een voorbeeld is "(color: red)"; voorwaarden kunnen worden gecombineerd met and, or en not. CSS.supports() geeft alleen een resultaat terug en past geen stijlen toe. Als conditionele stijlen geen JavaScript nodig hebben, kun je @supports rechtstreeks in CSS gebruiken.

Een positief resultaat betekent dat ondersteuning voor de geteste syntaxis wordt gemeld, niet dat de weergave correct is of dat er geen fouten of gedeeltelijke implementaties zijn. Behoud basisstijlen en voeg verbeteringen voorwaardelijk toe. Dat de methode beschikbaar is, garandeert niet dat elke geteste functie wordt ondersteund.

Voorbeelden

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"));
}

Resultaat

true
true
false

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen