
# ページのトランジション

iOS では、新しい画面が右からスライドして入り、下の画面は影の中で少し左へ動き、左端からのスワイプで指に追従しながら画面が戻ります。このスターターは、そのトランジションを [spring_boot_starter_flutter_navigation](../spring-boot-starter-flutter-navigation/index.md) のルーターに、テーマから与えます。任意の種類のアプリでは `motion.page-transition: cupertino`、型 `cupertino` のアプリでは `platform` です。

## 使う理由

- **トランジションはテーマに属します。** デザイナーは色と同じように、テーマごとやプラットフォームごとに YAML で変更します。Dart でルートのクラスを書くことはありません。
- **Flutter と同じく、`CupertinoApp` はデフォルトでスライドします。** `motion.page-transition` のないテーマは `platform`、つまりアプリの種類固有のものです。`CupertinoApp` では、Flutter の `CupertinoPageRoute` と同じ iOS のスライドになります。ページを即座に切り替えたいなら `none` と指定します ([トランジション](../spring-boot-starter-flutter-navigation/transitions.md#flutter-との共通点と違い) を参照)。
- **スワイプで戻る操作が付いてきます。** iPhone のユーザーは端からのスワイプで戻ります。iOS のルートはそのジェスチャーを持ちますが、単純なフェードは持ちません。

## 例

```yaml
# lib/resources/application.yml: アプリの種類固有のトランジション (デフォルトを明示したもの)。CupertinoApp では iOS のスライド
spring:
  flutter:
    theme:
      motion:
        page-transition: platform
```

```yaml
# 任意の種類のアプリでの iOS のスライド。独自の長さとカーブで
spring:
  flutter:
    theme:
      motion:
        durations: { medium: 350ms }
        page-transition:
          type: cupertino
          duration: $motion.durations.medium
          curve: ease-out
```

```properties
# lib/resources/application.properties での同じもの
spring.flutter.theme.motion.page-transition.type=cupertino
spring.flutter.theme.motion.page-transition.duration=350ms
spring.flutter.theme.motion.page-transition.curve=ease-out
```

## 値

`motion.page-transition` は種類だけ、または `type`、`duration`、`curve` のマップです ([モーションとアニメーション](../spring-boot-starter-flutter/themes/motion-and-animations.md#ページのトランジション) を参照)。このスターターを持つアプリでは次のとおりです。

| 値 | 型 `cupertino` のアプリで | 他の種類のアプリで |
|---|---|---|
| 設定なし、または `platform` | iOS のスライド。スワイプで戻れる | `MaterialApp` では Material のトランジション。`WidgetsApp` ではなし |
| `none` | トランジションなし: 画面は即座に表示される | 同じ |
| `cupertino` | iOS のスライド。スワイプで戻れる | iOS のスライド。スワイプで戻れる |
| `fade`、`fade-upwards`、`content` | Flutter のスターター自身のもの | 同じ |
| `zoom` | Material のもの: [Material のスターター](../spring-boot-starter-flutter-material/other-starters.md) が必要 | 同じ |

| マップのキー | 型 | デフォルト | 働き |
|---|---|---|---|
| `type` | enum | `platform` | 種類。上記のとおり |
| `duration` | 長さ (`350ms`、`$motion.durations.medium`) | iOS 自身のもの: 500 ms | スライドにかかる時間。どちらの方向でも |
| `curve` | カーブ (`ease-out`、四つの数値、`$motion.curves.<name>`) | なし: スライド自身のイージング | スライドが従うアニメーションの形を決める |

デバイスで視差効果を減らす設定が有効なら、iOS のスライドも含めて、すべてのトランジションは即座になります。

## スワイプで戻る

スライドのルートは Cupertino 自身のもの (`CupertinoRouteTransitionMixin`) なので、iOS と同じように振る舞います。

- 先頭側の端 (左。右から左へ書く言語では右) からのドラッグで画面が戻り、トランジションは指に線形に追従します。中央を過ぎてから、またはフリックで指を離すと画面は戻り、そうでなければ元の位置に戻ります。
- ナビゲーターの最初の画面にはスワイプで戻る操作がありません。戻る先がないからです。
- 離れることを拒む画面 (`canPop: false` の `PopScope`。たとえば未保存の変更があるフォーム) は、スワイプでも閉じられません。
- ジェスチャーは iOS だけでなく、すべてのプラットフォームで動きます。`cupertino` なら Android のスマートフォンでも使えます。

## テーマの背景の上で

ページがスライドして入る間、iOS は下のページを薄い黒で暗くし、ルートはその層をページの下に残します。[`background`](../spring-boot-starter-flutter/themes/background.md) を持つテーマは、すべての画面を通してその背景を見せるので、この層が背景に残り、テーマが指定するより暗くなってしまいます。そのため背景があるときは、ルートはこの層を描きません。背景がなければ、Flutter と同じくページがこの層を覆います。

## ヒーロー

型 `cupertino` のアプリでは、ルーターのナビゲーターのヒーローは、`CupertinoApp` が飛ばすのと同じように (`CupertinoApp.createCupertinoHeroController()`)、まっすぐに飛びます。他の種類のアプリでは、トランジション `cupertino` はそのアプリのヒーローの飛び方を保ちます。

## 画面ごと、ナビゲーションごと

テーマのトランジションは、すべての画面のデフォルトです。画面は独自のものを選べ、一回のナビゲーションも選べます。それにはナビゲーションのスターターの `PageTransition` を使います。`PageTransition.cupertino` は iOS のスライド、`PageTransition.platform` はアプリの種類固有のものです。

```dart
@ScreenRoute('/books/:id', transition: PageTransition.cupertino)
class BookPage extends StatelessWidget { ... }

// ページを即座に切り替えるメニュー。
context.route.go('/settings', transition: PageTransition.none);
```

それらはテーマの長さとカーブを使います。[トランジション](../spring-boot-starter-flutter-navigation/transitions.md) を参照してください。

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

`cupertino` は Cupertino のスターターのものです。Flutter のスターターとナビゲーションのスターターは Cupertino を何もインポートしません。

- テーマ (`motion.page-transition: cupertino`) では、起動が失敗し、加えるべきスターターの名前を挙げます。

  ```text
  Invalid theme property spring.flutter.theme.motion.pagetransition.type (theme light): 'cupertino'; expected a transition of the application: cupertino is Cupertino's, read by spring_boot_starter_flutter_cupertino (add it to the dependencies), or platform, fade-upwards, fade, content or none.
  ```

- 画面や一回のナビゲーション (`PageTransition.cupertino`) では、スターターの名前を挙げたエラーがログに報告され、ページはトランジションなしで表示されます。例外は投げられません。その時点でナビゲーターはページを更新している最中だからです。
- デザインのスターターがなければ、`platform` はトランジションを表示しません。

## ルーターがない場合

テーマのトランジションはルーターのものです。Flutter の `Navigator.push` と `CupertinoPageRoute` で手動でプッシュした画面は、テーマが何を指定していても、Cupertino 自身の長さのスライドを保ちます。

## 仕組み

ルーターは、各ページのルートを `DesignPageRoutes` Bean に `@Order` の順に問い合わせます。このスターターの Bean `cupertinoPageRoutes` (`CupertinoPageRoutes`) は、任意の種類のアプリでの `cupertino` と、型 `cupertino` のアプリでの `platform` に対して、テーマの長さとカーブを持つルートで答えます。それ以外のトランジションには `null` を返し、次の Bean かルーター自身のトランジションが引き継ぎます。[ページのルート: DesignPageRoutes](../spring-boot-starter-flutter/design-libraries.md#ページのルート-designpageroutes) を参照してください。

## 関連項目

- [ナビゲーションのスターターのトランジション](../spring-boot-starter-flutter-navigation/transitions.md)
- [モーションとアニメーション](../spring-boot-starter-flutter/themes/motion-and-animations.md)
- [他のスターターとともに](other-starters.md)
- [デザインライブラリ](../spring-boot-starter-flutter/design-libraries.md)
