MediaQueryList: change-Event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Das change-Event des MediaQueryList-Interfaces wird ausgelöst, wenn sich der Status der Unterstützung für Medienabfragen ändert.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("change", (event) => { })

onchange = (event) => { }

Ereignistyp

Ein MediaQueryListEvent. Erbt von Event.

Event MediaQueryListEvent

Ereigniseigenschaften

Das MediaQueryListEvent-Interface erbt Eigenschaften von seinem übergeordneten Interface, Event.

MediaQueryListEvent.matches Schreibgeschützt

Ein boolescher Wert, der true ist, wenn das document aktuell der Medienabfrageliste entspricht, oder false, wenn nicht.

MediaQueryListEvent.media Schreibgeschützt

Ein String, der eine serialisierte Medienabfrage darstellt.

Beispiel

js
const mql = window.matchMedia("(width <= 600px)");

mql.onchange = (e) => {
  if (e.matches) {
    /* the viewport is 600 pixels wide or less */
    console.log("This is a narrow screen — less than 600px wide.");
  } else {
    /* the viewport is more than 600 pixels wide */
    console.log("This is a wide screen — more than 600px wide.");
  }
};

Spezifikationen

Specification
CSSOM View Module
# dom-mediaquerylist-onchange

Browser-Kompatibilität

Siehe auch