NavigationStack: यह क्या है, SwiftUI में नेविगेशन स्टैक

SwiftUI में NavigationStack क्या है?

NavigationStack एक कंटेनर View है जो स्टैक-आधारित नेविगेशन (LIFO) लागू करता है। यह संक्रमण इतिहास का प्रबंधन करता है, जिससे आप स्टैक पर नई स्क्रीन पुश कर सकते हैं और सिस्टम “वापस” बटन या प्रोग्रामेटिक रूप से वापस जा सकते हैं। NavigationStack iOS 16, iPadOS 16, macOS 13, watchOS 9 और tvOS 16 से SwiftUI का हिस्सा है।

NavigationStack का मुख्य नवाचार टाइप-सुरक्षित नेविगेशन पथ है। NavigationLink बनाते समय सीधे गंतव्य निर्दिष्ट करने के बजाय, आप पथ में एक मान डालते हैं, और गंतव्य View को .navigationDestination(for:destination:) संशोधक के माध्यम से अलग से पंजीकृत किया जाता है। यह नेविगेशन को रेंडरिंग से अलग करता है, कोड को अधिक मॉड्यूलर और परीक्षण योग्य बनाता है।

WWDC 2022 (सत्र 10054) के अनुसार, NavigationStack ObservableObject और SwiftUI जीवनचक्र पर आधारित एक नए नेविगेशन तंत्र का उपयोग करता है। NavigationView के विपरीत, जो आंतरिक रूप से UINavigationController पर निर्भर था, 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) स्वीकार कर सकती है, दूसरी एक 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"))

महत्वपूर्ण नियम: .navigationDashboard को उस View पर लागू किया जाना चाहिए जो NavigationStack के अंदर है, और NavigationLink द्वारा पथ में मान डालने से पहले। इसे आमतौर पर रूट View या सेक्शन कंटेनर में जोड़ा जाता है। यदि मान के प्रकार के लिए .navigationDestination नहीं मिलता है, तो संक्रमण नहीं होगा।

SwiftUI Engineering (2023) के अनुसार, .navigationDestination को पदानुक्रम के विभिन्न स्तरों पर पंजीकृत किया जा सकता है। SwiftUI नेविगेशन के दौरान निकटतम मिलान वाले गंतव्य की खोज करता है। यह एप्लिकेशन के विभिन्न भागों में एक प्रकार के लिए गंतव्य को ओवरराइड करने की अनुमति देता है।

NavigationStack उपयोग पैटर्न

पैटर्न 1: enum Route के माध्यम से नेविगेशन। एप्लिकेशन की सभी स्क्रीन के लिए संबद्ध मानों के साथ एक enum परिभाषित करें। रूटिंग के लिए AppRoute के लिए एक .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 अनुप्रयोगों में नेविगेशन व्यवस्थित करने का पसंदीदा तरीका है। यह सभी संभावित संक्रमणों को स्पष्ट, टाइप-सुरक्षित और परीक्षण योग्य बनाता है, जो दर्जनों स्क्रीन वाले बड़े प्रोजेक्ट्स के लिए विशेष रूप से महत्वपूर्ण है।