シードからのパレット

どのテーマも 46 の色のロール (primary、on-primary、surface、surface-container、outline-variant、...) のパレットを持ちます。Flutter が持つ名前の中で最も揃っているので、名前は Material 3 のものです。Cupertino のアプリでは、ロールは二つの場所から来ます。colors.* の下に書いたものと、seed-color があれば、このスターターがそこから計算するパレットです。計算には Material も使う Material 3 の色の計算である material_color_utilities を使い、Material のウィジェットは一つも使いません。色は、同じシード、変種、コントラストから Material のアプリが持つものと同じです。

使う理由

例

# 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 スターターのパレット にあります。

パレットは次の順序で作られます。

  1. テーマの明るさのパレット: Flutter のベースライン、またはシード、変種、コントラストがあれば Material 3 のアルゴリズムによるもの。
  2. その上に colors.* のロール。
  3. 参照: $colors.primary を参照する値は最終的な primary を受け取り、誰も宣言していないロールへの参照 ($colors.surface-container) は手順 1 のパレットを読みます。

パレットが現れる場所

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 の範囲外のコントラストも、プロパティの名前を挙げて起動を止めます。

関連項目