Window matchMedia()メソッド
定義と用法
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 オブジェクト