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 বনাম 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"))

গুরুত্বপূর্ণ নিয়ম: .navigationDestination অবশ্যই একটি 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 অ্যাপ্লিকেশনে নেভিগেশন সংগঠিত করার পছন্দের উপায়। এটি সমস্ত সম্ভাব্য ট্রানজিশনকে স্পষ্ট, টাইপ-নিরাপদ এবং পরীক্ষাযোগ্য করে তোলে, যা ডজন ডজন স্ক্রিনযুক্ত বড় প্রকল্পের জন্য বিশেষভাবে গুরুত্বপূর্ণ।