ページのトランジション

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

使う理由

例

# 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 と同じように振る舞います。

テーマの背景の上で

ページがスライドして入る間、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 を何もインポートしません。

ルーターがない場合

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

仕組み

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

関連項目