トランジション

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

使う理由

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

例

# どのアプリの種類でも、ページを即座に切り替える。
spring:
  flutter:
    theme:
      motion:
        page-transition: none
# 指定した長さとカーブのフェード。
spring:
  flutter:
    theme:
      motion:
        page-transition: { type: fade, duration: 200ms, curve: ease-out }
// 一つの画面が独自のものを選ぶ。
@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 即座に

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>)、プロファイルごとに設定でき、プラットフォームもプロファイルです。

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

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

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

以前はなしだった理由と、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 の MaterialPageRoutes、spring_boot_starter_flutter_cupertino の CupertinoPageRoutes) から、@Order の順に問い合わせて得られます。material や cupertino の種類のアプリは、そのスターターとともにそれらを持ちます。fade、fade-upwards、content、none は Flutter のスターター自身のもので、どのアプリでも動きます。

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

関連項目