From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../web/api/element/requestfullscreen/index.html | 169 +++++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 files/ja/web/api/element/requestfullscreen/index.html (limited to 'files/ja/web/api/element/requestfullscreen/index.html') diff --git a/files/ja/web/api/element/requestfullscreen/index.html b/files/ja/web/api/element/requestfullscreen/index.html new file mode 100644 index 0000000000..17054560e1 --- /dev/null +++ b/files/ja/web/api/element/requestfullscreen/index.html @@ -0,0 +1,169 @@ +--- +title: Element.requestFullscreen() +slug: Web/API/Element/requestFullScreen +tags: + - API + - DOM + - Element + - Fullscreen API + - requestFullscreen + - メソッド + - リファレンス + - 全画面 API +translation_of: Web/API/Element/requestFullScreen +--- +
{{APIRef("Fullscreen API")}}
+ +

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

+ +

要素が全画面モードに移行することは保証されていません。全画面モードに移行する許可が与えられている場合は、返される {{jsxref("Promise")}} が解決され、文書が全画面モードになったことを知ることができる {{event("fullscreenchange")}} イベントを受け取るようになります。権限が拒否された場合は、代わりに {{event('fullscreenerror')}} イベントを受け取ります。

+ +

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

+ +
+

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

+
+ +

構文

+ +
var Promise = Element.requestFullscreen();
+
+ +

引数

+ +

なし。

+ +

返値

+ +

全画面への移行が完了した場合は、 undefined の値で解決した {{jsxref("Promise")}}。

+ +

例外

+ +

全画面のリクエストが失敗した場合は、 Promise が例外で拒否されるかもしれません。発生しうる例外は以下の通りです。

+ + + +
+
{{jsxref("TypeError")}}
+
以下の状況の一つが発生する可能性あります。
+
+ +

例

+ +

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

+ +

tbd

+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName("Fullscreen", "#dom-element-requestfullscreen", "Element.requestFullscreen()")}}{{Spec2("Fullscreen")}}初回定義
+ +

ブラウザーの対応

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
機能ChromeFirefoxInternet ExplorerEdgeOperaSafari
基本対応{{CompatVersionUnknown}}{{property_prefix("webkit")}}[1]{{CompatGeckoDesktop("9.0")}} mozRequestFullScreen として対応[2]
+ {{CompatGeckoDesktop("47.0")}} (full-screen-api.unprefix.enabled で制御)		11{{property_prefix("ms")}}[3]{{CompatVersionUnknown}}[3]{{CompatUnknown}}{{CompatUnknown}}
Promise の返却{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
機能Chrome AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本対応{{CompatVersionUnknown}}{{property_prefix("webkit")}}[1]{{CompatVersionUnknown}}{{CompatGeckoMobile("9.0")}} mozRequestFullScreen として対応 [2]
+ {{CompatGeckoMobile("47.0")}} (full-screen-api.unprefix.enabled で制御)		{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Promise の返却{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +

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

+ +

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

+ +

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

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf