NavigationStack: bu nima, SwiftUI-da navigatsion stek

SwiftUI-da NavigationStack nima?

NavigationStack stek (LIFO) asosida navigatsiyani amalga oshiradigan konteyner View hisoblanadi. U o‘tishlar tarixini boshqaradi, yangi ekranlarni stekka joylashtirishga va tizimning «Orqaga» tugmasi yoki dasturiy ravishda qaytishga imkon beradi. NavigationStack iOS 16, iPadOS 16, macOS 13, watchOS 9 va tvOS 16 dan boshlab SwiftUI ning bir qismidir.

NavigationStack ning asosiy yangiligi — tip xavfsiz navigatsiya yo‘li. NavigationLink yaratishda destination ni to‘g‘ridan-to‘g‘ri ko‘rsatish o‘rniga, yo‘lga qiymat (value) joylashtirasiz va maqsadli View ni ro‘yxatdan o‘tkazish alohida .navigationDestination(for:destination:) modifikatori orqali amalga oshiriladi. Bu navigatsiya va ko‘rsatishni ajratib, kodni yanada modulli va sinab ko‘riladigan qiladi.

WWDC 2022 (Session 10054) ma’lumotlariga ko‘ra, NavigationStack ObservableObject va SwiftUI hayotiy siklida asoslangan yangi navigatsiya mexanizmidan foydalanadi. UINavigationController ga tayanadigan NavigationView dan farqli o‘laroq, NavigationStack to‘liq SwiftUI da amalga oshirilgan bo‘lib, bu bashorat qilish qobiliyatini va SwiftUI hayotiy sikl bilan muvofiqligini yaxshilaydi.

NavigationStack ning asosiy tuzilishi

NavigationStack ildiz View va ixtiyoriy navigatsiya yo‘lini (NavigationPath yoki Hashable qiymatlar massiviga Binding) qabul qiladi. Barcha biriktirilgan ekranlar NavigationLink yoki qiymatlarni dasturiy ravishda yo‘lga qo‘shish orqali stekka joylashtiriladi.

NavigationStack vs NavigationView: taqqoslash

NavigationView iOS 16 gacha SwiftUI ning asosiy navigatsiya konteyneri edi. U avtomatik ravishda UINavigationController ni orqa fonda boshqarar edi, bu bir qator muammolarga olib keldi: ma’lumot o‘zgarishida oldindan aytib bo‘lmaydigan xatti-harakat, dasturiy navigatsiya bilan qiyinchiliklar va tip xavfsizligining yo‘qligi.

Asosiy afzallik NavigationStack — tip xavfsiz navigatsiya. Siz yo‘lni aniq turlar massivi (yoki geterogen steklar uchun NavigationPath) sifatida belgilaysiz va har bir tur uchun destination ni ro‘yxatdan o‘tkazasiz. Bu tur nomuvofiqligi xatolarini bartaraf qiladi va navigatsiyani oldindan aytish mumkin qiladi.

NavigationView iOS 17 da eskirgan. Apple barcha yangi loyihalar va minimal versiyani iOS 16 ga yangilashda NavigationStack ga o‘tishni tavsiya qiladi.

NavigationPath: tip xavfsiz stek boshqaruvi

NavigationPath NavigationStack dagi navigatsiya yo‘lini ifodalovchi turdir. U geterogen qiymatlarni (AnyHashable) saqlashi yoki [T: Hashable] massiviga Binding orqali aniq tur bilan ishlatilishi mumkin. NavigationPath holatni saqlash uchun avtomatik ravishda kodlanadi va dekodlanadi.

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")
    }
}

Geterogen stek: NavigationPath Hashable ni amalga oshirsa, turli xil turdagi qiymatlarni o‘z ichiga olishi mumkin. Masalan, birinchi ekran String (ID), ikkinchisi — Int (raqam), uchinchisi — maxsus enum Route ni qabul qilishi mumkin. Har bir turni ko‘rsatish uchun alohida .navigationDestination ro‘yxatdan o‘tkaziladi.

Codable qo‘llab-quvvatlashi: NavigationPath Codable ni amalga oshiradi, agar yo‘ldagi barcha qiymatlar ham Codable + Hashable bo‘lsa. Bu ilova qayta ishga tushirilganda yoki fon rejimiga o‘tganda navigatsiya holatini saqlash va tiklash imkonini beradi.

NavigationDestination: maqsadli ekranlarni ro‘yxatdan o‘tkazish

.navigationDestination(for:destination:) — ma’lum bir ma’lumot turi uchun maqsadli View ni ro‘yxatdan o‘tkazuvchi modifikator. NavigationLink bu turning qiymatini yo‘lga joylashtirganda, SwiftUI avtomatik ravishda tegishli .navigationDestination ni topadi va ekran yaratadi.

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"))

Muhim qoida: .navigationDestination NavigationStack ichida joylashgan View ga qo‘llanilishi kerak va NavigationLink qiymatni yo‘lga joylashtirishdan oldin bo‘lishi kerak. Odatda u ildiz View ga yoki bo‘lim konteyneriga qo‘shiladi. Agar qiymat turi uchun .navigationDestination topilmasa, o‘tish amalga oshmaydi.

SwiftUI Engineering (2023) ma’lumotlariga ko‘ra, .navigationDestination ierarxiyaning turli darajalarida ro‘yxatdan o‘tkazilishi mumkin. SwiftUI navigatsiya urinishida eng yaqin mos destination ni qidiradi. Bu ilovaning turli qismlarida bitta tur uchun destination ni bekor qilish imkonini beradi.

NavigationStackdan foydalanish naqshlari

Naqsh 1: enum Route orqali navigatsiya. Ilovaning barcha ekranlari uchun bog‘langan qiymatlarga ega enum ni belgilang. AppRoute uchun bitta .navigationDestination va marshrutlash uchun switch dan foydalaning. Bu ilovadagi barcha mumkin bo‘lgan o‘tishlar uchun yagona haqiqat manbasini ta’minlaydi.

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)
}

Naqsh 2: dasturiy navigatsiya va deep linking. NavigationStack stekni dasturiy ravishda boshqarish imkonini beradi: ekranlarni qo‘shish, olib tashlash va ildizga qaytish. Bu push bildirishnomalari, chuqur havolalar va qayta ishga tushirishdan keyin navigatsiyani tiklash uchun zarurdir.

Naqsh 3: NavigationPath o‘rniga turlar massivi. Agar barcha ekranlar bitta turdan foydalansa (masalan, String yoki maxsus enum), [T] ga Binding dan foydalaning. Bu NavigationPath ga qaraganda qattiqroq tipizatsiya va yaxshiroq ishlashni ta’minlaydi. NavigationPath turli xil ekran turlariga ega geterogen steklar uchun asoslangan.

Point-Free (2024) ma’lumotlariga ko‘ra, enum Route bilan NavigationStack SwiftUI ilovalarida navigatsiyani tashkil qilishning afzal usulidir. Barcha mumkin bo‘lgan o‘tishlarni aniq, tip xavfsiz va sinab ko‘riladigan qiladi, bu ayniqsa o‘nlab ekranlari bo‘lgan katta loyihalar uchun muhimdir.