Skip to content

fix issue: Backdrop Root concept undocumented #40627

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion files/en-us/web/css/backdrop-filter/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,19 @@ browser-compat: css.properties.backdrop-filter
sidebar: cssref
---

The **`backdrop-filter`** [CSS](/en-US/docs/Web/CSS) property lets you apply graphical effects such as blurring or color shifting to the area behind an element. Because it applies to everything _behind_ the element, to see the effect the element or its background needs to be transparent or partially transparent.
The **`backdrop-filter`** CSS property lets you apply graphical effects such as blurring or color shifting to an element's **backdrop image**, which are the pixels painted behind the element up to its nearest ancestor Backdrop Root. To see the effect, the element (or its background) must be transparent or partially transparent.

> [!NOTE]
> Filters do not apply to pixels behind the element that originate from outside its nearest ancestor Backdrop Root.
> A Backdrop Root is the nearest ancestor that is one of:
>
> - the root `<html>` element
> - an element with a `filter` property other than `none`
> - an element with `opacity` less than 1
> - an element with `mask`, `mask-image`, `mask-border`, or `clip-path` other than `none`
> - an element with `backdrop-filter` other than `none`
> - an element with `mix-blend-mode` other than `normal`
> - an element with `will-change` specifying any of the above properties

{{InteractiveExample("CSS Demo: backdrop-filter()")}}

Expand Down