トランジション
デフォルトでは、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 |
即座に |
- 各種類は、テーマが設定していればその長さとカーブを使います (
{ 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>)、プロファイルごとに設定でき、プラットフォームもプロファイルです。
# lib/resources/application-web.yml: Web ではページを即座に切り替える
spring.flutter.theme.motion.page-transition: none
同じ値が、ルーターの画面と Material 自身のルートの両方を決めます (コードが push する MaterialPageRoute は pageTransitionsTheme を通じてそれを受け取ります)。コードでのプラットフォームごとのビルダーも使えます。pageTransitionsTheme を設定する ThemeCustomizer があれば (コードでのテーマ)、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 の MaterialPageRoutes、spring_boot_starter_flutter_cupertino の CupertinoPageRoutes) から、@Order の順に問い合わせて得られます。material や cupertino の種類のアプリは、そのスターターとともにそれらを持ちます。fade、fade-upwards、content、none は Flutter のスターター自身のもので、どのアプリでも動きます。
zoom と cupertino には、それぞれのスターターが必要です。
- テーマ (
motion.page-transition) では、起動が失敗し、加えるべきスターターを示します。 - 画面 (
@ScreenRoute(transition: ...)) や一回のナビゲーション (go(..., transition: ...)) では、スターターを示すエラーが報告され、ページはトランジションなしで表示されます。