シードからのパレット
どのテーマも 46 の色のロール (primary、on-primary、surface、surface-container、outline-variant、...) のパレットを持ちます。Flutter が持つ名前の中で最も揃っているので、名前は Material 3 のものです。Cupertino のアプリでは、ロールは二つの場所から来ます。colors.* の下に書いたものと、seed-color があれば、このスターターがそこから計算するパレットです。計算には Material も使う Material 3 の色の計算である material_color_utilities を使い、Material のウィジェットは一つも使いません。色は、同じシード、変種、コントラストから Material のアプリが持つものと同じです。
使う理由
- 一つの色からすべてを。 46 のロールを二つの明るさで持てば、揃えておくべき色は 92 になります。シードがあれば、一つのブランドカラーがすべてのロールを、どのサーフェスの上でもテキストが読みやすいトーンで与え、ダークのテーマは同じシードに
brightness: darkを付けるだけです。 - 両方のデザインで同じ色。 Android では Material、iOS では Cupertino のアプリはテーマを一つ持ちます。どちらのデザインもそこから同じパレットを作るので、ブランドは両方のプラットフォームで同じに見えます。
- ビルドに Material が入らない。 Cupertino のアプリは
material_uiなしでパレットを得ます。アプリのサイズ を参照してください。
例
# lib/resources/application.yml
spring:
flutter:
theme:
seed-color: '#0057B8'
scheme-variant: vibrant
colors:
error: '#FF3B30' # 手で指定: シードのものより優先される
cupertino:
bar-background-color: { color: $colors.surface-container, alpha: 85% }
themes:
dark:
brightness: dark # 同じシード、ダークのトーン
colors:
error: '#FF453A'
high-contrast:
extends: light
contrast: 1
spring.flutter.theme.seed-color=#0057B8
spring.flutter.theme.scheme-variant=vibrant
spring.flutter.theme.colors.error=#FF3B30
spring.flutter.theme.cupertino.bar-background-color.color=$colors.surface-container
spring.flutter.theme.cupertino.bar-background-color.alpha=85%
spring.flutter.theme.themes.dark.brightness=dark
spring.flutter.theme.themes.dark.colors.error=#FF453A
spring.flutter.theme.themes.high-contrast.extends=light
spring.flutter.theme.themes.high-contrast.contrast=1
明示的なロール
テーマにシードは必須ではありません。colors.* の下に書いたロールが、Flutter のベースラインのパレット (Material 3 のベースライン) の上に重なってパレットになります。これはデザインのスターターの有無にかかわらず、すべてのアプリで動きます。iOS の見た目は、Apple のシステムカラーを使ってこの方法で書かれることがよくあります。
spring:
flutter:
theme:
colors:
primary: '#007AFF'
on-primary: '#FFFFFF'
secondary: '#34C759'
tertiary: '#FF9500'
error: '#FF3B30'
surface: '#F2F2F7'
on-surface: '#000000'
surface-container-lowest: '#FFFFFF'
outline: '#C6C6C8'
outline-variant: { color: $colors.outline, alpha: 50% }
これらのロールのうち二つは CupertinoThemeData にも入ります。cupertino.* が設定しなければ、colors.primary がその primary の色に、colors.surface がそのスキャフォールドの背景になります (テーマのプロパティ を参照)。すべてのロールは、アプリ独自のウィジェット (SpringTheme.of(context).colorScheme) とテーマのすべての値 ($colors.outline) に届きます。46 のロールについては 色 を参照してください。
シードと明示的なロールは組み合わせられます。シードがすべてのロールを作り、colors.* の下のロールがそれぞれのものを置き換えます。
シード、変種、コントラスト
| キー | 値 | デフォルト | 働き |
|---|---|---|---|
spring.flutter.theme.seed-color |
色: #RRGGBB、Colors の名前、参照 |
なし: Flutter のベースラインのパレット | パレットを作る元の色 |
spring.flutter.theme.scheme-variant |
tonalSpot、fidelity、monochrome、neutral、vibrant、expressive、content、rainbow、fruitSalad。どの書き方でも可 (tonal-spot) |
tonalSpot |
Material 3 のどのアルゴリズムでパレットを作るか |
spring.flutter.theme.contrast |
-1 から 1 の数値 |
0 |
色とその上に表示される色の間のコントラスト。1 は高コントラストのレベル、-1 はコントラストを下げたもの |
それぞれテーマごとに設定できます (themes.<name>.seed-color)。seed-color なしの変種やコントラストは、Material 3 のベースラインのシード (#6750A4) を使います。三つのどれもなければ、テーマは Flutter のベースラインのパレットを持ち、デザインのスターターは必要ありません。各変種の見た目は Material スターターのパレット にあります。
パレットは次の順序で作られます。
- テーマの明るさのパレット: Flutter のベースライン、またはシード、変種、コントラストがあれば Material 3 のアルゴリズムによるもの。
- その上に
colors.*のロール。 - 参照:
$colors.primaryを参照する値は最終的なprimaryを受け取り、誰も宣言していないロールへの参照 ($colors.surface-container) は手順 1 のパレットを読みます。
パレットが現れる場所
- アプリ独自のウィジェットで。
SpringTheme.of(context).colorSchemeはすべてのロール (surfaceContainer、outlineVariant、...) を持ちます。 - テーマの値で。
$colors.<role>はすべてのロールに届くので、cupertino.*、スタイル、ローダー、トークンはシードに従います。 CupertinoThemeDataで。cupertino.primary-colorもcolors.primaryも設定されておらず、テーマがseed-colorを持っていれば、その primary の色はパレットの primary です。他のロールは自動では入りません。colors.surfaceかcupertino.scaffold-background-colorが設定されていなければ、スキャフォールドは iOS の背景のままなので、シードだけでは iOS のグレーと白は塗り替えられません。使いたいロールを参照してください:scaffold-background-color: $colors.surface。
final scheme = SpringTheme.of(context).colorScheme;
return Container(
color: scheme.surfaceContainer,
child: Text('NEON', style: TextStyle(color: scheme.onSurface)),
);
Material と同じ色
スターターは、Flutter の ColorScheme.fromSeed とまったく同じように Material Color Utilities のアルゴリズムを呼び出します。同じ変種のクラス、同じコントラストのレベル、そして primary の色としてのサーフェスの色合い (surface tint) です。スターターのテストは、八つのシード、両方の明るさ、すべての変種、四つのコントラストについて、46 のロールすべてを ColorScheme.fromSeed と比較しています。
両方のデザインのスターターを持つアプリでは、パレットはアプリの種類のデザインが作り、どちらも同じ色を与えます。
アプリのサイズ
Flutter 3.50 以降、Material は SDK の一部ではなくパッケージ material_ui であり、アプリはそれに依存するときだけそれを持ちます。Material 3 のパレットが欲しい Cupertino のアプリは、ColorScheme.fromSeed という一つの関数のために material_ui に依存しなければならないところです。このスターターは代わりに material_color_utilities に依存します。ウィジェットを持たない純粋な Dart の色の計算で、material_ui 自身が計算に使うのと同じパッケージです。アプリの依存関係に Material は含まれないので、ビルドに Material が紛れ込むことはなく、Material のウィジェットをうっかりインポートすることもありません。
デザインライブラリの重さは、Flutter 3.50 でビルドされた Flutter の Web アプリであるこのサイトに表れています。そのバンドルは、Material と Cupertino を持っていた 0.7 のスターターでの 4.39 MB から、デザインライブラリなしで 3.53 MB になりました (ビルドのサイズ を参照)。
デザインのスターターなしで
seed-color、scheme-variant、contrast には、このスターターか Material のスターター のどちらかのデザインのスターターが必要です。どちらもなければ起動を止めるので、デザインライブラリのないアプリは代わりにロールを colors.* の下に書きます。
Invalid theme property spring.flutter.theme.seed-color (theme light): '#0057B8'; expected a design starter in the dependencies: seed-color, scheme-variant and contrast make a Material 3 palette, which spring_boot_starter_flutter_material (or spring_boot_starter_flutter_cupertino) calculates. Without one, set the roles under colors.
色でない値、未知の変種、-1 から 1 の範囲外のコントラストも、プロパティの名前を挙げて起動を止めます。
関連項目
- 色: ロール、変種、コントラスト、色の値
- Material のスターターのパレット
- テーマのプロパティ
- デザインライブラリ