ページのトランジション
iOS では、新しい画面が右からスライドして入り、下の画面は影の中で少し左へ動き、左端からのスワイプで指に追従しながら画面が戻ります。このスターターは、そのトランジションを spring_boot_starter_flutter_navigation のルーターに、テーマから与えます。任意の種類のアプリでは motion.page-transition: cupertino、型 cupertino のアプリでは platform です。
使う理由
- トランジションはテーマに属します。 デザイナーは色と同じように、テーマごとやプラットフォームごとに YAML で変更します。Dart でルートのクラスを書くことはありません。
- Flutter と同じく、
CupertinoAppはデフォルトでスライドします。motion.page-transitionのないテーマはplatform、つまりアプリの種類固有のものです。CupertinoAppでは、Flutter のCupertinoPageRouteと同じ iOS のスライドになります。ページを即座に切り替えたいならnoneと指定します (トランジション を参照)。 - スワイプで戻る操作が付いてきます。 iPhone のユーザーは端からのスワイプで戻ります。iOS のルートはそのジェスチャーを持ちますが、単純なフェードは持ちません。
例
# lib/resources/application.yml: アプリの種類固有のトランジション (デフォルトを明示したもの)。CupertinoApp では iOS のスライド
spring:
flutter:
theme:
motion:
page-transition: platform
# 任意の種類のアプリでの iOS のスライド。独自の長さとカーブで
spring:
flutter:
theme:
motion:
durations: { medium: 350ms }
page-transition:
type: cupertino
duration: $motion.durations.medium
curve: ease-out
# 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 のマップです (モーションとアニメーション を参照)。このスターターを持つアプリでは次のとおりです。
| 値 | 型 cupertino のアプリで |
他の種類のアプリで |
|---|---|---|
設定なし、または platform |
iOS のスライド。スワイプで戻れる | MaterialApp では Material のトランジション。WidgetsApp ではなし |
none |
トランジションなし: 画面は即座に表示される | 同じ |
cupertino |
iOS のスライド。スワイプで戻れる | iOS のスライド。スワイプで戻れる |
fade、fade-upwards、content |
Flutter のスターター自身のもの | 同じ |
zoom |
Material のもの: Material のスターター が必要 | 同じ |
| マップのキー | 型 | デフォルト | 働き |
|---|---|---|---|
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 を持つテーマは、すべての画面を通してその背景を見せるので、この層が背景に残り、テーマが指定するより暗くなってしまいます。そのため背景があるときは、ルートはこの層を描きません。背景がなければ、Flutter と同じくページがこの層を覆います。
ヒーロー
型 cupertino のアプリでは、ルーターのナビゲーターのヒーローは、CupertinoApp が飛ばすのと同じように (CupertinoApp.createCupertinoHeroController())、まっすぐに飛びます。他の種類のアプリでは、トランジション cupertino はそのアプリのヒーローの飛び方を保ちます。
画面ごと、ナビゲーションごと
テーマのトランジションは、すべての画面のデフォルトです。画面は独自のものを選べ、一回のナビゲーションも選べます。それにはナビゲーションのスターターの PageTransition を使います。PageTransition.cupertino は iOS のスライド、PageTransition.platform はアプリの種類固有のものです。
@ScreenRoute('/books/:id', transition: PageTransition.cupertino)
class BookPage extends StatelessWidget { ... }
// ページを即座に切り替えるメニュー。
context.route.go('/settings', transition: PageTransition.none);
それらはテーマの長さとカーブを使います。トランジション を参照してください。
スターターがない場合
cupertino は Cupertino のスターターのものです。Flutter のスターターとナビゲーションのスターターは Cupertino を何もインポートしません。
-
テーマ (
motion.page-transition: cupertino) では、起動が失敗し、加えるべきスターターの名前を挙げます。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 を参照してください。