display-mode

display-mode is a CSS media feature that selectively applies CSS based on the display mode of the application. This feature corresponds the Web app manifest's display member. Both apply to the top-level browsing context and any child browsing contexts. This query applies regardless of whether a web app manifest is present. Use this query to provide a consistant user experience between launching a site from an URL and lunching it from a desktop icon.

Its value can be one of the following:

Display Mode Description Fallback Display Mode
fullscreen All of the available display area is used and no user agent chrome is shown. standalone
standalone The application will look and feel like a standalone application. This can include the application having a different window, its own icon in the application launcher, etc. In this mode, the user agent will exclude UI elements for controlling navigation, but can include other UI elements such as a status bar. minimal-ui
minimal-ui The application will look and feel like a standalone application, but will have a minimal set of UI elements for controlling navigation. The elements will vary by browser. browser
browser The application opens in a conventional browser tab or new window, depending on the browser and platform. (None)

Examples

@media all and (display-mode: fullscreen) {
  body {
    margin: 0;
    border: 5px solid black;
  }
}

Specifications

Specification Status Comment
Web App Manifest
The definition of 'display-mode' in that specification.
Working Draft Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 46.0[1] 47 (47) ? ? ?
Feature Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? ? 47 (47) ? ? ? 46.0[1]

[1] Does not support 'minimal-ui'. @supports for 'display-mode' only supported starting Chrome 48.

Document Tags and Contributors

 Contributors to this page: hexalys, jpmedley, chrisdavidmills
 Last updated by: hexalys,