
# トランジション

デフォルトでは、Flutter と同じく、画面はアプリの種類固有のルートと同じように入ってきます。`MaterialApp` ではプラットフォームに応じた Material のトランジション、`CupertinoApp` では iOS のスライド、デザインライブラリーのないアプリではなしです。テーマは `spring.flutter.theme.motion.page-transition` で、すべての画面に別のものを設定します (`none` ならページは即座に切り替わります)。画面や、一回のナビゲーションは、独自のものを選べます。

## 使う理由

トランジションはアプリの見た目の一部なので、テーマに属します。デザイナーは YAML で、必要ならプラットフォームごとに (プラットフォームはプロファイルです) 変更でき、ルーターは `MaterialApp`、`CupertinoApp`、`WidgetsApp` のいずれでもそれに従います。ページを切り替えるメニューはまったくアニメーションすべきではありません。それはナビゲーションごとの選択です。

## 例

```yaml
# どのアプリの種類でも、ページを即座に切り替える。
spring:
  flutter:
    theme:
      motion:
        page-transition: none
```

```yaml
# 指定した長さとカーブのフェード。
spring:
  flutter:
    theme:
      motion:
        page-transition: { type: fade, duration: 200ms, curve: ease-out }
```

```dart
// 一つの画面が独自のものを選ぶ。
@ScreenRoute('/settings', transition: PageTransition.none)
class SettingsPage extends StatelessWidget { ... }

// 一回のナビゲーションも: ページを即座に切り替えるメニュー。
context.route.go('/motion', transition: PageTransition.none);
```

## 値

| `PageTransition` | テーマの値 | 意味 |
|---|---|---|
| `theme` | | テーマの `motion.page-transition`。何も設定されていなければ `platform` (画面のデフォルト) |
| `platform` | `platform` | アプリの種類固有のもの: `MaterialApp` ではプラットフォームに応じた Material のトランジション、`CupertinoApp` では iOS のスライド、デザインライブラリーのないアプリではなし (テーマのデフォルト) |
| `fadeUpwards` | `fade-upwards` | Android の上向きのフェード。どのアプリの種類でも |
| `zoom` | `zoom` | Material のズーム。依存関係に `spring_boot_starter_flutter_material` があれば、どのアプリの種類でも |
| `cupertino` | `cupertino` | スワイプで戻れる iOS のスライド。依存関係に `spring_boot_starter_flutter_cupertino` があれば、どのアプリの種類でも |
| `fade` | `fade` | フェード |
| `content` | `content` | テーマの `motion.content-change` と同じ: 画面の一部が別のコンテンツを表示する方法 (`fade-up`)、その期間とカーブで |
| `none` | `none` | 即座に |

- 各種類は、テーマが設定していればその長さとカーブを使います (`{ type, duration, curve }`。`$motion.durations.fast` のような参照も使えます)。
- デバイスで視差効果を減らす設定が有効なら、すべてのトランジションは即座になります。
- シェルのブランチの切り替えは決してアニメーションしません。

## Flutter との共通点と違い

Flutter では、トランジションを選ぶのはルートで、ルートのクラスを選ぶのはそれぞれの `Navigator.push` です。

| アプリ | Flutter のトランジション |
|---|---|
| `MaterialApp` (`MaterialPageRoute`) | `ThemeData.pageTransitionsTheme`。プラットフォームごとに一つのビルダー: Android では `PredictiveBackPageTransitionsBuilder`、iOS と macOS では `CupertinoPageTransitionsBuilder`、Windows と Linux では `ZoomPageTransitionsBuilder` |
| `CupertinoApp` (`CupertinoPageRoute`) | 端からのスワイプで戻れる iOS のスライド |
| `WidgetsApp` | 独自のものはなし: アプリが `pageRouteBuilder` を渡す |

ここでのデフォルトも同じ `platform` なので、何も設定しないアプリは Flutter で書いた場合と同じ見た目になります。

**プラットフォームごとのビルダーではなく、テーマの一つの値。** 見た目は設定です。`motion.page-transition` は `application.yml` にあり、テーマごと (`themes.<name>`)、プロファイルごとに設定でき、プラットフォームもプロファイルです。

```yaml
# lib/resources/application-web.yml: Web ではページを即座に切り替える
spring.flutter.theme.motion.page-transition: none
```

同じ値が、ルーターの画面と Material 自身のルートの両方を決めます (コードが push する `MaterialPageRoute` は `pageTransitionsTheme` を通じてそれを受け取ります)。コードでのプラットフォームごとのビルダーも使えます。`pageTransitionsTheme` を設定する `ThemeCustomizer` があれば ([コードでのテーマ](../spring-boot-starter-flutter-material/themes-in-code.md))、`platform` を求めるページはそれを使います。

**Flutter に対応するもののない機能:**

- 画面が独自のものを選べ (`@ScreenRoute(transition: PageTransition.fade)`)、一回のナビゲーションも選べます (`go(path, transition: PageTransition.none)`)。独自のルートのクラスは要りません。
- 長さとカーブは、`platform` も含め、どの種類でもテーマから来ます (`{ type: platform, duration: 250ms, curve: ease-out }`)。
- `content`: 画面が、`motion.content-change` が別のコンテンツを表示するのと同じように入ってきます。
- デバイスで視差効果を減らす設定が有効なら、すべてのトランジションは即座になります。
- シェルのブランチの切り替えは決してアニメーションしません。
- `zoom` と `cupertino` は、そのスターターがあればどのアプリの種類でも動きます。`MaterialApp` での iOS のスライド、`WidgetsApp` での Material のズームです。

**以前はなしだった理由と、`none` を書くとき。** 0.8 までは、`motion.page-transition` のないテーマには、どのアプリの種類でもトランジションがありませんでした。デザインライブラリーのないアプリ (farum-azula.org のような Web サイト) はどのみちページを即座に切り替えますし、コンテンツのサイトやダッシュボードは即座のページを望むことがよくあります。一方で Material や Cupertino のアプリは、Flutter が与えるものより少ないものしか持っていませんでした。ページを即座に切り替えるには、`motion.page-transition: none` と書きます。

## デザインライブラリーのトランジション

ルーターは Material も Cupertino もインポートしません。`MaterialApp` や `CupertinoApp` での `platform` のルート、そして `cupertino` のルートは、デザインのスターターの `DesignPageRoutes` Bean ([spring_boot_starter_flutter_material](../spring-boot-starter-flutter-material/other-starters.md) の `MaterialPageRoutes`、[spring_boot_starter_flutter_cupertino](../spring-boot-starter-flutter-cupertino/other-starters.md) の `CupertinoPageRoutes`) から、`@Order` の順に問い合わせて得られます。`material` や `cupertino` の種類のアプリは、そのスターターとともにそれらを持ちます。`fade`、`fade-upwards`、`content`、`none` は Flutter のスターター自身のもので、どのアプリでも動きます。

`zoom` と `cupertino` には、それぞれのスターターが必要です。

- テーマ (`motion.page-transition`) では、起動が失敗し、加えるべきスターターを示します。
- 画面 (`@ScreenRoute(transition: ...)`) や一回のナビゲーション (`go(..., transition: ...)`) では、スターターを示すエラーが報告され、ページはトランジションなしで表示されます。

## 関連項目

- [モーションとアニメーション](../spring-boot-starter-flutter/themes/motion-and-animations.md)
- [デザインライブラリー](../spring-boot-starter-flutter/design-libraries.md)
- [画面とルート](screens.md)
- [シェルとタブ](shells.md)
