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