Document: fullscreenElement プロパティ
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Document.fullscreenElement プロパティは読み取り専用で、この文書内で現在全画面モードで表示されている Element を返し、全画面モードを使用していない場合は null を返します。
このプロパティは読み取り専用ですが、変更されても(厳格モードでも)例外は発生しません。設定しても何もせず、無視されます。
返値
現在全画面モードになっている Element オブジェクト。全画面モードがこの document で使用されていない場合、返値は null です。
例
この例は isVideoInFullscreen() 関数を表し、 fullscreenElement からの返値を調べています。文書が全画面モードで (fullscreenElement が null ではなく)、全画面の要素の nodeName が VIDEO、すなわち <video> 要素を表す場合、この関数は true、すなわち動画が全画面モードであることを表します。
js
function isVideoInFullscreen() {
if (document.fullscreenElement?.nodeName === "VIDEO") {
return true;
}
return false;
}
仕様書
| 仕様書 |
|---|
| Fullscreen API> # ref-for-dom-document-fullscreenelement①> |