大网数据广告活动
Web 标准与前端开发

`:xr-overlay` CSS pseudo-class

· 52CE 我爱测

The **`:xr-overlay`** CSS pseudo-class, defined in the WebXR DOM overlays module, matches the DOM overlay element when a web page is being viewed in an immersive AR or VR environment.

The :xr-overlay CSS pseudo-class, defined in the WebXR DOM overlays module, matches the DOM overlay element when a web page is being viewed in an immersive AR or VR environment.

Syntax

:xr-overlay {
  /* ... */
}

Description

The :xr-overlay pseudo-class matches the overlay element for the duration of an immersive session using a DOM overlay.

The overlay element is a backdrop root. Any backdrop-filter effects on the DOM overlay element or its descendants do not modify the AR camera image (if applicable) or the rendered content drawn to the immersive session's XRWebGLLayer.

The overlay element itself is a stacking context due to its fixed position. The stacking contexts for ancestors of the overlay element, if any, do not paint to the immersive session's display.

[!NOTE] On a multi-display system, the stacking contexts for ancestors or sibling trees of the overlay element may be displayed on separate displays.

Examples

Basic usage

In this example, we define the overlay to be semi-transparent black, enabling content behind the overlay to be partially visible. To ensure enough contrast between content and its background, we set the color to white.

:xr-overlay {
  background-color: rgb(0 0 0 / 0.5);
  color: white;
}

Targeting an overlay's contents

In this example, we use the :xr-overlay selector to style the button elements within an XR DOM overlay.

:xr-overlay button {
  background-color: white;
  color: black;
}

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。