NavigationStack: що це, навігаційний стек у SwiftUI

Що таке NavigationStack у SwiftUI?

NavigationStack — це контейнерне View, що реалізує навігацію на основі стека (LIFO). Воно керує історією переходів, дозволяючи поміщати нові екрани в стек і повертатися назад через системну кнопку «Назад» або програмно. NavigationStack є частиною SwiftUI, починаючи з iOS 16, iPadOS 16, macOS 13, watchOS 9 та tvOS 16.

Основне нововведення NavigationStack — типобезпечний шлях навігації. Замість прямого вказання destination при створенні NavigationLink, ви поміщаєте в шлях значення (value), а реєстрація цільового View відбувається окремо через модифікатор .navigationDestination(for:destination:). Це розділяє навігацію та відображення, роблячи код більш модульним і тестованим.

Згідно з WWDC 2022 (Сесія 10054), NavigationStack використовує новий механізм навігації, заснований на ObservableObject та SwiftUI lifecycle. На відміну від NavigationView, який покладався на UINavigationController всередині, NavigationStack повністю реалізований на SwiftUI, що покращує передбачуваність і сумісність із SwiftUI lifecycle.

Базова структура NavigationStack

NavigationStack приймає кореневе View та опціональний шлях навігації (Binding до NavigationPath або масиву Hashable значень). Усі дочірні екрани поміщаються в стек через NavigationLink або програмне додавання значень у шлях.

NavigationStack vs NavigationView: порівняння

NavigationView був основним навігаційним контейнером SwiftUI до iOS 16. Він автоматично керував UINavigationController всередині, що призводило до низки проблем: непередбачувана поведінка при зміні даних, складність із програмною навігацією та відсутність типобезпеки.

Ключова перевага NavigationStack — типобезпечна навігація. Ви визначаєте шлях як масив конкретних типів (або NavigationPath для гетерогенних стеків) і реєструєте destination для кожного типу. Це виключає помилки невідповідності типів і робить навігацію передбачуваною.

NavigationView deprecated в iOS 17. Apple рекомендує мігрувати на NavigationStack для всіх нових проектів і при оновленні мінімальної версії до iOS 16.

NavigationPath: типобезпечне керування стеком

NavigationPath — це тип, що представляє шлях навігації в NavigationStack. Він може зберігати гетерогенні значення (AnyHashable) або використовуватися з конкретним типом через Binding до масиву [T: Hashable]. 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), другий — Int (номер), третій — кастомний enum Route. Для відображення кожного типу реєструється окремий .navigationDestination.

Codable підтримка: NavigationPath реалізує Codable, якщо всі значення в шляху також Codable + Hashable. Це дозволяє зберігати та відновлювати стан навігації при перезапуску програми або при переході у фоновий режим.

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 повинен бути застосований до View, яке знаходиться всередині NavigationStack, і до того, як NavigationLink помістить значення в шлях. Зазвичай його додають до кореневого View або до контейнера секції. Якщо .navigationDestination не знайдено для типу значення, перехід не відбудеться.

Згідно з SwiftUI Engineering (2023), .navigationDestination може бути зареєстрований на різних рівнях ієрархії. SwiftUI шукає найближчий відповідний destination при спробі навігації. Це дозволяє перевизначати destination для одного типу в різних частинах програми.

Паттерни використання NavigationStack

Паттерн 1: навігація через enum Route. Визначте enum з асоційованими значеннями для всіх екранів програми. Використовуйте один .navigationDestination для AppRoute та 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 дозволяє програмно керувати стеком: додавати, видаляти екрани та повертатися на корінь. Це необхідно для push-сповіщень, deep link-ів та відновлення навігації після перезапуску.

Паттерн 3: масив типів замість NavigationPath. Якщо всі екрани використовують один тип (наприклад, String або кастомний enum), використовуйте Binding до [T]. Це дає більш сувору типізацію та кращу продуктивність, ніж NavigationPath. NavigationPath виправданий для гетерогенних стеків із різними типами екранів.

Згідно з Point-Free (2024), NavigationStack з enum Route — найкращий спосіб організації навігації в SwiftUI-додатках. Він робить всі можливі переходи явними, типобезпечними та тестованими, що особливо важливо для великих проектів із десятками екранів.