KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Window.CSS.supports — ondersteuning van CSS-functies testen

Test in JavaScript of de browser een specifiek paar van een CSS-eigenschap en waarde ondersteunt of aan een CSS-ondersteuningsvoorwaarde voldoet voordat je uitgebreid gedrag inschakelt.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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

Window.CSS.supports verwijst naar de methode supports in de naamruimte CSS van het browservenster. Roep in de paginacode window.CSS.supports() aan, of gebruik CSS.supports() als niets de globale naam CSS overschaduwt. Het is een web-API, geen onderdeel van ECMAScript 2024 en geen statische methode van de constructor Window.

Geef bij twee argumenten de CSS-eigenschapsnaam en de waarde op als afzonderlijke tekenreeksen, bijvoorbeeld CSS.supports("font-size", "1rem"). Gebruik de CSS-schrijfwijze (font-size, niet fontSize). Geef bij één argument alleen de voorwaarde op, zonder @supports, bijvoorbeeld "(font-size: 1rem)" of "selector(:has(a))". Combineer voorwaarden in de tekenreeks met de CSS-sleutelwoorden and, or en not, niet met de JavaScript-operatoren &&, || en !.

true betekent dat de ondersteuningstest in die browser slaagt. Een niet-ondersteund paar of een onjuist opgebouwde voorwaarde levert false op. De methode past geen stijlen toe en controleert niet of een selector op een element van toepassing is. Zelfs true garandeert geen foutloze weergave.

Ga er niet van uit dat deze API buiten een browserpagina bestaat, bijvoorbeeld in een worker of op een server. Vóór de aanroep kun je typeof globalThis.CSS?.supports === "function" controleren. Een ontbrekende methode en de uitkomst false zijn verschillende gevallen, maar je kunt voor beide dezelfde terugvaloptie gebruiken. Als de voorwaarde alleen stijlen bepaalt, gebruik dan de at-regel @supports rechtstreeks in CSS.

Voorbeelden

<!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>

Resultaat

true
false
true

Verwacht in de console van een browserpagina die de methode aanbiedt achtereenvolgens `true`, `false` en `true`. De laatste voorwaarde test of beide declaraties ondersteund worden, niet of beide kleuren tegelijk worden toegepast.

Gerelateerde lessen

  • JavaScript · Les 37 · Gevorderd · Versie: 4

Bronnen