
# シードからのパレット

どのテーマも 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` なしでパレットを得ます。[アプリのサイズ](#アプリのサイズ) を参照してください。

## 例

```yaml
# 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
```

```properties
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 のシステムカラーを使ってこの方法で書かれることがよくあります。

```yaml
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` がそのスキャフォールドの背景になります ([テーマのプロパティ](theme-properties.md) を参照)。すべてのロールは、アプリ独自のウィジェット (`SpringTheme.of(context).colorScheme`) とテーマのすべての値 (`$colors.outline`) に届きます。46 のロールについては [色](../spring-boot-starter-flutter/themes/colors.md#色のロール) を参照してください。

シードと明示的なロールは組み合わせられます。シードがすべてのロールを作り、`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 スターターのパレット](../spring-boot-starter-flutter-material/palette.md#スキームの変種) にあります。

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

1. テーマの明るさのパレット: Flutter のベースライン、またはシード、変種、コントラストがあれば Material 3 のアルゴリズムによるもの。
2. その上に `colors.*` のロール。
3. 参照: `$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`。

```dart
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 になりました ([ビルドのサイズ](../spring-boot-starter-flutter/design-libraries.md#ビルドのサイズ) を参照)。

## デザインのスターターなしで

`seed-color`、`scheme-variant`、`contrast` には、このスターターか [Material のスターター](../spring-boot-starter-flutter-material/palette.md) のどちらかのデザインのスターターが必要です。どちらもなければ起動を止めるので、デザインライブラリのないアプリは代わりにロールを `colors.*` の下に書きます。

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

## 関連項目

- [色](../spring-boot-starter-flutter/themes/colors.md): ロール、変種、コントラスト、色の値
- [Material のスターターのパレット](../spring-boot-starter-flutter-material/palette.md)
- [テーマのプロパティ](theme-properties.md)
- [デザインライブラリ](../spring-boot-starter-flutter/design-libraries.md)
