Window matchMedia()メソッド

Window 对象参考手册Window オブジェクト


定義と用法

matchMedia() は、指定されたメディアクエリ文字列を解析した結果を表す新しい MediaQueryList オブジェクトを返します。

matchMedia() メソッドの値は、任意のCSS @media ルールの特性、例えばmin-height, min-width, orientationなど。

MediaQueryList オブジェクトには次の2つのプロパティがあります。

  • media:クエリ文の内容。
  • matches:クエリ結果の判定に使用します。ドキュメントがメディアクエリリストに一致する場合は true、それ以外の場合は false です。

MediaQueryListオブジェクトはイベントを監視することもできます。監視することで、クエリ結果が変化したときに、指定されたコールバック関数が呼び出されます。

メソッド 説明
addListener(functionref) メディアクエリの結果が変化したときに実行される新しいリスナー関数を追加します。
removeListener(functionref) メディアクエリのリストから以前に追加したリスナーを削除します。 指定されたリスナーがリストにない場合は、何も行いません。

構文

window.matchMedia(mediaQueryString)

パラメータの説明:

  • mediaQueryString: 必須。新しい MediaQueryList オブジェクトを返すメディアクエリを表す文字列です。

戻り値

MediaQueryList オブジェクトを返します。

ブラウザサポート

表内の数字は、そのメソッドをサポートする最初のブラウザのバージョン番号を示します。

Meメソッドhod
matchMedia() 9.0 10.0 6.0 5.1 12.1

例

例

画面(screen/viewport)ウィンドウのサイズを判定:

if (window.matchMedia("(max-width: 700px)").matches) { /*ウィンドウが 700 ピクセル以下*/ } else { /*ウィンドウが 700 ピクセルより大きい*/ }

試してみる »

例

画面(screen/viewport)ウィンドウのサイズを判定し、700 ピクセル以下の場合は背景色を黄色に変更し、700 ピクセルより大きい場合は背景色をピンク色に変更します:

function myFunction(x) { if (x.matches) { //メディアクエリ document.body.style.backgroundColor = "yellow"; } else { document.body.style.backgroundColor = "pink"; } } var x = window.matchMedia("(max-width: 700px)") myFunction(x) //実行時に呼び出されるリスナー関数 x.addListener(myFunction) //状態が変化したときにリスナーを追加

試してみる »

Window 对象参考手册Window オブジェクト

その他の拡張