diff --git a/files/en-us/web/api/fullscreen_api/guide/index.md b/files/en-us/web/api/fullscreen_api/guide/index.md index a34e15ccbbd7731..f3ce75cd477856f 100644 --- a/files/en-us/web/api/fullscreen_api/guide/index.md +++ b/files/en-us/web/api/fullscreen_api/guide/index.md @@ -41,7 +41,7 @@ When fullscreen mode is successfully engaged, the document which contains the el ### When a fullscreen request fails -It's not guaranteed that you'll be able to switch into fullscreen mode. For example, {{HTMLElement("iframe")}} elements have the [`allowfullscreen`](/en-US/docs/Web/HTML/Element/iframe#allowfullscreen) attribute in order to opt-in to allowing their content to be displayed in fullscreen mode. In addition, certain kinds of content, such as windowed plug-ins, cannot be presented in fullscreen mode. Attempting to put an element which can't be displayed in fullscreen mode (or the parent or descendant of such an element) won't work. Instead, the element which requested fullscreen will receive a `mozfullscreenerror` event. When a fullscreen request fails, Firefox will log an error message to the Web Console explaining why the request failed. In Chrome and newer versions of Opera however, no such warning is generated. +It's not guaranteed that you'll be able to switch into fullscreen mode. For example, {{HTMLElement("iframe")}} elements have the [`allowfullscreen`](/en-US/docs/Web/HTML/Element/iframe#allowfullscreen) attribute in order to opt-in to allowing their content to be displayed in fullscreen mode. In addition, certain kinds of content, such as windowed plug-ins, cannot be presented in fullscreen mode. Attempting to put an element which can't be displayed in fullscreen mode (or the parent or descendant of such an element) won't work. Instead, the element which requested fullscreen will receive a `fullscreenerror` event. When a fullscreen request fails, Firefox will log an error message to the Web Console explaining why the request failed. In Chrome and newer versions of Opera however, no such warning is generated. > [!NOTE] > Fullscreen requests need to be called from within an event handler or otherwise they will be denied. @@ -105,7 +105,7 @@ function toggleFullScreen() { } ``` -This starts by looking at the value of the `fullscreenElement` attribute on the {{DOMxRef("document")}}. If it's `null`, the document is currently in windowed mode, so we need to switch to fullscreen mode. Switching to fullscreen mode is done by calling {{DOMxRef("element.requestFullscreen()")}}. +This starts by looking at the value of the `fullscreenElement` attribute on the {{DOMxRef("document")}}. If it's `null`, the document is currently in windowed mode, so we need to switch to fullscreen mode. Switching to fullscreen mode is done by calling {{DOMxRef("Element.requestFullscreen()")}}. If fullscreen mode is already active (`fullscreenElement` is non-`null`), we call {{DOMxRef("document.exitFullscreen()")}}. diff --git a/files/jsondata/GroupData.json b/files/jsondata/GroupData.json index 264130b25527d9e..3e77f944234732c 100644 --- a/files/jsondata/GroupData.json +++ b/files/jsondata/GroupData.json @@ -609,7 +609,12 @@ "guides": ["/docs/Web/API/Fullscreen_API/Guide"], "interfaces": [], "methods": ["Document.exitFullscreen()", "Element.requestFullscreen()"], - "properties": ["Document.fullscreen", "Document.fullscreenElement"], + "properties": [ + "Document.fullscreen", + "Document.fullscreenElement", + "Document.fullscreenEnabled", + "ShadowRoot.fullscreenElement" + ], "events": [ "Document: fullscreenchange", "Document: fullscreenerror",