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

Document.onfullscreenerror - フルスクリーンでエラーが起きた時に発火するイベント

onfullscreenerrorは、Documentのイベントです。フルスクリーンでエラーが起きた時にfullscreenerrorイベントが発生し、ここに設定したコールバック関数が呼び出されます。

概要

名前
onfullscreenerror
所属
Document
イベント
fullscreenerror
IDL
attribute EventHandler onfullscreenerror;

typedef EventHandlerNonNull? EventHandler;

callback EventHandlerNonNull = any (Event event);
仕様書
https://fullscreen.spec.whatwg.org/#handler-document-onfullscreenerror

チュートリアル

onfullscreenerrorでイベントを設定する例です。

document.onfullscreenerror = function ( event ) {
	console.log( event ) ;
}

Fullscreen APIは2017年10月現在、各ブラウザの実装が進んでいません。それぞれのベンダープレフィクスを考慮する必要があります。

document.onfullscreenerror = document.onmozfullscreenerror = document.onwebkitfullscreenerror = document.onmsfullscreenerror = function ( event ) {
	console.log( event ) ;
}

// Chrome: onwebkitfullscreenerror
// Firefox: onmozfullscreenerror
// Ie: onmsfullscreenerror

Event.addEventListener()でも、同様にイベントを設定できます。

document.addEventListener( "fullscreenerror", function ( event ) {
	console.log( event ) ;
} ) ;

デモ

Document.onfullscreenerrorのデモです。フルスクリーン表示に失敗するごとにイベントが発生し、その回数を出力します。セキュリティの関係で、iframe要素の中でフルスクリーン表示を実行すると、エラーが発生します。

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

<!DOCTYPE html>
<body>
	<p><button id="request">実行</button></p>
	<p><button id="exit">解除</button></p>
<hr>
<div id="result">0</div>
<script>
// イベント
var number = 0 ;

document.onfullscreenerror = document.onmozfullscreenerror = document.onwebkitfullscreenerror = document.onmsfullscreenerror = function ( event ) {
	console.log( event ) ;
	document.getElementById( "result" ).textContent = ++number ;
}

// 実行
document.getElementById( "request" ).onclick = function () {
	var element = document.documentElement ;
	element.requestFullscreen = element.requestFullscreen || element.mozRequestFullScreen || element.webkitRequestFullscreen || element.msRequestFullscreen ;
	element.requestFullscreen() ;
}

// 解除
document.getElementById( "exit" ).onclick = function () {
	document.exitFullscreen = document.exitFullscreen || document.cancelFullScreen || document.mozCancelFullScreen || document.webkitCancelFullScreen || document.msExitFullscreen ;
	document.exitFullscreen() ;
}
</script>
</body>
</html>

サポート状況

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