flutter-navigation

Flutter のナビゲーション

URL、ディープリンク、状態復元、複数のナビゲーターが必要な場合は、アプリケーションの状態としてナビゲーションをモデル化してください。本当にローカルなフローでは、よりシンプルな命令型ナビゲーションを使用してください。

まず確認すること

現在のルーター、ルートの所有者、認証フロー、タブ／シェルの構成、対応プラットフォーム、URL の要件、状態復元への期待を確認してください。移行が求められていない限り、既存のルーティングパッケージを維持してください。

ルール

• ルート名、パスパラメーター、引数のデコードは、型安全にするか、一元的に検証してください。
• リダイレクトロジックは決定論的にし、リダイレクトループが発生しないようにしてください。
• Android のシステムバック、ブラウザーの履歴、iOS のジェスチャー、ネストしたナビゲーター、モーダルをまたいで、意図した戻る動作を維持してください。
• タブシェルなど、独立した履歴が必要な場合に限り、ネストしたナビゲーションを使用してください。
• ディープリンクはドメインで安全に扱える状態にパースし、不明な宛先や認可されていない宛先への動作を定義してください。
• ナビゲーションの副作用をウィジェットの build の外に置いてください。
• 大きなドメインオブジェクトを URL や状態復元データに直接含めないでください。

検証

コールドディープリンク、ウォームリンク、戻る／進むの動作、認証リダイレクト、無効なパラメーター、必要に応じた状態復元、各シェル／タブの履歴をテストしてください。

参考資料

タブシェルのパターンや独立した戻る履歴が対象となる場合は、ネストしたシェルナビゲーションのリファレンスに従ってください。 ディープリンクや状態復元を扱う場合は、ディープリンクと状態復元のリファレンスに従ってください。

出典

• Flutter のナビゲーションとルーティング
• ディープリンク