Add `automaticallyImplyActions` property to AppBar #171113

k-arindam · 2025-06-24T22:03:34Z

Summary

This PR adds a new boolean property automaticallyImplyActions to the AppBar widget.
It provides fine-grained control over whether an automatic menu icon (Icons.menu) is added when an endDrawer is present and actions are null or empty.

Details

Background

In the current behavior of AppBar, if:

The Scaffold has a non-null endDrawer, and
The AppBar.actions is either null or an empty list []

Then Flutter automatically inserts a trailing menu icon (Icons.menu) into the actions list, which opens the endDrawer.

New Behavior

This PR introduces:

final bool automaticallyImplyActions; // default: true

Developers can now control this behavior:

automaticallyImplyActions: true (default):
The menu icon is automatically inserted when appropriate, as before.
automaticallyImplyActions: false:
The AppBar will not add the automatic trailing menu icon, even if an endDrawer is present and actions are null or empty.

All Possible Scenarios

`endDrawer`	`actions`	`automaticallyImplyActions`	Result
✅ present	`null` or `[]`	`true` (default)	Automatic menu icon is added
✅ present	`null` or `[]`	`false`	No menu icon is added
✅ present	`[customWidgets]`	`true` / `false`	Custom actions shown, no menu added
❌ absent	any value	any value	No menu icon is added

This provides predictable, developer-controlled behavior while maintaining backward compatibility.

Use Case

This change benefits developers who:

Want to prevent automatic UI behaviors when building custom app bars.
Need full control over the trailing icons without modifying internal logic.
Encounter issues where the menu icon appears unintentionally in minimal AppBar configurations.

Default Behavior (No Breaking Change)

The default value is true, so existing applications are not affected.
The new behavior is opt-in by setting automaticallyImplyActions: false.

Pre-launch Checklist

I read the Contributor Guide and followed the process outlined there for submitting PRs.
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.

1. This adds a new boolean property automaticallyImplyActions (default: true) to the AppBar 2. When an AppBar is used inside a Scaffold that has an end drawer and the AppBar's actions list is null or empty, a menu button is automatically added to open the endDrawer. 3. Setting automaticallyImplyActions to false disables this behavior, allowing full manual control over the AppBar's actions.

flutter-dashboard · 2025-06-24T22:03:37Z

It looks like this pull request may not have tests. Please make sure to add tests or get an explicit test exemption before merging.

If you are not sure if you need tests, consider this rule of thumb: the purpose of a test is to make sure someone doesn't accidentally revert the fix. Ask yourself, is there anything in your PR that you feel it is important we not accidentally revert back to how it was before your fix?

Reviewers: Read the Tree Hygiene page and make sure this patch meets those guidelines before LGTMing.If you believe this PR qualifies for a test exemption, contact "@test-exemption-reviewer" in the #hackers channel in Discord (don't just cc them here, they won't see it!). The test exemption team is a small volunteer group, so all reviewers should feel empowered to ask for tests, without delegating that responsibility entirely to the test exemption group.

google-cla · 2025-06-24T22:03:39Z

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

nuuuron · 2025-06-24T22:39:58Z

Rationale for `automaticallyImplyActions`

This change was necessary because there was previously no first-party way to suppress the automatic endDrawer menu icon behavior in the AppBar.

Developers were forced to use workarounds to avoid the auto-inserted Icons.menu button when no actions were needed. A common workaround looked like this:

return Scaffold(
  appBar: AppBar(
    actions: [const SizedBox()], // workaround to suppress auto menu
  ),
  endDrawer: Drawer(),
);

While this prevented the menu button from appearing, it was unintuitive and cluttered the code. Introducing automaticallyImplyActions provides a clean, declarative solution to this issue.

dkwingsmt · 2025-06-25T18:29:03Z

Hi, thanks for your contribution. Can you add some unit tests?

…tomaticallyImplyActions

k-arindam · 2025-06-25T21:25:57Z

Hi @dkwingsmt,

Tests have been added for both AppBar.automaticallyImplyActions and SliverAppBar.automaticallyImplyActions in Commit e76857d.

These cover default behavior, suppression with false, and behavior when custom actions are provided.

nuuuron · 2025-07-14T23:31:51Z

Any update on this @k-arindam @dkwingsmt ?

k-arindam · 2025-07-14T23:35:00Z

Hi @nuuuron, we're waiting for @dkwingsmt's review!

dkwingsmt · 2025-07-14T23:44:51Z

Sorry this PR slipped through my review queue! I'll look at it soon!

dkwingsmt

LGTM, thank you!

dkwingsmt · 2025-07-17T17:49:53Z

This needs a second approval to land. I've sent it out for a another review.

Piinks

Hey @k-arindam! Welcome! Thanks for contributing. It looks like the analyzer is failing here currently, it looks like this needs dart format run. Can you take a look?

k-arindam · 2025-07-18T07:56:56Z

Hey @Piinks, let me have a look!
Thanks

k-arindam · 2025-07-18T09:12:53Z

Hey @Piinks, running dart format . on the root is formatting approx 2k files.
What's your take on how to proceed?

Piinks · 2025-07-18T16:46:42Z

Hey @Piinks, running dart format . on the root is formatting approx 2k files. What's your take on how to proceed?

Hmm that does not sound right. I wonder, have you rebased with the tip of the tree? We bumped the Dart version since you opened this PR and it introduced a different formatting style.

dkwingsmt · 2025-07-18T19:18:30Z

Or can you try flutter update-packages?

k-arindam · 2025-07-18T19:21:57Z

I'll have a look into it now, and will keep you guys updated here!
@Piinks @dkwingsmt 🤞🏼

Also some tests are failing specially some linux & mac ones after merging the flutter/master, whats going on ?!? 🤔

dkwingsmt · 2025-07-18T22:40:42Z

Those are probably flakes. Rerunning them (or updating with base branch) usually resolves them (some infra flakes might need waiting until work hours).

If you find resolving the formatting error too hard you may also manually apply them for now, which is a simple fix here:

git apply <<DONE
diff --git a/packages/flutter/test/material/app_bar_test.dart b/packages/flutter/test/material/app_bar_test.dart
index fa0e4dd2f85..00000000000 100644
--- a/packages/flutter/test/material/app_bar_test.dart
+++ b/packages/flutter/test/material/app_bar_test.dart
@@ -973,7 +973,9 @@ void main() {
     'AppBar draws menu for end drawer if automaticallyImplyActions is true (default) and actions is null',
     (WidgetTester tester) async {
       await tester.pumpWidget(
-        MaterialApp(home: Scaffold(endDrawer: const Drawer(), appBar: AppBar())),
+        MaterialApp(
+          home: Scaffold(endDrawer: const Drawer(), appBar: AppBar()),
+        ),
       );
       expect(find.byIcon(Icons.menu), findsOneWidget);
     },
@@ -3624,3 +3626,4 @@ void main() {
     );
   });
 }
DONE

k-arindam · 2025-07-20T09:39:00Z

Those are probably flakes. Rerunning them (or updating with base branch) usually resolves them (some infra flakes might need waiting until work hours).

If you find resolving the formatting error too hard you may also manually apply them for now, which is a simple fix here:

git apply <<DONE
diff --git a/packages/flutter/test/material/app_bar_test.dart b/packages/flutter/test/material/app_bar_test.dart
index fa0e4dd2f85..00000000000 100644
--- a/packages/flutter/test/material/app_bar_test.dart
+++ b/packages/flutter/test/material/app_bar_test.dart
@@ -973,7 +973,9 @@ void main() {
     'AppBar draws menu for end drawer if automaticallyImplyActions is true (default) and actions is null',
     (WidgetTester tester) async {
       await tester.pumpWidget(
-        MaterialApp(home: Scaffold(endDrawer: const Drawer(), appBar: AppBar())),
+        MaterialApp(
+          home: Scaffold(endDrawer: const Drawer(), appBar: AppBar()),
+        ),
       );
       expect(find.byIcon(Icons.menu), findsOneWidget);
     },
@@ -3624,3 +3626,4 @@ void main() {
     );
   });
 }
DONE

Thanks @dkwingsmt 👆🏼!
@Piinks the latest commit in this PR should address the formatting issue..

justinmc

LGTM 👍 . This can land regardless of whether or not you decide to add the assertion I mentioned in my comment below.

packages/flutter/lib/src/material/app_bar.dart

…/flutter#171113)

flutter/flutter@afba7d7...20788c0 2025-07-24 [email protected] Roll Packages from 9c85e5e to 963550c (4 revisions) (flutter/flutter#172696) 2025-07-24 [email protected] Add missing deprecations to CupertinoDynamicColor. (flutter/flutter#171160) 2025-07-24 [email protected] Roll Dart SDK from a181fe571dc8 to 26dece893751 (2 revisions) (flutter/flutter#172683) 2025-07-24 [email protected] Migrate to null aware elements - Part 1 (flutter/flutter#172198) 2025-07-24 [email protected] licenses_cpp: implements extracting regions from matched text (flutter/flutter#172655) 2025-07-24 [email protected] Roll pub packages (flutter/flutter#172677) 2025-07-24 [email protected] Marks Mac_ios keyboard_hot_restart_ios to be unflaky (flutter/flutter#168053) 2025-07-24 [email protected] Roll Abseil and remove a workaround for a Fuchsia target that was unable to build Abseil (flutter/flutter#172665) 2025-07-24 [email protected] Add `automaticallyImplyActions` property to AppBar (flutter/flutter#171113) 2025-07-24 [email protected] fix: TabBar fontFamily inheritance with custom label styles (flutter/flutter#171699) 2025-07-23 [email protected] Marks Linux_mokey new_gallery__crane_perf to be unflaky (flutter/flutter#167633) 2025-07-23 [email protected] [android] Fix broken `--android-skip-build-dependency-validation` flag (flutter/flutter#172581) 2025-07-23 [email protected] Fix: Ensure Text widget locale is included in semantics language tag (flutter/flutter#172034) 2025-07-23 [email protected] [Web][a11y] Update selected chips semantics (flutter/flutter#172660) 2025-07-23 [email protected] Roll Skia from eea1c33fbe84 to 094ac350125f (29 revisions) (flutter/flutter#172664) 2025-07-23 [email protected] Marks Mac_arm64_ios imitation_game_flutter to be unflaky (flutter/flutter#168052) 2025-07-23 [email protected] Roll Dart SDK from a31774a3d049 to a181fe571dc8 (2 revisions) (flutter/flutter#172667) 2025-07-23 [email protected] Adapt xcresult parser for Xcode 16 changes (flutter/flutter#172596) 2025-07-23 [email protected] Update excluded_files to match the current output of the old license checker (flutter/flutter#172670) 2025-07-23 [email protected] Manual Roll of Dart SDK from da9e0299c120 to a31774a3d049 (flutter/flutter#172616) 2025-07-23 [email protected] [FGP] Small restructuring of Android Studio native flutter dependency support (flutter/flutter#172651) 2025-07-23 [email protected] revert: Replaces legacy licenses check with licenses_cpp (flutter/flutter#172568) 2025-07-23 [email protected] fix: size-exp naming (flutter/flutter#172647) 2025-07-23 [email protected] Roll Fuchsia Test Scripts from MnFlN7VWM_7h7EmBV... to BWj3yYC74ud58QhN0... (flutter/flutter#172646) 2025-07-23 [email protected] [DisplayList] implement shadow bounds without relying on Skia utilities (flutter/flutter#172572) 2025-07-23 [email protected] Update `dev/bots/post_process_docs.dart` to use `flutter.version.json` (flutter/flutter#172601) 2025-07-23 [email protected] Emit a warning on `--[no-]disable-dds`, preferring `--no-dds` (flutter/flutter#172595) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md

## Summary - This PR adds a new boolean property `automaticallyImplyActions` to the `AppBar` widget. - It provides fine-grained control over whether an automatic menu icon (`Icons.menu`) is added when an `endDrawer` is present and `actions` are null or empty. ## Details ### Background In the current behavior of `AppBar`, if: - The `Scaffold` has a non-null `endDrawer`, and - The `AppBar.actions` is either `null` or an empty list `[]` Then Flutter **automatically inserts** a trailing menu icon (`Icons.menu`) into the `actions` list, which opens the `endDrawer`. ### New Behavior This PR introduces: ```dart final bool automaticallyImplyActions; // default: true ``` Developers can now control this behavior: - `automaticallyImplyActions: true` (default):\ The menu icon is automatically inserted when appropriate, as before. - `automaticallyImplyActions: false`:\ The `AppBar` will **not** add the automatic trailing menu icon, even if an `endDrawer` is present and `actions` are null or empty. ### All Possible Scenarios | `endDrawer` | `actions` | `automaticallyImplyActions` | Result | | ----------- | ----------------- | --------------------------- | ----------------------------------- | | ✅ present | `null` or `[]` | `true` (default) | Automatic menu icon is added | | ✅ present | `null` or `[]` | `false` | No menu icon is added | | ✅ present | `[customWidgets]` | `true` / `false` | Custom actions shown, no menu added | | ❌ absent | any value | any value | No menu icon is added | This provides predictable, developer-controlled behavior while maintaining backward compatibility. --- ## Use Case This change benefits developers who: - Want to **prevent automatic UI behaviors** when building custom app bars. - Need full control over the trailing icons without modifying internal logic. - Encounter issues where the menu icon appears unintentionally in minimal `AppBar` configurations. --- ## Default Behavior (No Breaking Change) - The default value is `true`, so existing applications are **not affected**. - The new behavior is **opt-in** by setting `automaticallyImplyActions: false`. --- ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [ ] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing.  [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md

…r#9670) flutter/flutter@afba7d7...20788c0 2025-07-24 [email protected] Roll Packages from 9c85e5e to 963550c (4 revisions) (flutter/flutter#172696) 2025-07-24 [email protected] Add missing deprecations to CupertinoDynamicColor. (flutter/flutter#171160) 2025-07-24 [email protected] Roll Dart SDK from a181fe571dc8 to 26dece893751 (2 revisions) (flutter/flutter#172683) 2025-07-24 [email protected] Migrate to null aware elements - Part 1 (flutter/flutter#172198) 2025-07-24 [email protected] licenses_cpp: implements extracting regions from matched text (flutter/flutter#172655) 2025-07-24 [email protected] Roll pub packages (flutter/flutter#172677) 2025-07-24 [email protected] Marks Mac_ios keyboard_hot_restart_ios to be unflaky (flutter/flutter#168053) 2025-07-24 [email protected] Roll Abseil and remove a workaround for a Fuchsia target that was unable to build Abseil (flutter/flutter#172665) 2025-07-24 [email protected] Add `automaticallyImplyActions` property to AppBar (flutter/flutter#171113) 2025-07-24 [email protected] fix: TabBar fontFamily inheritance with custom label styles (flutter/flutter#171699) 2025-07-23 [email protected] Marks Linux_mokey new_gallery__crane_perf to be unflaky (flutter/flutter#167633) 2025-07-23 [email protected] [android] Fix broken `--android-skip-build-dependency-validation` flag (flutter/flutter#172581) 2025-07-23 [email protected] Fix: Ensure Text widget locale is included in semantics language tag (flutter/flutter#172034) 2025-07-23 [email protected] [Web][a11y] Update selected chips semantics (flutter/flutter#172660) 2025-07-23 [email protected] Roll Skia from eea1c33fbe84 to 094ac350125f (29 revisions) (flutter/flutter#172664) 2025-07-23 [email protected] Marks Mac_arm64_ios imitation_game_flutter to be unflaky (flutter/flutter#168052) 2025-07-23 [email protected] Roll Dart SDK from a31774a3d049 to a181fe571dc8 (2 revisions) (flutter/flutter#172667) 2025-07-23 [email protected] Adapt xcresult parser for Xcode 16 changes (flutter/flutter#172596) 2025-07-23 [email protected] Update excluded_files to match the current output of the old license checker (flutter/flutter#172670) 2025-07-23 [email protected] Manual Roll of Dart SDK from da9e0299c120 to a31774a3d049 (flutter/flutter#172616) 2025-07-23 [email protected] [FGP] Small restructuring of Android Studio native flutter dependency support (flutter/flutter#172651) 2025-07-23 [email protected] revert: Replaces legacy licenses check with licenses_cpp (flutter/flutter#172568) 2025-07-23 [email protected] fix: size-exp naming (flutter/flutter#172647) 2025-07-23 [email protected] Roll Fuchsia Test Scripts from MnFlN7VWM_7h7EmBV... to BWj3yYC74ud58QhN0... (flutter/flutter#172646) 2025-07-23 [email protected] [DisplayList] implement shadow bounds without relying on Skia utilities (flutter/flutter#172572) 2025-07-23 [email protected] Update `dev/bots/post_process_docs.dart` to use `flutter.version.json` (flutter/flutter#172601) 2025-07-23 [email protected] Emit a warning on `--[no-]disable-dds`, preferring `--no-dds` (flutter/flutter#172595) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md

## Summary - This PR adds a new boolean property `automaticallyImplyActions` to the `AppBar` widget. - It provides fine-grained control over whether an automatic menu icon (`Icons.menu`) is added when an `endDrawer` is present and `actions` are null or empty. ## Details ### Background In the current behavior of `AppBar`, if: - The `Scaffold` has a non-null `endDrawer`, and - The `AppBar.actions` is either `null` or an empty list `[]` Then Flutter **automatically inserts** a trailing menu icon (`Icons.menu`) into the `actions` list, which opens the `endDrawer`. ### New Behavior This PR introduces: ```dart final bool automaticallyImplyActions; // default: true ``` Developers can now control this behavior: - `automaticallyImplyActions: true` (default):\ The menu icon is automatically inserted when appropriate, as before. - `automaticallyImplyActions: false`:\ The `AppBar` will **not** add the automatic trailing menu icon, even if an `endDrawer` is present and `actions` are null or empty. ### All Possible Scenarios | `endDrawer` | `actions` | `automaticallyImplyActions` | Result | | ----------- | ----------------- | --------------------------- | ----------------------------------- | | ✅ present | `null` or `[]` | `true` (default) | Automatic menu icon is added | | ✅ present | `null` or `[]` | `false` | No menu icon is added | | ✅ present | `[customWidgets]` | `true` / `false` | Custom actions shown, no menu added | | ❌ absent | any value | any value | No menu icon is added | This provides predictable, developer-controlled behavior while maintaining backward compatibility. --- ## Use Case This change benefits developers who: - Want to **prevent automatic UI behaviors** when building custom app bars. - Need full control over the trailing icons without modifying internal logic. - Encounter issues where the menu icon appears unintentionally in minimal `AppBar` configurations. --- ## Default Behavior (No Breaking Change) - The default value is `true`, so existing applications are **not affected**. - The new behavior is **opt-in** by setting `automaticallyImplyActions: false`. --- ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [ ] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing.  [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md

…/flutter#171113)

## Summary - This PR adds a new boolean property `automaticallyImplyActions` to the `AppBar` widget. - It provides fine-grained control over whether an automatic menu icon (`Icons.menu`) is added when an `endDrawer` is present and `actions` are null or empty. ## Details ### Background In the current behavior of `AppBar`, if: - The `Scaffold` has a non-null `endDrawer`, and - The `AppBar.actions` is either `null` or an empty list `[]` Then Flutter **automatically inserts** a trailing menu icon (`Icons.menu`) into the `actions` list, which opens the `endDrawer`. ### New Behavior This PR introduces: ```dart final bool automaticallyImplyActions; // default: true ``` Developers can now control this behavior: - `automaticallyImplyActions: true` (default):\ The menu icon is automatically inserted when appropriate, as before. - `automaticallyImplyActions: false`:\ The `AppBar` will **not** add the automatic trailing menu icon, even if an `endDrawer` is present and `actions` are null or empty. ### All Possible Scenarios | `endDrawer` | `actions` | `automaticallyImplyActions` | Result | | ----------- | ----------------- | --------------------------- | ----------------------------------- | | ✅ present | `null` or `[]` | `true` (default) | Automatic menu icon is added | | ✅ present | `null` or `[]` | `false` | No menu icon is added | | ✅ present | `[customWidgets]` | `true` / `false` | Custom actions shown, no menu added | | ❌ absent | any value | any value | No menu icon is added | This provides predictable, developer-controlled behavior while maintaining backward compatibility. --- ## Use Case This change benefits developers who: - Want to **prevent automatic UI behaviors** when building custom app bars. - Need full control over the trailing icons without modifying internal logic. - Encounter issues where the menu icon appears unintentionally in minimal `AppBar` configurations. --- ## Default Behavior (No Breaking Change) - The default value is `true`, so existing applications are **not affected**. - The new behavior is **opt-in** by setting `automaticallyImplyActions: false`. --- ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [ ] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing.  [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md

k-arindam and others added 2 commits June 25, 2025 03:13

Merge branch 'flutter:master' into master

af74b03

github-actions bot added framework flutter/packages/flutter repository. See also f: labels. f: material design flutter/packages/flutter/material repository. labels Jun 24, 2025

Add unit tests for AppBar.automaticallyImplyActions & SliverAppBar.au…

e76857d

…tomaticallyImplyActions

github-actions bot added the f: scrolling Viewports, list views, slivers, etc. label Jun 25, 2025

dkwingsmt self-requested a review July 2, 2025 18:21

Merge branch 'master' into master

b43e03f

dkwingsmt approved these changes Jul 16, 2025

View reviewed changes

Merge branch 'master' into master

635ba7b

Piinks reviewed Jul 17, 2025

View reviewed changes

Merge branch 'master' into master

4b4b357

Merge branch 'master' into master

e613067

k-arindam added 3 commits July 19, 2025 01:22

Merge branch 'master' into master

9b40603

Merge branch 'master' into master

8c5ab43

Merge branch 'master' into master

44f34e9

k-arindam and others added 2 commits July 20, 2025 14:51

Merge branch 'master' into master

15ec1a1

Fixed formatting error in app_bar_test.dart

e539f2b

justinmc approved these changes Jul 21, 2025

View reviewed changes

packages/flutter/lib/src/material/app_bar.dart Outdated Show resolved Hide resolved

Updated comment in app_bar.dart

d1a4de9

dkwingsmt added the autosubmit Merge PR when tree becomes green via auto submit App label Jul 23, 2025

auto-submit bot added this pull request to the merge queue Jul 24, 2025

Merged via the queue into flutter:master with commit 2fbe939 Jul 24, 2025
70 of 71 checks passed

flutter-dashboard bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Jul 24, 2025

engine-flutter-autoroll mentioned this pull request Jul 24, 2025

Roll Flutter from afba7d75b391 to 79d77a138732 (26 revisions) flutter/packages#9669

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jul 24, 2025

2fbe9398b Add automaticallyImplyActions property to AppBar (flutter…

8d0449b

…/flutter#171113)

engine-flutter-autoroll mentioned this pull request Jul 24, 2025

Roll Flutter from afba7d75b391 to 20788c07fcb8 (27 revisions) flutter/packages#9670

Merged

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jul 24, 2025

2fbe9398b Add automaticallyImplyActions property to AppBar (flutter…

93c17f0

…/flutter#171113)

Piinks mentioned this pull request Jul 25, 2025

Flutter Notable Commits - 2025 #161460

Open

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Nov 12, 2025

2fbe9398b Add automaticallyImplyActions property to AppBar (flutter…

f22b565

…/flutter#171113)

Add automaticallyImplyActions property to AppBar #171113

Add automaticallyImplyActions property to AppBar #171113

Uh oh!

Conversation

k-arindam commented Jun 24, 2025

Summary

Details

Background

New Behavior

All Possible Scenarios

Use Case

Default Behavior (No Breaking Change)

Pre-launch Checklist

Uh oh!

flutter-dashboard bot commented Jun 24, 2025

Uh oh!

google-cla bot commented Jun 24, 2025

Uh oh!

nuuuron commented Jun 24, 2025

Rationale for automaticallyImplyActions

Uh oh!

dkwingsmt commented Jun 25, 2025

Uh oh!

k-arindam commented Jun 25, 2025

Uh oh!

nuuuron commented Jul 14, 2025

Uh oh!

k-arindam commented Jul 14, 2025

Uh oh!

dkwingsmt commented Jul 14, 2025

Uh oh!

dkwingsmt left a comment

Choose a reason for hiding this comment

Uh oh!

dkwingsmt commented Jul 17, 2025

Uh oh!

Piinks left a comment

Choose a reason for hiding this comment

Uh oh!

k-arindam commented Jul 18, 2025

Uh oh!

k-arindam commented Jul 18, 2025

Uh oh!

Piinks commented Jul 18, 2025

Uh oh!

dkwingsmt commented Jul 18, 2025

Uh oh!

k-arindam commented Jul 18, 2025

Uh oh!

dkwingsmt commented Jul 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

k-arindam commented Jul 20, 2025

Uh oh!

justinmc left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Add `automaticallyImplyActions` property to AppBar #171113

Add `automaticallyImplyActions` property to AppBar #171113

Rationale for `automaticallyImplyActions`

dkwingsmt commented Jul 18, 2025 •

edited

Loading

justinmc left a comment •

edited

Loading