KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

window.matchMedia — mediaquery’s testen

window.matchMedia test vanuit JavaScript een CSS-mediaquery. De methode retourneert een MediaQueryList met het huidige resultaat in matches en laat je veranderingen volgen in de vraag of de query overeenkomt.

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

const mql = window.matchMedia(query);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);

window.matchMedia(query) maakt een nieuwe MediaQueryList, geen booleaanse waarde. Lees matches voor het huidige resultaat; media bevat de geserialiseerde query.

Geef een CSS-query door, bijvoorbeeld "(min-width: 768px)", zonder @media. Het mediakenmerk width verwijst bij continue media naar de breedte van het viewport en bij gepagineerde media, zoals afdrukken, naar de breedte van het paginavak (page box). De eenheid px betekent CSS-pixels. Deze query is niet beperkt tot het mediatype screen. De methode test een voorwaarde; zelf past deze geen stijlen toe.

Dit is een browser-API uit CSSOM View, geen ECMAScript-functie. Controleer vóór de aanroep van window.matchMedia(query) of typeof window !== "undefined" && typeof window.matchMedia === "function" geldt; Node 24 alleen bewijst niet dat de API wordt ondersteund. Deze controle zegt niets over de beschikbaarheid van methoden voor eventlisteners op het geretourneerde object.

Lees het eerste resultaat uit mql.matches, waarbij mql de geretourneerde MediaQueryList is. Registreer de handler alleen met mql.addEventListener("change", handler) als typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function" geldt. Ontbreekt een van beide methoden, sla de registratie dan over; je kunt matches nog steeds lezen. De gebeurtenis wordt alleen gemeld als het resultaat verandert, niet bij elke formaatwijziging; event.matches bevat het nieuwe resultaat. Als je de handler hebt geregistreerd, roep dan bij het opruimen mql.removeEventListener("change", handler) aan met dezelfde functie.

Het voorbeeld gebruikt all en de ontkenning daarvan, not all, waardoor de uitvoer onafhankelijk is van de venstergrootte.

Voorbeelden

const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);

Resultaat

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