MediaQueryListEvent

Baseline Widely available

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

MediaQueryListEvent オブジェクトは、 MediaQueryList オブジェクトに対して起こった変更に関する情報を格納します。インスタンスは change イベントによって参照される関数のイベントオブジェクトとして利用できます。

Event MediaQueryListEvent

コンストラクター

MediaQueryListEvent()

新しい MediaQueryListEvent インスタンスを生成します。

インスタンスプロパティ

MediaQueryListEvent インターフェイスには、親インターフェイスである Event から継承したプロパティがあります。

MediaQueryListEvent.matches 読取専用

論理値です。 document が現在メディアクエリーのリストに一致していれば true を返し、そうでなければ false を返します。

MediaQueryListEvent.media 読取専用

文字列で、シリアライズされたメディアクエリーを表します。

インスタンスメソッド

MediaQueryListEvent インターフェイスには、親インターフェイスである Event から継承したメソッドがあります。

例

js
const para = document.querySelector("p"); // This is the UI element where to display the text
const mql = window.matchMedia("(max-width: 600px)");

mql.addEventListener("change", (event) => {
  if (event.matches) {
    // The viewport is 600 pixels wide or less
    para.textContent = "This is a narrow screen — less than 600px wide.";
    document.body.style.backgroundColor = "red";
  } else {
    // The viewport is more than 600 pixels wide
    para.textContent = "This is a wide screen — more than 600px wide.";
    document.body.style.backgroundColor = "blue";
  }
});