CKTIS / JavaScript
Window.matchMedia en MediaQueryList.matches
Controleer in JavaScript of een CSS-mediaquery op dit moment geldt en reageer alleen als de uitkomst verandert.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;window.matchMedia(query) ontvangt een CSS-mediaquery als tekenreeks en geeft bij elke aanroep een nieuw MediaQueryList-object terug, geen booleaanse waarde. Geef alleen de query door, zonder @media of een regelblok. Zet voorwaarden voor mediakenmerken tussen haakjes: (max-width: 600px) test of de viewport maximaal 600 CSS-pixels breed is, inclusief de grenswaarde.
Lees list.matches zonder haakjes. Het is een alleen-lezen booleaanse eigenschap: true als de lijst met mediaquery’s leeg is of als het document op dat moment voldoet aan minstens één query in de kommagescheiden lijst, en anders false. false wijst niet op een syntaxisfout. Lees je dezelfde eigenschap opnieuw op hetzelfde object, dan krijg je de actuele uitkomst; een eerder opgeslagen booleaanse waarde verandert niet vanzelf.
Lees list.matches als je de begintoestand nodig hebt en gebruik daarna list.addEventListener("change", handler) om wijzigingen te volgen. Het event treedt op wanneer de uitkomst omslaat van true naar false of omgekeerd, niet bij elke formaatwijziging. De nieuwe uitkomst staat in event.matches. Stop met luisteren via list.removeEventListener("change", handler) met dezelfde functie.
Dit is een browser-API en geen onderdeel van ECMAScript 2024. Ga er niet van uit dat de API buiten een browservenster beschikbaar is. Wil je alleen stijlen aanpassen, gebruik dan CSS @media: matchMedia() past zelf geen stijlen toe.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>matchMedia example</title>
</head>
<body>
<script>
console.log(window.matchMedia("all").matches);
console.log(window.matchMedia("not all").matches);
</script>
</body>
</html>Resultaat
true false
Open het HTML-bestand in een browser en bekijk de uitvoer in de browserconsole. `all` komt overeen met elk medium en `not all` met geen enkel medium. Je ziet dus eerst `true` en daarna `false`, ongeacht de breedte van de viewport.
Gerelateerde lessen
- JavaScript · Les 3 · Gevorderd · Versie: 4
- JavaScript · Les 6 · Gevorderd · Versie: 4
- JavaScript · Les 7 · Gevorderd · Versie: 4
- JavaScript · Les 19 · Gevorderd · Versie: 4
- JavaScript · Les 41 · Gemiddeld · Versie: 3
- JavaScript · Les 42 · Gemiddeld · Versie: 3
- JavaScript · Les 43 · Gemiddeld · Versie: 3