SYNCERのロゴ
アイキャッチ画像

MediaQueryList.addListener() - イベントを追加する

addListener()は、MediaQueryListのメソッドです。changeイベントを追加します。

概要

名前
addListener
所属
MediaQueryList
IDL
void addListener(EventListener? listener);

callback interface EventListener {
  void handleEvent(Event event);
};
仕様書
https://drafts.csswg.org/cssom-view/#dom-mediaquerylist-addlistener

説明

引数(listener)には、コールバック関数を指定する。

このメソッドは、EventTarget.addEventListener()の省略版です。Event.typeには"change"が、オプションのcaptureにはfalseが、それ以外は初期値が設定されます。

チュートリアル

下記は同じ結果になります。

var mediaQueryList = matchMedia( "(max-width: 270px)" ) ;

mediaQueryList.addListener( callbackFn ) ;
mediaQueryList.addEventListener( "change", callbackFn, false ) ;

デモ

MediaQueryList.addListener()のデモです。"(max-width: 270px)"というメディアクエリのMediaQueryListを作成しています。ウィンドウの横幅270pxを境に、matchesの値が変化します。イベントを追加すると、背景色などが切り替わるようになります。なお、重複登録はできないようになっています。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<head>
<style>
body { word-break: break-all ; tab-size: 2 ; }
div#result { white-space: pre-wrap ; }
</style>
</head>
<body>
<p><button id="addListener">追加</button></p>
<p><button id="removeListener">削除</button></p>
<hr>
<div id="result"></div>
<script>
var mediaQueryList = matchMedia( "(max-width: 270px)" ) ;

document.getElementById( "addListener" ).onclick = function () {
	mediaQueryList.removeListener( getMediaQueryListInfo ) ;	// 重複での登録を回避
	mediaQueryList.addListener( getMediaQueryListInfo ) ;
}

document.getElementById( "removeListener" ).onclick = function () {
	mediaQueryList.removeListener( getMediaQueryListInfo ) ;
}

function getMediaQueryListInfo() {
	document.getElementById( "result" ).textContent = "" ;

	appendText( mediaQueryList + "\n" ) ;
	appendText( "media: " + mediaQueryList.media + "\n" ) ;
	appendText( "matches: " + mediaQueryList.matches + "\n\n" ) ;

	if ( mediaQueryList.matches ) {
		appendText( "メディアクエリの条件を満たしています。" ) ;
		document.body.style.backgroundColor = "#fee" ;
	} else {
		appendText( "メディアクエリの条件を満たしていません。" ) ;
		document.body.style.backgroundColor = "#eef" ;
	}
}

function appendText ( text ) {
	document.getElementById( "result" ).appendChild( document.createTextNode( text ) ) ;
}
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
6+ 5.1+ 10+ 12+ 4.0+
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月16日 (月)
コンテンツを公開しました。