Skip to content

Clarify BackdropFilter does not affect native platform views#186367

Draft
mboetger wants to merge 1 commit into
flutter:masterfrom
mboetger:resolve-issue-132089
Draft

Clarify BackdropFilter does not affect native platform views#186367
mboetger wants to merge 1 commit into
flutter:masterfrom
mboetger:resolve-issue-132089

Conversation

@mboetger
Copy link
Copy Markdown
Contributor

Update dart documentation to clarify filtering rules only affect Flutter views.

Fixes: #132089

Pre-launch Checklist

  • I read the [Contributor Guide] and followed the process outlined there for submitting PRs.
  • I read the [AI contribution guidelines] and understand my responsibilities, or I am not using AI tools.
  • I read the [Tree Hygiene] wiki page, which explains my responsibilities.
  • I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement].
  • I signed the [CLA].
  • I listed at least one issue that this PR fixes in the description above.
  • I updated/added relevant documentation (doc comments with ///).
  • I added new tests to check the change I am making, or this PR is [test-exempt].
  • I followed the [breaking change policy] and added [Data Driven Fixes] where supported.
  • All existing and new tests are passing.

@flutter-dashboard flutter-dashboard Bot added the CICD Run CI/CD label May 11, 2026
@github-actions github-actions Bot added the framework flutter/packages/flutter repository. See also f: labels. label May 11, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds documentation to clarify that the BackdropFilter widget only filters content rendered by Flutter and does not affect native platform views. The review feedback recommends enhancing this documentation by linking to specific platform view widgets and using standard terminology to align with the repository's style guide.

Comment on lines +495 to +497
/// This widget only filters content rendered by Flutter. It does not affect
/// native platform views (like Android views or iOS views) because those views
/// are rendered by the platform itself, not by Flutter's engine.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

To adhere to the Flutter style guide, consider linking to the definitions of the terms introduced. Using specific widget references like [AndroidView] and [UiKitView] provides better context for 'platform views'. Additionally, 'the Flutter engine' is the standard terminology used in the documentation.

/// This widget only filters content rendered by Flutter. It does not affect
/// platform views (such as [AndroidView] or [UiKitView]) because those views
/// are rendered by the platform itself, not by the Flutter engine.
References
  1. Introduce terms: Assume the reader does not know everything. Link to definitions. (link)

@mboetger mboetger marked this pull request as draft May 11, 2026 19:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CICD Run CI/CD framework flutter/packages/flutter repository. See also f: labels.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Documentation] Clarify that backdrop filter doesn't filter Android views

1 participant