FullscreenOptions.navigationUI

The FullscreenOptions dictionary's navigationUI property is used when calling requestFullscreen() to specify to what extent the user agent should include its standard user interface while the element is presented in full-screen mode.

Syntax

let fullscreenOptions = {
  navigationUI: value
};

Value

The value of the navigationUI property must be one of the following strings. The default is "auto".

"hide"
The browser's navigation interface will be hidden and the entire dimensions of the screen will be allocated to the display of the element.
"show"
The browser will present page navigation controls and possibly other user interface; the dimensions of the element (and the perceived size of the screen) will be clamped to leave room for this user interface.
"auto"
The browser will choose which of the above settings to apply. This is the default value.

Example

In this example, the entire document is placed into full-screen mode by calling requestFullscreen() on the document's Document.documentElement, which is the document's root <html> element.

let elem = document.documentElement;

elem.requestFullScreen({ navigationUI: "show" }).then({}).catch(err => {
  alert(`An error occurred while trying to switch into full-screen mode: ${err.message} (${err.name})`);
});

The promise's resolve handler does nothing, but if the promise is rejected, an error message is displayed by calling alert().

Specifications

Specification Status Comment
Fullscreen API
The definition of 'FullscreenOptions' in that specification.
Living Standard Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
navigationUIChrome Full support 71Edge No support NoFirefox Full support 64IE No support NoOpera ? Safari ? WebView Android Full support 71Chrome Android Full support 71Edge Mobile No support NoFirefox Android Full support 64Opera Android ? Safari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown

See also

Document Tags and Contributors

Contributors to this page: mdnwebdocs-bot, ExE-Boss, Sheppy
Last updated by: mdnwebdocs-bot,