Window matchMedia()Methode
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):
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:
Selbst ausprobieren »
Andere Erweiterungen
Window-Objekt