NavigationLink — یہ کیا ہے، SwiftUI میں ٹرانزیشن بٹن

SwiftUI میں NavigationLink کیا ہے؟

NavigationLink ایک View ہے جو دبانے پر نیویگیشن ٹرانزیشن شروع کرتا ہے۔ NavigationStack کے اندر، NavigationLink دبانے سے ٹارگٹ اسکرین اسٹیک پر رکھ دی جاتی ہے اور سسٹم کا واپس بٹن دکھاتا ہے۔ NavigationLink iOS 13 سے موجود ہے اور SwiftUI میں صارف نیویگیشن کا بنیادی طریقہ ہے۔

NavigationLink UIButton سے وراثت نہیں پاتا — یہ ایک SwiftUI View ہے جو خود بخود سیاق و سباق کے مطابق ڈھل جاتا ہے۔ List کے اندر، NavigationLink ایک انکشافی اشارے کے ساتھ ظاہر ہوتا ہے۔ فہرست کے باہر، NavigationLink ایک عام بٹن کی طرح برتاؤ کرتا ہے لیکن نیویگیشن رویے کے ساتھ۔

SwiftUI Lab (2024) کے مطابق، NavigationLink SwiftUI ایپلیکیشنز میں سب سے زیادہ استعمال ہونے والے Views میں سے ایک ہے، صرف Text، Image اور VStack کے بعد۔ انیشیالائزیشن کی شکلوں کے درمیان فرق کو سمجھنا کارکردگی اور پیش قیاسی نیویگیشن رویے کے لیے بہت اہم ہے۔

NavigationLink اندرونی طور پر کیسے کام کرتا ہے

دبانے پر، NavigationLink قریب ترین NavigationStack یا NavigationView سے منسلک نیویگیشن اسٹیک میں ایک قدر (یا destination) شامل کرتا ہے۔ SwiftUI View درجہ بندی کے ذریعے نیویگیشن پاتھ منتقل کرنے کے لیے EnvironmentValue استعمال کرتا ہے۔ NavigationLink اس پاتھ کو Environment سے پڑھتا ہے اور دبانے پر اسے تبدیل کرتا ہے۔

NavigationLink کی انیشیالائزیشن کی شکلیں

NavigationLink کی دو اہم شکلیں ہیں: destination کے ساتھ (براہ راست ٹارگٹ View کی وضاحت) اور value کے ساتھ (NavigationDestination کے لیے قدر)۔ شکل کا انتخاب iOS ورژن اور نیویگیشن آرکیٹیکچر پر منحصر ہے۔

Destination شکل (iOS 13+): NavigationLink(destination: DetailView(), label: { Text("Open") })۔ یہ شکل NavigationLink کو رینڈر کرتے وقت فوری طور پر DetailView بناتی ہے، چاہے صارف نے لنک پر کلک نہ بھی کیا ہو۔ یہ View کی قبل از وقت انیشیالائزیشن اور ممکنہ کارکردگی کے مسائل کا باعث بنتا ہے اگر ٹارگٹ View اپنے انیشیالائزر میں بھاری آپریشنز انجام دیتا ہے۔

Value شکل (iOS 16+): NavigationLink(value: "detail_42", label: { Text("Open") })۔ ٹارگٹ View صرف اس وقت بنایا جاتا ہے جب لنک دبایا جاتا ہے، جب SwiftUI متعلقہ .navigationDestination تلاش کرتا ہے۔ یہ قبل از وقت انیشیالائزیشن کو روکتا ہے اور نیویگیشن کو مزید پیش قیاس بناتا ہے۔

NavigationStack کے ساتھ NavigationLink: صحیح استعمال

NavigationStack کے ساتھ NavigationLink iOS 16+ میں value شکل میں تبدیل ہونے کی ضرورت ہے۔ آپ نیویگیشن کے لیے ڈیٹا کی ایک قسم (String, Int, enum Route) متعین کرتے ہیں اور .navigationDestination کے ذریعے منزل کو رجسٹر کرتے ہیں۔ NavigationLink صرف قدر کو اسٹیک پر رکھتا ہے، اور SwiftUI دبانے پر ٹارگٹ View بناتا ہے۔

struct CatalogView: View {
    let categories: [String]

    var body: some View {
        List(categories, id: \.self) { category in
            NavigationLink(value: category) {
                Text(category)
            }
        }
        .navigationDestination(for: String.self) { category in
            CategoryView(name: category)
        }
    }
}

// Programmatic navigation:
struct DeepLinkView: View {
    @State private var path: [AppRoute] = []

    var body: some View {
        NavigationStack(path: $path) {
            HomeView()
                .navigationDestination(for: AppRoute.self) { route in
                    switch route {
                    case .detail(let id): DetailView(id: id)
                    case .settings: SettingsView()
                    }
                }
                .toolbar {
                    Button("Open Settings") {
                        path.append(AppRoute.settings)
                    }
                }
        }
    }
}

پروگرامیٹک نیویگیشن: پاتھ میں قدر شامل کرنا (path.append کے ذریعے) اسی قدر کے ساتھ NavigationLink دبانے کے برابر ہے۔ یہ ViewModel، Coordinator یا push نوٹیفیکیشنز کے جواب میں نیویگیشن نافذ کرنے کی اجازت دیتا ہے۔

IsActive شکل (NavigationLink(isActive:destination:label:)) مطابقت کے لیے دستیاب ہے لیکن iOS 16+ میں تجویز نہیں کی جاتی۔ پاتھ صف یا NavigationPath پر Binding کے ساتھ value شکل استعمال کریں۔

List میں NavigationLink: خصوصیات

List میں NavigationLink خود بخود قطار کے دائیں جانب ایک انکشافی اشارہ (chevron) ظاہر کرتا ہے، صارف کو اشارہ کرتا ہے کہ دبانے سے دوسری اسکرین پر جایا جائے گا۔ List تیر کے ظاہر ہونے کا خود بخود انتظام کرتی ہے — ایک عام NavigationLink کے برعکس جو فہرست کے باہر ہوتا ہے، جہاں کوئی تیر نہیں ہوتا۔

iOS 16 کے ساتھ، NavigationLink والی List خود بخود List(data:rowContent:) کے اندر value شکل استعمال کرتی ہے۔ List کے اندر ForEach استعمال کرتے وقت، انکشافی اشارہ بھی خود بخود شامل ہو جاتا ہے۔ اس رویے کو موڈیفائرز کے ذریعے غیر فعال نہیں کیا جا سکتا — صرف NavigationLink کو Button سے تبدیل کرنے سے تیر ہٹ سکتا ہے۔

List میں destination شکل کا مسئلہ: اگر آپ List کے اندر NavigationLink(destination:label:) استعمال کرتے ہیں، تو تمام منزل Views فہرست لوڈ ہوتے ہی فوری طور پر بن جاتے ہیں، چاہے صارف نے لنک پر کلک کیا ہو یا نہیں۔ بڑی تعداد میں قطاروں والی فہرستوں کے لیے، یہ ابتدائی لوڈنگ کو نمایاں طور پر سست کر سکتا ہے اور میموری کی کھپت بڑھا سکتا ہے۔ NavigationStack کے ساتھ value شکل اس مسئلے کو حل کرتی ہے۔

WWDC 2022 (Session 10054) کے مطابق، Apple نئے پروجیکٹس کے لیے NavigationStack اور NavigationLink کی value شکل استعمال کرنے کی سفارش کرتا ہے۔ یہ خاص طور پر متحرک ڈیٹا والی List کے لیے اہم ہے، جہاں قطاروں کی تعداد زیادہ ہو سکتی ہے۔

NavigationLink استعمال کے پیٹرن

پیٹرن 1: حسب ضرورت NavigationLink ظاہری شکل۔ NavigationLink کسی بھی View کو بطور لیبل قبول کرتا ہے، جس سے لنک کے لیے حسب ضرورت ڈیزائن بنانے کی اجازت ملتی ہے۔ List کے اندر، یہ خاص طور پر آسان ہے — آپ NavigationLink استعمال کرتے ہوئے خودکار انکشافی اشارہ حاصل کرتے ہیں۔

NavigationLink(value: ProductRoute.detail(product)) {
    HStack {
        AsyncImage(url: product.imageURL)
            .frame(width: 60, height: 60)
        VStack(alignment: .leading) {
            Text(product.name).font(.headline)
            Text(product.price) .foregroundColor(.secondary)
        }
    }
    .padding(8)
}

پیٹرن 2: تیر کے بغیر NavigationLink (حسب ضرورت بٹن)۔ اگر آپ کو انکشافی اشارے کی ضرورت نہیں ہے تو، پروگرامیٹک نیویگیشن کے لیے Button استعمال کریں: path.append(value)۔ یہ حسب ضرورت انٹرفیس عناصر کے لیے مفید ہے جہاں NavigationLink غیر فطری لگتا ہے۔

پیٹرن 3: مشروط نیویگیشن۔ آپ خالی destination استعمال کرکے یا مخصوص اقدار کے لیے .navigationDestination شامل نہ کرکے NavigationLink کو بلاک کر سکتے ہیں۔ پاتھ کے ذریعے پروگرامیٹک نیویگیشن قدر شامل کرنے سے پہلے شرائط کی جانچ کرنے کی اجازت دیتا ہے۔

Hacking with Swift (2024) کے مطابق، NavigationLink کے زیادہ تر مسائل پرانے پروجیکٹس میں destination شکل کے استعمال سے متعلق ہیں۔ NavigationStack میں منتقلی کرتے وقت، تمام NavigationLink(destination:label:) کو NavigationLink(value:label:) سے تبدیل کریں اور روٹ لیول پر .navigationDestination شامل کریں۔