Window matchMedia()Methode

Window 对象参考手册Window-Objekt


Definition und Verwendung

matchMedia() gibt ein neues MediaQueryList-Objekt zurück, das das geparste Ergebnis der angegebenen Media-Query-Zeichenfolge darstellt.

Der Wert der matchMedia()-Methode kann eines der Merkmale derCSS-@media-Regelnsein, wie z. B.min-height, min-width, orientationusw.

Das MediaQueryList-Objekt hat die folgenden zwei Eigenschaften:

  • media: der Inhalt der Abfrageanweisung.
  • matches: wird verwendet, um das Abfrageergebnis zu erkennen. Wenn das Dokument mit der Media-Query-Liste übereinstimmt, ist der Wert true; andernfalls false.

MediaQueryListDas Objekt kann auch Ereignisse abhören. Beim Abhören wird, wenn sich das Abfrageergebnis ändert, die angegebene Callback-Funktion aufgerufen.

Methode Beschreibung
addListener(functionref) Fügt eine neue Listener-Funktion hinzu, die ausgeführt wird, wenn sich das Ergebnis der Media-Query ändert.
removeListener(functionref) Entfernt einen zuvor hinzugefügten Listener aus der Media-Query-Liste. Wenn der angegebene Listener nicht in der Liste ist, wird keine Operation ausgeführt.

Syntax

window.matchMedia(mediaQueryString)

Parameter description:

  • mediaQueryString: Erforderlich. Ein String, der die Media Query darstellt, für die ein neues MediaQueryList-Objekt zurückgegeben wird.

Rückgabewert

Gibt ein MediaQueryList-Objekt zurück.

Browser-Unterstützung

Die Zahlen in der Tabelle geben die erste Browserversion an, die die Methode unterstützt.

Methode
matchMedia() 9.0 10.0 6.0 5.1 12.1

Beispiele

Beispiele

Ermitteln Sie die Fenstergröße des Bildschirms (Bildschirm/Viewport):

if (window.matchMedia("(max-width: 700px)").matches) { /*Fenster kleiner oder gleich 700 Pixel*/ } else { /*Fenster größer als 700 Pixel*/ }

Selbst ausprobieren »

Beispiele

Ermitteln Sie die Fenstergröße des Bildschirms (Bildschirm/Viewport). Wenn sie kleiner oder gleich 700 Pixel ist, ändern Sie die Hintergrundfarbe in Gelb; wenn sie größer als 700 Pixel ist, ändern Sie die Hintergrundfarbe in Pink:

function myFunction(x) { if (x.matches) { //Media Query document.body.style.backgroundColor = "yellow"; } else { document.body.style.backgroundColor = "pink"; } } var x = window.matchMedia("(max-width: 700px)") myFunction(x) //Die Listener-Funktion, die beim Ausführen aufgerufen wird x.addListener(myFunction) //Fügen Sie einen Listener hinzu, wenn sich der Zustand ändert

Selbst ausprobieren »

Window 对象参考手册Window-Objekt

Andere Erweiterungen