☂️ Umbrella issue for Material2 API doc updates

[leighajarett]

Is there an existing issue for this?

• I have searched the existing issues
• I have read the guide to filing a bug

Use case

As we prepare to make Material 3 the default, we should make it clear that while Material 2 widgets will continue to exist, some have Material 3 counterparts that may be more useful and better match Material 3 app styles.

Proposal

There are a few Material 2 widgets whose API docs need to be updated:

M2 widget	M3 widget	Tracking issue / PR
ToggleButtons	SegmentedButtons	Updated the ToggleButtons API doc to link to SegmentedButton #127021
BottomNavigationBar	NavigationBar	Update BottomNavigationBar API docs with details on migrating to NavigationBar #127213
Drawer	NavigationDrawer	Update API docs for Drawer to help developers migrate to NavigationDrawer #127214
DropdownButton	DropDownMenu	Update API docs to help developers move to Material 3 style menus #127215
PopupMenuButton	MenuAnchor	Update API docs to help developers move to Material 3 style menus #127215
MaterialColor	ColorScheme	Update MaterialColor API docs to migrate to ColorScheme for Material3 apps #127228
ButtonBar	OverflowBar	Update ButtonBar API docs to show how to migrate to OverflowBar #128430
ActionChip	Showcase suggest and assist	Update ActionChip documentation to showcase assist and suggestion chip from M3 specs #128028
ThemeData	List out the properties that should be used for Material3	Tell developers how to migrate their ThemeData & textTheme widgets over to Material3 #130949

[github-actions]

This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

[guidezpl]

Great list, thank you.

I would also add ColorScheme.fromSwatch ⇒ ColorScheme.fromSeed and ColorScheme.fromImageProvider

For posterity, there are also:

• new constructors: IconButton.filled, IconButton.filledTonal, and IconButton.outlined, TabBar.secondary,
• new top-level widgets: SearchBar and SearchAnchor

But I think these are well enough documented among themselves.

[HansMuller]

We should also provide a way to issue runtime advice about M2-M3 migration, see #130932 (comment)

[flutter-triage-bot]

This issue is assigned to @leighajarett but has had no recent status updates. Please consider unassigning this issue if it is not going to be addressed in the near future. This allows people to have a clearer picture of what work is actually planned. Thanks!

[flutter-triage-bot]

This issue was assigned to @leighajarett but has had no status updates in a long time. To remove any ambiguity about whether the issue is being worked on, the assignee was removed.

[HansMuller]

@TahaTesser, @Piinks - I think that you-all have resolved the final unchecked issue on this one.

[TahaTesser]

@TahaTesser, @Piinks - I think that you-all have resolved the final unchecked issue on this one.

I think so, checking the issue i don't see any immediate actionable item.

The text theme can be automatically fixed for M3 using dart fix --apply, this replaces the deprecated text theme props.

As for other theme data props, we have #91772 which lists deprecated/to be deprecated props which are ineffective for Material 3 widgets and some Material 2 widgets too.

[Piinks]

Thanks for taking a look @TahaTesser! I concur, should we close this then and follow up in #91772?

[TahaTesser]

@TahaTesser, @Piinks - I think that you-all have resolved the final unchecked issue on this one.

Closed the final unchecked issue. With that, this issue can be closed.

[github-actions]

This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.