Document.exitFullscreen() - フルスクリーンを解除する
exitFullscreen()は、Documentのメソッドです。フルスクリーンを解除します。
概要
- 名前
- exitFullscreen
- 所属
- Document
- IDL
Promise<void> exitFullscreen();
- 仕様書
- https://fullscreen.spec.whatwg.org/#dom-document-exitfullscreen
説明
引数はありません。Promiseを返します。
チュートリアル
Fullscreen APIは2017年10月現在、各ブラウザの実装が進んでいません。それぞれのベンダープレフィクスや別名を考慮する必要があります。
//メソッド名を統一
document.exitFullscreen = document.exitFullscreen || document.cancelFullScreen || document.mozCancelFullScreen || document.webkitCancelFullScreen || document.msExitFullscreen ;
// 実行
document.exitFullscreen() ;
このメソッドはPromiseを返すため、解除の完了したタイミングで処理ができるとされていますが、2017年10月現在、対応しているブラウザはありません。
document.exitFullscreen().then( function () {
console.log( "フルスクリーンを解除しました!!" ) ;
} ) ;
デモ
Document.exitFullscreen()のデモです。「実行」をクリックしてフルスクリーンにした後、「解除」をクリックするとメソッドを実行してフルスクリーンを解除します。セキュリティの関係で、新しくページを開かないと動作しません。
<!-- このコードは編集できます。 -->
<!DOCTYPE html>
<body>
<p><button id="request">実行</button></p>
<p><button id="exit">解除</button></p>
<script>
// 実行
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>
サポート状況
Chrome | Firefox | Safari | Edge | IE | Opera | iOS Safari | Android |
---|---|---|---|---|---|---|---|
▲ 15+ | ▲ 9+ | ▲ 5.1+ | ▲ | ▲ 11+ | ▲ 15+ | × | ▲ 4.4+ |
関連記事
- fullscreenchangeイベント
- fullscreenchangeイベントは、フルスクリーンの状態が変化した時に発生するイベントです。
- Document
- Documentは、ドキュメントを管理するための機能を備えたインターフェイスです。
- Document.open()
- open()は、Documentのメソッドです。ドキュメントを開き、関連メソッドで書き込みができる状態にします。このメソッドは3つの引数を指定すると、全く別の性質を持ち、Window.open()と同じ働きをします。
- Location.replace()
- replace()は、Locationのメソッドです。新しいロケーションに遷移させます。ただし、履歴エントリーは追加されずに、現在の履歴エントリーと置き換わります。そのため、遷移前のページに戻ることはできません。