MediaQueryListEvent

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年9月以降、すべてのブラウザーで利用可能です。

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

コンストラクター

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

インスタンスプロパティ

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

MediaQueryListEvent.matches 読取専用: 論理値です。 document が現在メディアクエリーのリストに一致していれば true を返し、そうでなければ false を返します。
MediaQueryListEvent.media 読取専用: 文字列で、シリアライズされたメディアクエリーを表します。

インスタンスメソッド

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

例

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";
  }
});