NavigationStackとは何か、SwiftUIのナビゲーションスタック

SwiftUIのNavigationStackとは？

NavigationStackはスタックベースのナビゲーション（LIFO）を実装するコンテナViewです。遷移履歴を管理し、新しい画面をスタックにプッシュしたり、システムの“戻る”ボタンやプログラム的に戻ることができます。NavigationStackはiOS 16、iPadOS 16、macOS 13、watchOS 9、tvOS 16以降のSwiftUIの一部です。

NavigationStackの主な革新は型安全なナビゲーションパスです。NavigationLinkを作成する際に直接遷移先を指定する代わりに、パスに値を入れ、遷移先Viewは.navigationDestination(for:destination:)修飾子を介して別途登録します。これによりナビゲーションとレンダリングが分離され、コードのモジュール性とテスタビリティが向上します。

WWDC 2022（セッション10054）によると、NavigationStackはObservableObjectとSwiftUIライフサイクルに基づいた新しいナビゲーションメカニズムを使用しています。内部でUINavigationControllerに依存していたNavigationViewとは異なり、NavigationStackは完全にSwiftUIで実装されており、SwiftUIライフサイクルとの予測可能性と互換性が向上しています。

NavigationStackの基本構造

NavigationStackはルートViewとオプションのナビゲーションパス（NavigationPathまたはHashable値の配列へのBinding）を受け入れます。すべての子画面はNavigationLinkを介して、またはプログラム的にパスに値を追加することでスタックにプッシュされます。

NavigationStack vs NavigationView: 比較

NavigationViewはiOS 16以前のSwiftUIにおける主要なナビゲーションコンテナでした。内部で自動的にUINavigationControllerを管理していたため、データ変更時の予測不能な動作、プログラム的ナビゲーションの複雑さ、型安全性の欠如など、いくつかの問題を引き起こしました。

主な利点 NavigationStackの — 型安全なナビゲーションです。パスを特定の型の配列（または異種スタックの場合はNavigationPath）として定義し、各型に遷移先を登録します。これにより型の不一致エラーが排除され、ナビゲーションが予測可能になります。

NavigationViewはiOS 17で非推奨になりました。Appleはすべての新規プロジェクトおよびiOS 16への最小バージョンアップデート時にNavigationStackへの移行を推奨しています。

NavigationPath: 型安全なスタック管理

NavigationPathはNavigationStackのナビゲーションパスを表す型です。異種の値（AnyHashable）を格納したり、配列[T: Hashable]へのBindingを介して特定の型で使用できます。NavigationPathは状態保存のために自動的にエンコードおよびデコードされます。

struct ContentView: View {
    @State private var path = NavigationPath()

    var body: some View {
        NavigationStack(path: $path) {
            HomeView()
                .navigationDestination(for: String.self) { value in
                    DetailView(id: value)
                }
                .navigationDestination(for: Int.self) { value in
                    NumberView(number: value)
                }
        }
    }

    func goToRoot() {
        path.removeLast(path.count)
    }

    func pushDeepLink() {
        path.append("detail_42")
    }
}

異種スタック: NavigationPathはHashableを実装していれば異なる型の値を含めることができます。たとえば、最初の画面はString（ID）、2番目はInt（数値）、3番目はカスタムenum Routeを受け入れます。各型は表示用に個別の.navigationDestinationを登録します。

Codableサポート: NavigationPathは、パス内のすべての値がCodable + Hashableでもある場合にCodableを実装します。これにより、アプリの再起動時やバックグラウンド移行時にナビゲーション状態を保存および復元できます。

NavigationDestination: 遷移先画面の登録

.navigationDestination(for:destination:) — 特定のデータ型の遷移先Viewを登録する修飾子です。NavigationLinkがこの型の値をパスに配置すると、SwiftUIは自動的に対応する.navigationDestinationを見つけて画面を作成します。

enum AppRoute: Hashable {
    case profile(UserID)
    case settings
    case about
}

struct AppNavigation: View {
    @State private var path = NavigationPath()

    var body: some View {
        NavigationStack(path: $path) {
            HomeView()
                .navigationDestination(for: AppRoute.self) { route in
                    switch route {
                    case .profile(let id):
                        ProfileView(userId: id)
                    case .settings:
                        SettingsView()
                    case .about:
                        AboutView()
                    }
                }
        }
    }
}

// Navigate: path.append(AppRoute.profile("user_123"))

重要なルール: .navigationDestinationはNavigationStack内にあるViewに、かつNavigationLinkがパスに値を配置する前に適用する必要があります。通常はルートViewまたはセクションコンテナに追加されます。値の型に対応する.navigationDestinationが見つからない場合、遷移は発生しません。

SwiftUI Engineering（2023）によると、.navigationDestinationは階層のさまざまなレベルで登録できます。SwiftUIはナビゲーション中に最も近い一致する遷移先を検索します。これにより、アプリケーションの異なる部分で同じ型の遷移先を上書きできます。

NavigationStackの使用パターン

パターン1: enum Routeによるナビゲーション。 アプリケーションのすべての画面に関連値を持つenumを定義します。AppRouteに1つの.navigationDestinationとルーティング用のswitchを使用します。これにより、アプリケーション内のすべての可能な遷移の単一の情報源が提供されます。

struct StoreView: View {
    @State private var path: [ProductRoute] = []

    var body: some View {
        NavigationStack(path: $path) {
            ProductGrid()
                .navigationDestination(for: ProductRoute.self) { route in
                    switch route {
                    case .detail(let product):
                        ProductDetail(product: product)
                    case .reviews(let productId):
                        ReviewsView(productId: productId)
                    }
                }
        }
    }
}

enum ProductRoute: Hashable {
    case detail(Product)
    case reviews(String)
}

パターン2: プログラム的ナビゲーションとdeep linking。 NavigationStackはプログラム的なスタック管理（画面の追加、削除、ルートへの復帰）を可能にします。プッシュ通知、ディープリンク、再起動後のナビゲーション復元に必要です。

パターン3: NavigationPathの代わりに型の配列。 すべての画面が同じ型（Stringやカスタムenumなど）を使用する場合は、[T]へのBindingを使用します。これによりNavigationPathよりも強力な型付けとパフォーマンスが得られます。NavigationPathは異なる画面タイプを持つ異種スタックに適しています。

Point-Free（2024）によると、enum Routeを使用したNavigationStackはSwiftUIアプリケーションでナビゲーションを整理する推奨方法です。すべての可能な遷移を明示的、型安全、テスト可能にし、数十の画面を持つ大規模プロジェクトで特に重要です。