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 3 commits into
base: main
Choose a base branch
from
Open

Conversation

kb42
Copy link
Contributor

@kb42 kb42 commented Aug 4, 2025

Description

Clarify that backdrop-filter only affects the backdrop image up to its nearest ancestor Backdrop Root as stated in the issue, and add a concise note listing what triggers a Backdrop Root which was obtained from the source listed in this PR.

Motivation

The existing text (“area behind an element”) implied that backdrop-filter applies to all pixels behind an element, which contradicts real-world behavior and the Filter Effects Level 2 specification. Developers encountered “missing” blur outside the nearest Backdrop Root (for example, a semi-transparent ancestor), leading to confusion. This update aligns MDN’s description with the spec and addresses user reports in the GitHub issue.

Additional details

Related issues and pull requests

Fixes #40602

@kb42 kb42 requested a review from a team as a code owner August 4, 2025 20:36
@kb42 kb42 requested review from estelle and removed request for a team August 4, 2025 20:36
@github-actions github-actions bot added Content:CSS Cascading Style Sheets docs size/s [PR only] 6-50 LoC changed labels Aug 4, 2025
Copy link
Contributor

github-actions bot commented Aug 4, 2025

Preview URLs

Flaws (4)

URL: /en-US/docs/Web/CSS/backdrop-filter
Title: backdrop-filter
Flaw count: 4

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/zero
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

(comment last updated: 2025-08-07 03:47:52)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:CSS Cascading Style Sheets docs size/s [PR only] 6-50 LoC changed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Backdrop Root concept undocumented
1 participant