From 29a08d449d89820b7f270e393427047db5f652d2 Mon Sep 17 00:00:00 2001 From: abdessalem Date: Tue, 22 Sep 2026 13:33:35 +0100 Subject: [PATCH 1/5] Remove deprecated `useInheritedMediaQuery` --- .../content/release/breaking-changes/index.md | 2 + .../remove-useInheritedMediaQuery.md | 58 +++++++++++++++++++ 2 files changed, 60 insertions(+) create mode 100644 sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md diff --git a/sites/docs/src/content/release/breaking-changes/index.md b/sites/docs/src/content/release/breaking-changes/index.md index faf786e9b7..116491f607 100644 --- a/sites/docs/src/content/release/breaking-changes/index.md +++ b/sites/docs/src/content/release/breaking-changes/index.md @@ -39,10 +39,12 @@ They're sorted by release and listed in alphabetical order: * [Added enabled property and made onChanged optional for DropdownButton][] * [Migrate to standalone `material_ui` and `cupertino_ui` packages][] * [Restrict command-line flags for prebuilt Android release binaries][] +* [Removal of `useInheritedMediaQuery`][] [Added enabled property and made onChanged optional for DropdownButton]: /release/breaking-changes/dropdownbutton-enabled-property [Migrate to standalone `material_ui` and `cupertino_ui` packages]: /release/breaking-changes/material-ui-and-cupertino-ui [Restrict command-line flags for prebuilt Android release binaries]: /release/breaking-changes/restrict-command-line-flags-prebuilt-android-release-binaries +[Removal of `useInheritedMediaQuery`]: /release/breaking-changes/remove-useInheritedMediaQuery ### Released in Flutter 3.47 diff --git a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md new file mode 100644 index 0000000000..3dbc19c2c1 --- /dev/null +++ b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md @@ -0,0 +1,58 @@ +--- +title: Remove useInheritedMediaQuery +description: >- + The `useInheritedMediaQuery` property has been removed from the Flutter framework. +--- + +{% render "docs/breaking-changes.md" %} + +## Summary + +The `useInheritedMediaQuery` property in `WidgetsApp`, `MaterialApp` and `CupertinoApp` was removed because these widget never introduced their own MediaQuery, the View widget takes care of that. + +## Context + +Historically, Flutter used `useInheritedMediaQuery` to determine whether a `WidgetsApp`, `MaterialApp` or `CupertinoApp` should inherit the MediaQuery from its parent. This became redundant when MediaQuery inheritance became the default behavior. + +## Migration guide + +If your code previously used the `useInheritedMediaQuery`, you can migrate your code by deleting any usage of `useInheritedMediaQuery`. + +```dart diff +- useInheritedMediaQuery: true, +``` + +```dart diff +- useInheritedMediaQuery: false, +``` + +:::important +This migration isn't supported by `dart fix`. +::: + +## Timeline + +Landed in version: TBD
+In stable release: TBD + +## References + +API documentation: + +* [`WidgetsApp`][] +* [`MaterialApp`][] +* [`CupertinoApp`][] + + +Relevant PRs: + +* [PR 193146][] +* [PR 12970][] +* [PR 12969][] + +[`WidgetsApp`]: {{site.api}}/flutter/widgets/WidgetsApp-class.html +[`MaterialApp`]: {{site.pub}}/documentation/material_ui/latest/material_ui/MaterialApp-class.html +[`CupertinoApp`]: {{site.pub}}/documentation/cupertino_ui/latest/cupertino_ui/CupertinoApp-class.html +[PR 193146]: {{site.repo.flutter}}/pull/193146 +[PR 12970]: {{site.repo.packages}}/pull/12970 +[PR 12969]: {{site.repo.packages}}/pull/12969 \ No newline at end of file From dc26d3644bcf057bf63c5abb6f6548b60007be91 Mon Sep 17 00:00:00 2001 From: Mohellebi Abdessalem <116356835+AbdeMohlbi@users.noreply.github.com> Date: Tue, 22 Sep 2026 19:12:19 +0100 Subject: [PATCH 2/5] Update sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- .../release/breaking-changes/remove-useInheritedMediaQuery.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md index 3dbc19c2c1..cc5f391de7 100644 --- a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md +++ b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md @@ -16,7 +16,7 @@ Historically, Flutter used `useInheritedMediaQuery` to determine whether a `Widg ## Migration guide -If your code previously used the `useInheritedMediaQuery`, you can migrate your code by deleting any usage of `useInheritedMediaQuery`. +If your code previously used `useInheritedMediaQuery`, you can migrate it by deleting any usage of the property. ```dart diff - useInheritedMediaQuery: true, From 3a3658811b03c29ee71d9335b115b1403e6c72ef Mon Sep 17 00:00:00 2001 From: Mohellebi Abdessalem <116356835+AbdeMohlbi@users.noreply.github.com> Date: Tue, 22 Sep 2026 19:12:31 +0100 Subject: [PATCH 3/5] Update sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- .../release/breaking-changes/remove-useInheritedMediaQuery.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md index cc5f391de7..bf0de17e75 100644 --- a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md +++ b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md @@ -8,7 +8,7 @@ description: >- ## Summary -The `useInheritedMediaQuery` property in `WidgetsApp`, `MaterialApp` and `CupertinoApp` was removed because these widget never introduced their own MediaQuery, the View widget takes care of that. +The `useInheritedMediaQuery` property in `WidgetsApp`, `MaterialApp`, and `CupertinoApp` was removed because these widgets never introduced their own `MediaQuery`; the `View` widget takes care of that. ## Context From b815d8b28d39465e572738fa558de4a1f7efda23 Mon Sep 17 00:00:00 2001 From: Mohellebi Abdessalem <116356835+AbdeMohlbi@users.noreply.github.com> Date: Tue, 22 Sep 2026 19:12:43 +0100 Subject: [PATCH 4/5] Update sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- .../release/breaking-changes/remove-useInheritedMediaQuery.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md index bf0de17e75..8be041da93 100644 --- a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md +++ b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md @@ -12,7 +12,7 @@ The `useInheritedMediaQuery` property in `WidgetsApp`, `MaterialApp`, and `Cuper ## Context -Historically, Flutter used `useInheritedMediaQuery` to determine whether a `WidgetsApp`, `MaterialApp` or `CupertinoApp` should inherit the MediaQuery from its parent. This became redundant when MediaQuery inheritance became the default behavior. +Historically, Flutter used `useInheritedMediaQuery` to determine whether a `WidgetsApp`, `MaterialApp`, or `CupertinoApp` should inherit the `MediaQuery` from its parent. This became redundant when `MediaQuery` inheritance became the default behavior. ## Migration guide From 7d02638ff963981c936742d1ef781de24edaa17d Mon Sep 17 00:00:00 2001 From: abdessalem Date: Wed, 23 Sep 2026 13:49:18 +0100 Subject: [PATCH 5/5] one of justin's comments --- .../release/breaking-changes/remove-useInheritedMediaQuery.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md index 8be041da93..76abaa3fcc 100644 --- a/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md +++ b/sites/docs/src/content/release/breaking-changes/remove-useInheritedMediaQuery.md @@ -8,7 +8,7 @@ description: >- ## Summary -The `useInheritedMediaQuery` property in `WidgetsApp`, `MaterialApp`, and `CupertinoApp` was removed because these widgets never introduced their own `MediaQuery`; the `View` widget takes care of that. +The `useInheritedMediaQuery` properties in `WidgetsApp`, `MaterialApp`, and `CupertinoApp` were removed because these widget never introduced their own MediaQuery, the View widget takes care of that. ## Context