We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Element.requestFullscreen() メソッドは、要素を全画面表示するための非同期的な要求を発行します。

要素が全画面モードに移行することは保証されていません。全画面モードに移行する許可が与えられている場合は、 document が全画面モードになったことを知ることができる fullscreenchange イベントを受け取ります。権限が拒否された場合は、代わりに fullscreenerror イベントを受け取ります。

このメソッドはユーザーの操作又は機器の方向の変更によって呼び出す必要があり、そうでなければ失敗します。

全画面で表示することができる要素は、 HTML 名前空間にあり (つまり、標準の HTML の要素であり)、加えて <svg> 要素や <math> 要素、文書の最上位にある要素、又は allowfullscreen 属性を持つ <iframe> だけです。すなわち、 <frame><object> の内部にある要素は全画面で表示できません。

構文

Element.requestFullscreen();

requestFullscreen() を呼び出す前に、 fullscreenchange 及び fullscreenerror イベントのイベントハンドラーを設定してください。そうすれば、いつ全画面モードに切り替えることに成功したか (又は権限がなくて拒否されたか) を知ることができます。

tbd

仕様策定状況

仕様書 策定状況 コメント
Fullscreen API
Element.requestFullscreen() の定義
現行の標準 初回定義

ブラウザーの対応

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 Chrome Firefox Internet Explorer Edge Opera Safari
基本対応 (有)webkit[1] 9.0 (9.0) mozRequestFullScreen として対応[2]
47.0 (47.0) (full-screen-api.unprefix.enabled で制御)
11ms[3] (有)[3] ? ?
機能 Chrome Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本対応 (有)webkit[1] (有) 9.0 (9.0) mozRequestFullScreen として対応 [2]
47.0 (47.0) (full-screen-api.unprefix.enabled で制御)
? ? ?

[1] webkitRequestFullscreen としても実装されています。

[2] mozRequestFullScreen として実装されています (Screen の S は大文字です)。 Firefox 44 より前のバージョンでは、誤って <frame><object> の内部にある要素の要求も受け入れて、許可されれば全画面表示していました。これは Firefox 44 以降で修正済みです。文書の最上位にある要素、または allowfullscreen 属性を持つ <iframe> だけが全画面モードで表示できます。

[3] MSDN の文書をご覧ください。

関連情報

ドキュメントのタグと貢献者

このページの貢献者: mfuji09, yyss
最終更新者: mfuji09,