coderef

overlayLimited availability

The overlay CSS property, used as an allow-discrete CSS transition, prevents a top layer element, such as a popover or a <dialog>, from being removed from the top layer before it has finished animating. You can't set the value of the overlay property; only use it as transition property.

Not yet supported in all major browsers — check the table and provide a fallback.

Browser support

DesktopChrome
1–116Not supported
117+Supportedsince Sep 12, 2023
Current: 155
Edge
12–116Not supported
117+Supportedsince Sep 15, 2023
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
✕Not supportedup to 27
Current: 27
MobileChrome Android
18–116Not supported
117+Supportedsince Sep 12, 2023
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
✕Not supportedup to 27
Current: 27

How to use

Not supported in Firefox, Safari, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: overlay.

Feature detection

CSS · check before using
@supports (overlay: initial) {
  /* styles that rely on overlay */
}

/* or in JavaScript */
if (CSS.supports("overlay", "initial")) {
  // use it
}

Documentation (MDN)

Specification

Sub-features

Support for each part of the feature (3). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
overlay117117✕✕117✕✕
overlay.auto117117✕✕117✕✕
overlay.none117117✕✕117✕✕