他のスターターとともに

ナビゲーションとセキュリティのスターターは、デザインライブラリを知りません。このスターターは、Bean とその CupertinoApp の DesignScope を通じて、Cupertino のものをそれらに与えます。設定するものは何もありません。

使う理由

ナビゲーションとセキュリティのスターター、そして Flutter のスターターの MarkdownView は、Material、Cupertino、素の WidgetsApp のどのアプリでも同じように使われるので、デザインライブラリをインポートしません。それぞれが、デザインに固有のものをアプリケーションに問い合わせます。ページのルート、フォームのコントロール、選択ハンドルです。このスターターが Cupertino のために答えるので、Cupertino のアプリは、Cupertino のために書かれたわけではないウィジェットから iOS の振る舞いを得ます。

ナビゲーションのスターター

spring_boot_starter_flutter_navigation のルーターは、ページのルートを DesignPageRoutes Bean に問い合わせます。このスターターの cupertinoPageRoutes Bean (CupertinoPageRoutes) は、端からのスワイプで戻れる iOS のスライドを、型 cupertino のアプリでの motion.page-transition: platform と、任意の種類のアプリでの cupertino に与えます。

spring:
  flutter:
    theme:
      motion:
        page-transition: platform     # CupertinoApp では iOS のスライド

@ScreenRoute の画面もそれとともに入り、SpringApplicationWidget に home: がなければ、アプリのウィジェットはルーターの上の CupertinoApp.router になります (アプリのウィジェット を参照)。型 cupertino のアプリでは、ルーターのナビゲーターのヒーローは CupertinoApp でのように飛びます。トランジションのすべて、つまりその長さとカーブ、スワイプで戻る操作、このスターターがないときに起きることは ページのトランジション にあります。

セキュリティスターターのログインフォーム

spring_boot_starter_flutter_security の LoginForm と OAuth2LoginButton は、アプリのデザインのコントロールでフィールドとボタンを描きます。このスターターがあれば、それは Cupertino のもの (CupertinoDesignControls) です。ラベルをプレースホルダーとし、エラーをその下に赤で表示する CupertinoTextField、処理中はアクティビティインジケーターを表示する塗りつぶしの CupertinoButton、そしてエラーには iOS の破壊的な操作の赤です。これが LoginDesign.app で、LoginDesign.widgets は素のものを保ちます。アプリが自分で組み立てる CupertinoApp の下でも、Cupertino のコントロールを見つけます。

class LoginPage extends StatelessWidget {
  const LoginPage({super.key});

  @override
  Widget build(BuildContext context) => CupertinoPageScaffold(
    navigationBar: const CupertinoNavigationBar(middle: Text('Sign in')),
    child: SafeArea(
      child: Padding(
        padding: const EdgeInsets.all(16),
        // Cupertino のアプリでは CupertinoTextField と CupertinoButton.filled。
        child: LoginForm(onSuccess: (_) => context.route.go('/books')),
      ),
    ),
  );
}

コントロールは見た目を CupertinoThemeData から受け取ります。塗りつぶしのボタンは cupertino.primary-color で、そのラベルは cupertino.primary-contrasting-color です。フィールドのカーソルはプライマリーカラーです (テーマのプロパティ を参照)。ログイン画面 を参照してください。

MarkdownView

スターターのウィジェット (MarkdownView) の選択可能なテキストは、iOS と macOS では iOS の選択ハンドルを持ちます。Android、Fuchsia、Linux、Windows では、CupertinoApp は Material のものではなく、Flutter のスターター自身のハンドル (SpringTextSelectionControls) を与えます。Cupertino のアプリのビルドには Material が入らないからです。テキストスタイルは SpringTheme のものです。MarkdownView を参照してください。

関連項目