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 の文書をご覧ください。