Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

MediaQueryList: addListener()-Methode

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

Die veraltete addListener()-Methode des MediaQueryList-Interfaces fügt einen Listener hinzu zum MediaQueryListener, der eine benutzerdefinierte Callback-Funktion ausführt, wenn sich der Status der Media Query ändert.

In älteren Browsern hat MediaQueryList noch nicht von EventTarget geerbt, daher wurde diese Methode als Alias von EventTarget.addEventListener() bereitgestellt. Verwenden Sie addEventListener() anstelle von addListener(), sofern es in den von Ihnen unterstützten Browsern verfügbar ist.

Syntax

js
addListener(func)

Parameter

func

Eine Funktion oder Funktionsreferenz, die die Callback-Funktion darstellt, die Sie ausführen möchten, wenn sich der Status der Media Query ändert.

Rückgabewert

Keiner (undefined).

Beispiele

js
const paragraph = document.querySelector("p");
const mediaQueryList = window.matchMedia("(width <= 600px)");

function screenTest(e) {
  if (e.matches) {
    /* the viewport is 600 pixels wide or less */
    paragraph.textContent = "This is a narrow screen — 600px wide or less.";
    document.body.style.backgroundColor = "pink";
  } else {
    /* the viewport is more than 600 pixels wide */
    paragraph.textContent = "This is a wide screen — more than 600px wide.";
    document.body.style.backgroundColor = "aquamarine";
  }
}

mediaQueryList.addListener(screenTest);

Spezifikationen

Spezifikation
CSSOM View Module
# dom-mediaquerylist-addlistener

Browser-Kompatibilität

Siehe auch