
# 密度とインク

テーマの三つのプロパティは Material だけのものです。`visual-density` は Material のコントロールをどれだけ詰めて並べるか、`tap-target-size` はタップが当たる領域の大きさ、そして一語で書く `splash` は、コントロールがタップされた場所に広がるインクです。これらは、書かれたすべてのテーマの `ThemeData.visualDensity`、`ThemeData.materialTapTargetSize`、`ThemeData.splashFactory` を設定します。

## 使う理由

Flutter は三つともプラットフォームごとに選びます。デスクトップではコンパクトで詰まった配置、スマートフォンではゆったりとした余白付きの配置、Android ではスパークル、それ以外ではリップルです。どこでも同じ見た目にしたいアプリ、大きな画面のツールのために密なレイアウトにしたいアプリ、ブランドのデザインのためにインクをまったく出したくないアプリは、それをウィジェットごとではなく、テーマで一度だけ設定します。テーマのプロパティなので、テーマごと、プロファイルごと、プラットフォームごと (`application-desktop.yml`) に変えられます。

## 例

```yaml
# lib/resources/application.yml
spring:
  flutter:
    theme:
      visual-density: compact
      tap-target-size: shrink-wrap
      splash: ripple
      themes:
        touch:
          visual-density: standard
          tap-target-size: padded
          splash: sparkle
```

```properties
spring.flutter.theme.visual-density=compact
spring.flutter.theme.tap-target-size=shrink-wrap
spring.flutter.theme.splash=ripple
spring.flutter.theme.themes.touch.visual-density=standard
spring.flutter.theme.themes.touch.tap-target-size=padded
spring.flutter.theme.themes.touch.splash=sparkle
```

デスクトップでだけ密なデスクトップの見た目にするには、プラットフォームのプロファイルを使います。

```yaml
# lib/resources/application-desktop.yml
spring.flutter.theme:
  visual-density: compact
  tap-target-size: shrink-wrap
```

## プロパティ

| キー | 値 | デフォルト | `ThemeData` では |
|---|---|---|---|
| `spring.flutter.theme.visual-density` | `adaptive`、`standard`、`comfortable`、`compact` | Flutter のもの: Android、iOS、Fuchsia では `standard`、macOS、Windows、Linux では `compact` | `visualDensity` |
| `spring.flutter.theme.tap-target-size` | `padded`、`shrink-wrap` (`shrinkWrap` も可) | Flutter のもの: Android、iOS、Fuchsia では `padded`、macOS、Windows、Linux では `shrink-wrap` | `materialTapTargetSize` |
| `spring.flutter.theme.splash` | `ripple`、`sparkle`、`none` | Flutter のもの: Android (ブラウザーの中を除く) では `sparkle`、それ以外では `ripple` | `splashFactory` |

どれも名前付きのテーマの中にも書けます (`themes.<name>.visual-density`)。値は大文字と小文字、`-`、`_` を区別せずに比較されます。それ以外の値は起動を失敗させ、プロパティと受け付ける値を示します。

## ビジュアルデンシティ

密度は、Material のコントロールを Material 3 のサイズより小さく、または大きくします。ボタン、チップ、チェックボックス、ラジオ、リストタイル、テキストフィールド、アイコンボタン、メニューです。1 段階ごとに、コントロールの高さ (と幅) から約 4 論理ピクセルが引かれます。

| 値 | 段階 (水平、垂直) | 働き |
|---|---|---|
| `standard` | `0, 0` | Material 自身のサイズ |
| `comfortable` | `-1, -1` | 少し詰まる |
| `compact` | `-2, -2` | 名前付きの値の中で最も詰まる: リストやフォームにより多くの行が表示される |
| `adaptive` | `standard` または `compact` | アプリが動くプラットフォームに対する Flutter の選択 (`VisualDensity.adaptivePlatformDensity`): デスクトップでは `compact`、それ以外では `standard` |

テーマの最上位で受け付けられるのは、この四つの語だけです。コンポーネント自身の `visual-density` は、`horizontal, vertical` の二つの数値 (それぞれ `-4` から `4`) も受け付けます ([コンポーネントごと](#コンポーネントごと) を参照)。

密度はテキストのサイズも、独自のウィジェットの余白も変えません。それらには、テーマの[タイポグラフィ](../spring-boot-starter-flutter/themes/typography.md)と[余白](../spring-boot-starter-flutter/themes/shape-spacing-elevation.md#余白)を使ってください。

## タップ対象のサイズ

| 値 | 働き |
|---|---|
| `padded` | ボタン、チェックボックス、ラジオ、スイッチ、チップ、アイコンボタンは、見た目が小さくても、タッチに対する Material の最小値である 48 × 48 論理ピクセル以上のタップ領域を保つ。余分な領域は透明で、タップに反応する |
| `shrink-wrap` | タップ領域は見た目と同じ大きさになる。コントロールは互いに近くに並ぶ。マウスがポインターになる場所で使う |

`padded` はタッチスクリーンでのアクセシビリティのためのものです。48 ピクセルの対象は指で押しやすくなります。スマートフォンとデスクトップで動くアプリは、Flutter のプラットフォームごとのデフォルトを保つか、デスクトップのプロファイルでだけ `shrink-wrap` を設定します。

## インクのスプラッシュ

スプラッシュは、Material のコントロールがタップされた場所に表示するインクです。`InkWell`、ボタン、リストタイル、チップ、タブに現れます。

| 値 | Flutter のファクトリー | 働き |
|---|---|---|
| `ripple` | `InkRipple.splashFactory` | タップした場所から広がって消える円: 古典的な Material のリップル |
| `sparkle` | `InkSparkle.splashFactory` | 粒状のきらめきを持つ Material 3 のリップル。シェーダーで描かれる |
| `none` | `NoSplash.splashFactory` | インクなし。ホバー、フォーカス、押下のオーバーレイは引き続き表示される |

`splash` には二つの意味があります。語であれば、このスターターが読むこのインクです。マップであれば、アプリの起動中に表示されるスプラッシュ画面で、すべてのアプリが読みます ([スプラッシュ](../spring-boot-starter-flutter/themes/loaders.md#スプラッシュ) を参照)。一つのテーマが同じキーの下に両方を持つことはできません。スプラッシュ画面を持つテーマは、インクを Flutter のデフォルトに任せるか、コンポーネントごとに設定します。

```yaml
spring:
  flutter:
    theme:
      splash:                   # マップ: 起動時のスプラッシュ画面
        background: { color: $colors.surface }
        title: NEON Books
```

## コンポーネントごと

同じ三つの設定は、Flutter のプロパティ名で個々のコンポーネントにもあり、そのコンポーネントではテーマのものより優先されます。

| プロパティ | コンポーネント |
|---|---|
| `visual-density` (語、または `horizontal, vertical`) | `button` とすべてのボタン (`elevated-button`、`filled-button`、`outlined-button`、`text-button`、`icon-button`、`segmented-button`、`menu-button`)、`checkbox`、`radio`、`list-tile`、`input`、`menu`、`menu-bar` |
| `tap-target-size` | `button` とすべてのボタン |
| `material-tap-target-size` | `checkbox`、`radio`、`switch` |
| `splash-factory` (`ripple`、`sparkle`、`none`) | `button` とすべてのボタン、`tab-bar` |

```yaml
spring:
  flutter:
    theme:
      visual-density: standard
      components:
        list-tile: { visual-density: '0, -2' }     # 行を低くするだけ
        icon-button: { tap-target-size: shrink-wrap }
        tab-bar: { splash-factory: none }
```

[ボタン](components/button.md)、[チェックボックス](components/checkbox.md)、[リストタイル](components/list-tile.md)、[タブバー](components/tab-bar.md) のページは、それらを他のプロパティとともに列挙しています。

## Dart で読む

```dart
final theme = Theme.of(context);
theme.visualDensity;          // VisualDensity
theme.materialTapTargetSize;  // MaterialTapTargetSize
theme.splashFactory;          // InteractiveInkFeatureFactory
```

Flutter のデフォルトが適用される前の、読まれたままのテーマでは、設定されていないものは `null` です: `SpringTheme.of(context).visualDensity`、`.tapTargetSize`、`.splashFactory` (`SpringThemeData` に対するこのスターターの拡張)。

## このスターターがない場合

`spring_boot_starter_flutter_material` のないアプリ (型 `widgets` または `cupertino`) では、`visual-density`、`tap-target-size`、一つの値の `splash` は受け付けられますが、表示もチェックもされません。テーマのライブラリは、Material を使うアプリのためにそれらを持つことがあるからです。それぞれについて一度、ログの INFO の 1 行がその名前を挙げます。[プロパティからのテーマ](themes.md#このスターターがない場合) を参照してください。

## Spring (Java) との対応

相当するものはありません。Spring にはアプリのテーマがありません。

## 関連項目

- [プロパティからのテーマ](themes.md)
- [コンポーネントのテーマ](components/index.md)
- [テーマのプロパティ](../spring-boot-starter-flutter/themes/properties.md)
- [ローダーとスプラッシュ](../spring-boot-starter-flutter/themes/loaders.md)
