CKTIS / JavaScript
Window.matchMedia und MediaQueryList.matches
Prüfe in JavaScript, ob eine CSS-Medienabfrage gerade zutrifft, und reagiere nur, wenn sich das Ergebnis ändert.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;window.matchMedia(query) nimmt eine CSS-Medienabfrage als Zeichenkette entgegen und liefert bei jedem Aufruf ein neues MediaQueryList-Objekt, keinen booleschen Wert. Übergib nur die Abfrage, ohne @media und ohne Regelblock. Setze Bedingungen für Medienmerkmale in Klammern: (max-width: 600px) prüft, ob der Viewport höchstens 600 CSS-Pixel breit ist, einschließlich des Grenzwerts.
Lies list.matches ohne Klammern. Die Eigenschaft ist schreibgeschützt und liefert true, wenn die Liste der Medienabfragen leer ist oder wenn gerade mindestens eine Abfrage der kommagetrennten Liste auf das Dokument zutrifft, andernfalls false. false zeigt keinen Syntaxfehler an. Beim erneuten Lesen desselben Objekts erhältst du das aktuelle Ergebnis; ein zuvor gespeicherter boolescher Wert aktualisiert sich nicht von selbst.
Wenn du den Anfangszustand brauchst, lies list.matches und verwende anschließend list.addEventListener("change", handler) für spätere Änderungen. Das Ereignis wird beim Wechsel zwischen true und false ausgelöst, nicht bei jeder Größenänderung. Das neue Ergebnis steht in event.matches. Beende die Überwachung mit list.removeEventListener("change", handler) und derselben Funktion.
Dies ist eine Browser-API und kein Bestandteil von ECMAScript 2024. Setze nicht voraus, dass sie außerhalb eines Browserfensters zur Verfügung steht. Geht es nur um Darstellungsregeln, verwende CSS @media: matchMedia() wendet selbst keine Stile an.
Beispiele
<!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>Ergebnis
true false
Öffne die HTML-Datei im Browser und prüfe die Ausgabe in der Browserkonsole. `all` trifft auf jedes Medium zu und `not all` auf keines. Deshalb erscheint unabhängig von der Viewportbreite zuerst `true` und dann `false`.
Zugehörige Lektionen
- JavaScript · Lektion 3 · Fortgeschritten · Version: 4
- JavaScript · Lektion 6 · Fortgeschritten · Version: 4
- JavaScript · Lektion 7 · Fortgeschritten · Version: 4
- JavaScript · Lektion 19 · Fortgeschritten · Version: 4
- JavaScript · Lektion 41 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 42 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 43 · Mittlere Stufe · Version: 3