Skip to content

Commit 0dfacae

Browse files
authored
[material_ui] Add contrastLevel for M3 ColorScheme (flutter#12743)
This PR is to port flutter/packages#11801 ### Original PR Description Fixes flutter#184951 Fixes flutter#188409 This PR is to add medium- and high-contrast M3 ColorScheme baselines. I also added a `double? contrastLevel` to `ThemeData`. By default, `ThemeData()` shows standard M3 ColorScheme. To choose medium/high contrast, use ``` ThemeData( // brightness: Brightness.dark shows dark version of the baselines. contrastLevel: ContrastLevel.medium, // ContrastLevel.high ) ``` This change will not cause breaking changes because the standard-contrast m3 color scheme baseline stays the same. <img width="1181" height="526" alt="Screenshot 2026-07-31 at 4 35 36 PM" src="https://github.com/user-attachments/assets/0515a722-1455-49a0-9c5d-30ffaa844b7f" /> TODO: Add an example or update an existing example to reflect the new feature. ## Pre-Review Checklist
1 parent c4ee37c commit 0dfacae

11 files changed

Lines changed: 920 additions & 401 deletions

File tree

‎packages/material_ui/lib/src/color_scheme.dart‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2011,7 +2011,8 @@ class ColorScheme with Diagnosticable {
20112011
double contrastLevel,
20122012
) {
20132013
assert(
2014-
contrastLevel >= -1.0 && contrastLevel <= 1.0,
2014+
contrastLevel + precisionErrorTolerance >= -1.0 &&
2015+
contrastLevel - precisionErrorTolerance <= 1.0,
20152016
'contrastLevel must be between -1.0 and 1.0 inclusive.',
20162017
);
20172018
final isDark = brightness == Brightness.dark;
Lines changed: 324 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,324 @@
1+
// Copyright 2013 The Flutter Authors
2+
// Use of this source code is governed by a BSD-style license that can be
3+
// found in the LICENSE file.
4+
5+
// Do not edit by hand. The code is generated from data in the Material
6+
// Design token database by the script:
7+
// packages/material_ui/tool/gen_defaults/bin/gen_defaults.dart.
8+
part of '../theme_data.dart';
9+
10+
const ColorScheme _colorSchemeLightM3 = ColorScheme(
11+
brightness: Brightness.light,
12+
primary: Color(0xFF6750A4),
13+
onPrimary: Color(0xFFFFFFFF),
14+
primaryContainer: Color(0xFFEADDFF),
15+
onPrimaryContainer: Color(0xFF4F378B),
16+
primaryFixed: Color(0xFFEADDFF),
17+
primaryFixedDim: Color(0xFFD0BCFF),
18+
onPrimaryFixed: Color(0xFF21005D),
19+
onPrimaryFixedVariant: Color(0xFF4F378B),
20+
secondary: Color(0xFF625B71),
21+
onSecondary: Color(0xFFFFFFFF),
22+
secondaryContainer: Color(0xFFE8DEF8),
23+
onSecondaryContainer: Color(0xFF4A4458),
24+
secondaryFixed: Color(0xFFE8DEF8),
25+
secondaryFixedDim: Color(0xFFCCC2DC),
26+
onSecondaryFixed: Color(0xFF1D192B),
27+
onSecondaryFixedVariant: Color(0xFF4A4458),
28+
tertiary: Color(0xFF7D5260),
29+
onTertiary: Color(0xFFFFFFFF),
30+
tertiaryContainer: Color(0xFFFFD8E4),
31+
onTertiaryContainer: Color(0xFF633B48),
32+
tertiaryFixed: Color(0xFFFFD8E4),
33+
tertiaryFixedDim: Color(0xFFEFB8C8),
34+
onTertiaryFixed: Color(0xFF31111D),
35+
onTertiaryFixedVariant: Color(0xFF633B48),
36+
error: Color(0xFFB3261E),
37+
onError: Color(0xFFFFFFFF),
38+
errorContainer: Color(0xFFF9DEDC),
39+
onErrorContainer: Color(0xFF8C1D18),
40+
background: Color(0xFFFEF7FF),
41+
onBackground: Color(0xFF1D1B20),
42+
surface: Color(0xFFFEF7FF),
43+
surfaceBright: Color(0xFFFEF7FF),
44+
surfaceContainerLowest: Color(0xFFFFFFFF),
45+
surfaceContainerLow: Color(0xFFF7F2FA),
46+
surfaceContainer: Color(0xFFF3EDF7),
47+
surfaceContainerHigh: Color(0xFFECE6F0),
48+
surfaceContainerHighest: Color(0xFFE6E0E9),
49+
surfaceDim: Color(0xFFDED8E1),
50+
onSurface: Color(0xFF1D1B20),
51+
surfaceVariant: Color(0xFFE7E0EC),
52+
onSurfaceVariant: Color(0xFF49454F),
53+
outline: Color(0xFF79747E),
54+
outlineVariant: Color(0xFFCAC4D0),
55+
shadow: Color(0xFF000000),
56+
scrim: Color(0xFF000000),
57+
inverseSurface: Color(0xFF322F35),
58+
onInverseSurface: Color(0xFFF5EFF7),
59+
inversePrimary: Color(0xFFD0BCFF),
60+
);
61+
62+
const ColorScheme _colorSchemeDarkM3 = ColorScheme(
63+
brightness: Brightness.dark,
64+
primary: Color(0xFFD0BCFF),
65+
onPrimary: Color(0xFF381E72),
66+
primaryContainer: Color(0xFF4F378B),
67+
onPrimaryContainer: Color(0xFFEADDFF),
68+
primaryFixed: Color(0xFFEADDFF),
69+
primaryFixedDim: Color(0xFFD0BCFF),
70+
onPrimaryFixed: Color(0xFF21005D),
71+
onPrimaryFixedVariant: Color(0xFF4F378B),
72+
secondary: Color(0xFFCCC2DC),
73+
onSecondary: Color(0xFF332D41),
74+
secondaryContainer: Color(0xFF4A4458),
75+
onSecondaryContainer: Color(0xFFE8DEF8),
76+
secondaryFixed: Color(0xFFE8DEF8),
77+
secondaryFixedDim: Color(0xFFCCC2DC),
78+
onSecondaryFixed: Color(0xFF1D192B),
79+
onSecondaryFixedVariant: Color(0xFF4A4458),
80+
tertiary: Color(0xFFEFB8C8),
81+
onTertiary: Color(0xFF492532),
82+
tertiaryContainer: Color(0xFF633B48),
83+
onTertiaryContainer: Color(0xFFFFD8E4),
84+
tertiaryFixed: Color(0xFFFFD8E4),
85+
tertiaryFixedDim: Color(0xFFEFB8C8),
86+
onTertiaryFixed: Color(0xFF31111D),
87+
onTertiaryFixedVariant: Color(0xFF633B48),
88+
error: Color(0xFFF2B8B5),
89+
onError: Color(0xFF601410),
90+
errorContainer: Color(0xFF8C1D18),
91+
onErrorContainer: Color(0xFFF9DEDC),
92+
background: Color(0xFF141218),
93+
onBackground: Color(0xFFE6E0E9),
94+
surface: Color(0xFF141218),
95+
surfaceBright: Color(0xFF3B383E),
96+
surfaceContainerLowest: Color(0xFF0F0D13),
97+
surfaceContainerLow: Color(0xFF1D1B20),
98+
surfaceContainer: Color(0xFF211F26),
99+
surfaceContainerHigh: Color(0xFF2B2930),
100+
surfaceContainerHighest: Color(0xFF36343B),
101+
surfaceDim: Color(0xFF141218),
102+
onSurface: Color(0xFFE6E0E9),
103+
surfaceVariant: Color(0xFF49454F),
104+
onSurfaceVariant: Color(0xFFCAC4D0),
105+
outline: Color(0xFF938F99),
106+
outlineVariant: Color(0xFF49454F),
107+
shadow: Color(0xFF000000),
108+
scrim: Color(0xFF000000),
109+
inverseSurface: Color(0xFFE6E0E9),
110+
onInverseSurface: Color(0xFF322F35),
111+
inversePrimary: Color(0xFF6750A4),
112+
);
113+
114+
const ColorScheme _colorSchemeLightMediumContrastM3 = ColorScheme(
115+
brightness: Brightness.light,
116+
primary: Color(0xFF4F378B),
117+
onPrimary: Color(0xFFFFFFFF),
118+
primaryContainer: Color(0xFF6750A4),
119+
onPrimaryContainer: Color(0xFFFFFFFF),
120+
primaryFixed: Color(0xFF6750A4),
121+
primaryFixedDim: Color(0xFF4F378B),
122+
onPrimaryFixed: Color(0xFFFFFFFF),
123+
onPrimaryFixedVariant: Color(0xFFFFFFFF),
124+
secondary: Color(0xFF4A4458),
125+
onSecondary: Color(0xFFFFFFFF),
126+
secondaryContainer: Color(0xFF625B71),
127+
onSecondaryContainer: Color(0xFFFFFFFF),
128+
secondaryFixed: Color(0xFF625B71),
129+
secondaryFixedDim: Color(0xFF4A4458),
130+
onSecondaryFixed: Color(0xFFFFFFFF),
131+
onSecondaryFixedVariant: Color(0xFFFFFFFF),
132+
tertiary: Color(0xFF633B48),
133+
onTertiary: Color(0xFFFFFFFF),
134+
tertiaryContainer: Color(0xFF7D5260),
135+
onTertiaryContainer: Color(0xFFFFFFFF),
136+
tertiaryFixed: Color(0xFF7D5260),
137+
tertiaryFixedDim: Color(0xFF633B48),
138+
onTertiaryFixed: Color(0xFFFFFFFF),
139+
onTertiaryFixedVariant: Color(0xFFFFFFFF),
140+
error: Color(0xFF8C1D18),
141+
onError: Color(0xFFFFFFFF),
142+
errorContainer: Color(0xFFB3261E),
143+
onErrorContainer: Color(0xFFFFFFFF),
144+
onBackground: Color(0xFF000000),
145+
onSurface: Color(0xFF000000),
146+
onSurfaceVariant: Color(0xFF322F37),
147+
outline: Color(0xFF49454F),
148+
outlineVariant: Color(0xFF79747E),
149+
onInverseSurface: Color(0xFFFFFFFF),
150+
// These roles fall back to the default light tokens.
151+
background: Color(0xFFFEF7FF),
152+
surface: Color(0xFFFEF7FF),
153+
surfaceBright: Color(0xFFFEF7FF),
154+
surfaceContainerLowest: Color(0xFFFFFFFF),
155+
surfaceContainerLow: Color(0xFFF7F2FA),
156+
surfaceContainer: Color(0xFFF3EDF7),
157+
surfaceContainerHigh: Color(0xFFECE6F0),
158+
surfaceContainerHighest: Color(0xFFE6E0E9),
159+
surfaceDim: Color(0xFFDED8E1),
160+
surfaceVariant: Color(0xFFE7E0EC),
161+
shadow: Color(0xFF000000),
162+
scrim: Color(0xFF000000),
163+
inverseSurface: Color(0xFF322F35),
164+
inversePrimary: Color(0xFFD0BCFF),
165+
);
166+
167+
const ColorScheme _colorSchemeLightHighContrastM3 = ColorScheme(
168+
brightness: Brightness.light,
169+
primary: Color(0xFF381E72),
170+
onPrimary: Color(0xFFFFFFFF),
171+
primaryContainer: Color(0xFF4F378B),
172+
onPrimaryContainer: Color(0xFFFFFFFF),
173+
primaryFixed: Color(0xFF4F378B),
174+
primaryFixedDim: Color(0xFF381E72),
175+
onPrimaryFixed: Color(0xFFFFFFFF),
176+
onPrimaryFixedVariant: Color(0xFFFFFFFF),
177+
secondary: Color(0xFF332D41),
178+
onSecondary: Color(0xFFFFFFFF),
179+
secondaryContainer: Color(0xFF4A4458),
180+
onSecondaryContainer: Color(0xFFFFFFFF),
181+
secondaryFixed: Color(0xFF4A4458),
182+
secondaryFixedDim: Color(0xFF332D41),
183+
onSecondaryFixed: Color(0xFFFFFFFF),
184+
onSecondaryFixedVariant: Color(0xFFFFFFFF),
185+
tertiary: Color(0xFF492532),
186+
onTertiary: Color(0xFFFFFFFF),
187+
tertiaryContainer: Color(0xFF633B48),
188+
onTertiaryContainer: Color(0xFFFFFFFF),
189+
tertiaryFixed: Color(0xFF633B48),
190+
tertiaryFixedDim: Color(0xFF492532),
191+
onTertiaryFixed: Color(0xFFFFFFFF),
192+
onTertiaryFixedVariant: Color(0xFFFFFFFF),
193+
error: Color(0xFF601410),
194+
onError: Color(0xFFFFFFFF),
195+
errorContainer: Color(0xFF8C1D18),
196+
onErrorContainer: Color(0xFFFFFFFF),
197+
onBackground: Color(0xFF000000),
198+
onSurface: Color(0xFF000000),
199+
onSurfaceVariant: Color(0xFF000000),
200+
outline: Color(0xFF322F37),
201+
outlineVariant: Color(0xFF49454F),
202+
onInverseSurface: Color(0xFFFFFFFF),
203+
// These roles fall back to the default light tokens.
204+
background: Color(0xFFFEF7FF),
205+
surface: Color(0xFFFEF7FF),
206+
surfaceBright: Color(0xFFFEF7FF),
207+
surfaceContainerLowest: Color(0xFFFFFFFF),
208+
surfaceContainerLow: Color(0xFFF7F2FA),
209+
surfaceContainer: Color(0xFFF3EDF7),
210+
surfaceContainerHigh: Color(0xFFECE6F0),
211+
surfaceContainerHighest: Color(0xFFE6E0E9),
212+
surfaceDim: Color(0xFFDED8E1),
213+
surfaceVariant: Color(0xFFE7E0EC),
214+
shadow: Color(0xFF000000),
215+
scrim: Color(0xFF000000),
216+
inverseSurface: Color(0xFF322F35),
217+
inversePrimary: Color(0xFFD0BCFF),
218+
);
219+
220+
const ColorScheme _colorSchemeDarkMediumContrastM3 = ColorScheme(
221+
brightness: Brightness.dark,
222+
primary: Color(0xFFEADDFF),
223+
onPrimary: Color(0xFF21005D),
224+
primaryContainer: Color(0xFF9A82DB),
225+
onPrimaryContainer: Color(0xFF000000),
226+
primaryFixed: Color(0xFFEADDFF),
227+
primaryFixedDim: Color(0xFFD0BCFF),
228+
onPrimaryFixed: Color(0xFF000000),
229+
onPrimaryFixedVariant: Color(0xFF381E72),
230+
secondary: Color(0xFFE8DEF8),
231+
onSecondary: Color(0xFF1D192B),
232+
secondaryContainer: Color(0xFF958DA5),
233+
onSecondaryContainer: Color(0xFF000000),
234+
secondaryFixed: Color(0xFFE8DEF8),
235+
secondaryFixedDim: Color(0xFFCCC2DC),
236+
onSecondaryFixed: Color(0xFF000000),
237+
onSecondaryFixedVariant: Color(0xFF332D41),
238+
tertiary: Color(0xFFFFD8E4),
239+
onTertiary: Color(0xFF31111D),
240+
tertiaryContainer: Color(0xFFB58392),
241+
onTertiaryContainer: Color(0xFF000000),
242+
tertiaryFixed: Color(0xFFFFD8E4),
243+
tertiaryFixedDim: Color(0xFFEFB8C8),
244+
onTertiaryFixed: Color(0xFF000000),
245+
onTertiaryFixedVariant: Color(0xFF492532),
246+
error: Color(0xFFF9DEDC),
247+
onError: Color(0xFF410E0B),
248+
errorContainer: Color(0xFFE46962),
249+
onErrorContainer: Color(0xFF000000),
250+
onBackground: Color(0xFFFFFFFF),
251+
onSurface: Color(0xFFFFFFFF),
252+
onSurfaceVariant: Color(0xFFE7E0EC),
253+
outline: Color(0xFFAEA9B4),
254+
outlineVariant: Color(0xFF938F99),
255+
onInverseSurface: Color(0xFF1D1B20),
256+
inversePrimary: Color(0xFF4F378B),
257+
// These roles fall back to the default dark tokens.
258+
background: Color(0xFF141218),
259+
surface: Color(0xFF141218),
260+
surfaceBright: Color(0xFF3B383E),
261+
surfaceContainerLowest: Color(0xFF0F0D13),
262+
surfaceContainerLow: Color(0xFF1D1B20),
263+
surfaceContainer: Color(0xFF211F26),
264+
surfaceContainerHigh: Color(0xFF2B2930),
265+
surfaceContainerHighest: Color(0xFF36343B),
266+
surfaceDim: Color(0xFF141218),
267+
surfaceVariant: Color(0xFF49454F),
268+
shadow: Color(0xFF000000),
269+
scrim: Color(0xFF000000),
270+
inverseSurface: Color(0xFFE6E0E9),
271+
);
272+
273+
const ColorScheme _colorSchemeDarkHighContrastM3 = ColorScheme(
274+
brightness: Brightness.dark,
275+
primary: Color(0xFFF6EDFF),
276+
onPrimary: Color(0xFF000000),
277+
primaryContainer: Color(0xFFD0BCFF),
278+
onPrimaryContainer: Color(0xFF000000),
279+
primaryFixed: Color(0xFFEADDFF),
280+
primaryFixedDim: Color(0xFFD0BCFF),
281+
onPrimaryFixed: Color(0xFF000000),
282+
onPrimaryFixedVariant: Color(0xFF000000),
283+
secondary: Color(0xFFF6EDFF),
284+
onSecondary: Color(0xFF000000),
285+
secondaryContainer: Color(0xFFCCC2DC),
286+
onSecondaryContainer: Color(0xFF000000),
287+
secondaryFixed: Color(0xFFE8DEF8),
288+
secondaryFixedDim: Color(0xFFCCC2DC),
289+
onSecondaryFixed: Color(0xFF000000),
290+
onSecondaryFixedVariant: Color(0xFF000000),
291+
tertiary: Color(0xFFFFECF1),
292+
onTertiary: Color(0xFF000000),
293+
tertiaryContainer: Color(0xFFEFB8C8),
294+
onTertiaryContainer: Color(0xFF000000),
295+
tertiaryFixed: Color(0xFFFFD8E4),
296+
tertiaryFixedDim: Color(0xFFEFB8C8),
297+
onTertiaryFixed: Color(0xFF000000),
298+
onTertiaryFixedVariant: Color(0xFF000000),
299+
error: Color(0xFFFCEEEE),
300+
onError: Color(0xFF000000),
301+
errorContainer: Color(0xFFF2B8B5),
302+
onErrorContainer: Color(0xFF000000),
303+
onBackground: Color(0xFFFFFFFF),
304+
onSurface: Color(0xFFFFFFFF),
305+
onSurfaceVariant: Color(0xFFFFFFFF),
306+
outline: Color(0xFFF5EEFA),
307+
outlineVariant: Color(0xFFCAC4D0),
308+
onInverseSurface: Color(0xFF000000),
309+
inversePrimary: Color(0xFF381E72),
310+
// These roles fall back to the default dark tokens.
311+
background: Color(0xFF141218),
312+
surface: Color(0xFF141218),
313+
surfaceBright: Color(0xFF3B383E),
314+
surfaceContainerLowest: Color(0xFF0F0D13),
315+
surfaceContainerLow: Color(0xFF1D1B20),
316+
surfaceContainer: Color(0xFF211F26),
317+
surfaceContainerHigh: Color(0xFF2B2930),
318+
surfaceContainerHighest: Color(0xFF36343B),
319+
surfaceDim: Color(0xFF141218),
320+
surfaceVariant: Color(0xFF49454F),
321+
shadow: Color(0xFF000000),
322+
scrim: Color(0xFF000000),
323+
inverseSurface: Color(0xFFE6E0E9),
324+
);

0 commit comments

Comments
 (0)