HTTP の Feature-Policy ヘッダーにおける fullscreen ディレクティブは、現在の文書が Element.requestFullScreen() を使用することを許可するかどうかを制御します。このポリシーが有効であれば、 返却された Promise が TypeError で拒否されます。
既定では、最上位の文書およびその同じオリジンの子フレームが全画面モードを要求し、入ることができます。このディレクティブは別オリジンのフレームが全画面モードを使用することを許可したり拒否したりします。同じオリジンのフレームも含みます。
このディレクティブと allowfullscreen が同じ <iframe> 要素に指定されていた場合、このディレクティブが優先します。
構文
Feature-Policy: fullscreen <allowlist>;
- <allowlist>
許可リストは、以下の値のうち一つを取るオリジンのリストです。
*: この機能は既定で、最上位の閲覧コンテキストと、含まれるすべての閲覧コンテキスト (iframe) で許可されます。'self': (既定値) この機能は既定で、最上位の閲覧コンテキストと、含まれる同じオリジンの閲覧コンテキスト (iframe) で許可されます。この機能は、含まれる閲覧コンテキストにある別なオリジンの文書では許可されません。'none': この機能は最上位および含まれる閲覧コンテキストで無効になります。- <origin(s)>: この機能は特定のオリジン (例えば、 https://example.com) で許可されます。オリジンは空白で区切ってください。
既定値は*の値 (すべてのオリジンで有効) または'none'(すべてのオリジンで無効) は単独でのみ使用できますが、'self'は一つ以上のオリジンと一緒に使用することができます。'self'です。
例
一般的な例
SecureCorp Inc. は、自分自身のオリジンおよびオリジンが https://example.com のものを除いてすべての Fullscreen API を無効にしたがっているとします。以下の機能ポリシーを設定する HTTP レスポンスヘッダーを配信することで実現できます。
Feature-Policy: fullscreen 'self' https://example.com
<iframe> 要素と
FastCorp Inc. は、特定の <iframe> を除いたすべての別オリジンの子フレームの fullscreen を無効にしたがっているとします。以下の機能ポリシーを設定する HTTP レスポンスヘッダーを配信することで実現できます。
Feature-Policy: fullscreen 'self'
それから <iframe> 要素に allow 属性を含めます。
<iframe src="https://other.com/videoplayer" allow="fullscreen"></iframe>
iframe の属性は、選択的に特定のフレームの機能を有効にし、その他はたとえそれらのフレームが同じオリジンからきた文書を含んでいても無効にします。
仕様書
| 仕様書 | 状態 | 備考 |
|---|---|---|
| Feature Policy | 編集者草案 | 初回定義 |
| Fullscreen API Fullscreen の定義 |
編集者草案 | fullscreen ポリシーを定義 |
ブラウザーの対応
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
fullscreen | Chrome 完全対応 62 | Edge 未対応 なし | Firefox
完全対応
65
| IE 未対応 なし | Opera 完全対応 49 | Safari 未対応 なし | WebView Android 完全対応 62 | Chrome Android 完全対応 62 | Firefox Android
完全対応
65
| Opera Android 完全対応 46 | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 8.0 |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実験的。動作が変更される可能性があります。
- 実験的。動作が変更される可能性があります。
- ユーザーが明示的にこの機能を有効にしなければなりません。
- ユーザーが明示的にこの機能を有効にしなければなりません。