MediaQueryListEvent

Baseline Widely available

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

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

仕様書

Specification
CSSOM View Module
# the-mediaquerylist-interface

ブラウザーの互換性

BCD tables only load in the browser

関連情報