MediaQueryList: removeListener() メソッド

Deprecated

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

removeListener() は MediaQueryList インターフェイスのメソッドで、 MediaQueryListener からリスナーを除去します。

古いブラウザーでは、 MediaQueryList はまだ EventTarget を継承していなかったため、このメソッドは EventTarget.removeEventListener() の別名として提供されました。対応する必要があるブラウザーで利用できる場合は、 removeListener() の代わりに removeEventListener() を使用してください。

構文

removeListener(func)

引数

func: 除去したいコールバック関数を表す関数または関数への参照。

返値

なし (undefined)。

例

const paragraph = document.querySelector("p");
const mediaQueryList = window.matchMedia("(max-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);

// Later on, when it is no longer needed
mediaQueryList.removeListener(screenTest);