Repository navigation
Update MaterialColor API docs to migrate to ColorScheme for Material3 apps #127228
Description
Is there an existing issue for this?
- I have searched the existing issues
- I have read the guide to filing a bug
Use case
I'm new to Flutter and I'm trying to configure a custom color scheme while respecting Material 3 color conventions. According to the Material 3 documentation, a tonal palette consists of thirteen tones, including white and black. A tone value of 100 represents maximum lightness and results in white. Each tone value between 0 and 100 expresses the amount of light present in the color.
I'm attempting to use the MaterialColor class to implement my custom colors, but it seems to be following the Material 2 convention instead.
I have referred to the Material 3 documentation (https://m3.material.io/styles/color/the-color-system/key-colors-tones#6bdb9471-b70d-42c9-8ace-76743c1fff13) and noticed that the color system and conventions described there differ from what I'm experiencing with the MaterialColor class.
Here are some screenshots illustrating the differences:
Material 3 Color Conventions:
MaterialColor class:
Material 2 Color Conventions:
https://m2.material.io/design/color/the-color-system.html#color-usage-and-palettes
Proposal
Maybe an update to that class to support new Material 3 colors conventions?
Activity
[-]MaterialColor inconsistencies with Material 3?[/-][+][Proposal] Make MaterialColor consistent with Material 3[/+]leighajarett commentedon Jun 6, 2023
Hi there! Thanks for filing this. Actually we have a new class specific to Material3 colors called ColorScheme - https://api.flutter.dev/flutter/material/ColorScheme-class.html. I'm adding an example to the MaterialColor API docs to make it clear that for Material 3 design you should use the ColorScheme class.
[-][Proposal] Make MaterialColor consistent with Material 3[/-][+]Update MaterialColor API docs to migrate to ColorScheme for Material3 apps[/+]Adding migration guide for Material 3 colors (#128429)
github-actions commentedon Jun 23, 2023
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 -vand a minimal reproduction of the issue.Adding migration guide for Material 3 colors (#128429)
Adding migration guide for Material 3 colors (#128429)
Adding migration guide for Material 3 colors (#128429)