SwiftUI میں @Environment — یہ کیا ہے، بنیادی مفاہیم اور میکانزم

SwiftUI میں @Environment کیا ہے?

@Environment ایک SwiftUI property wrapper ہے جو سسٹم ماحول سے قدرتیں پڑھنے کے لیے ڈزائن کیا گیا ہے۔ ماحول قدرتوں کا ایک درجہ بند کنٹینر ہے جسے SwiftUI والد View سے تفریعی View میں خودکار طور پر پھیلاتا ہے۔ هر ماحول قدرت ایک کنجی سے پہچانی جاتی ہے — ایک قسم جو EnvironmentKey پروٹوکول کی پیروی کرتا ہے۔

ماحول کا میکانزم فریم ورک کی سطح پر dependency injection کے مشابہ ہے: سسٹم قدرتوں کا ایک متعین کردہ سیٹ فراہم کرتا ہے — رنگ اسکیم (ہلکا/اندھیرا)، مقامی ترتیبات، فونٹ کا سائز، Core Data کے لیے managedObjectContext، سکرین بند کرنے کے لیے dismiss، اور بہت سے دیگر۔ ایک View جو ایک مختصص کنجی کے ساتھ @Environment کا اعلان کرتا ہے خودکار طور پر موجودہ قدرت حاصل کرتا ہے اور اس کے بدلنے پر دوبارہ رینڈر ہوتا ہے۔

SwiftUI ماحول کے فن کے گجرداری EnvironmentValues پروٹوکول پر مبنی ہے — ایک ساخت جیسمیں تمام سسٹم قدرتیں ہوتی ہیں۔ ہر قدرت getter اور setter کے ساتھ اس ساخت کی ایک خاصیت کے طور پر محفوظ ہوتی ہے۔ @Environment ایک مختصص خاصیت تک رسائی کے لیے key path استعمال کرتا ہے: @Environment(\.colorScheme) — رنگ اسکیم تک رسائی، @Environment(\.locale) — مقامی ترتیبات تک رسائی۔

@Environment بحیثیت Property Wrapper

Property wrapper @Environment دو بنیادی میکانزم نفذ کرتا ہے: ماحول سے قدرت پڑھنا اور اس کی تبدیلیوں کی سبسکرائیب۔ جب کئی View تیار ہوتی ہے، SwiftUI تمام @Environment خوصیات سے گزرتا ہے اور انہیں موجودہ سیاق سے متبادل قدرتوں سے منسلک کرتا ہے۔ اگر ایک والد View .environment() موڈیفائر کے ذریعے قدرت بدلتا ہے، تو وہ قدرت پڑھنے والے تمام تفریعی View خودکار طور پر دوبارہ رینڈر ہو جاتے ہیں۔

ایک اہم خصوصیت: @Environment اختیاری قدرتوں کی حمایت کرتا ہے۔ اگر درجہ بندی میں کوئی قدرت مقرر نہیں ہے، تو EnvironmentKey میں متعین کردہ پھلی سے طے کی قدرت واپس کی جاتی ہے۔ سسٹم کنجیوں کے لیے، پھلی سے طے کی قدرت ہمیشہ مناسب ہوتی ہے — مثال کے طور پر، پھلی سے طے کی رنگ اسکیم .light ہے۔ کسٹم کنجیوں کے لیے، ڈیویلپر EnvironmentKey پروٹوکول کے defaultValue طریقے میں پھلی سے طے کی قدرت متعین کرتا ہے۔

struct EnvironmentReaderView: View {
    @Environment(\.colorScheme) var colorScheme
    @Environment(\.locale) var locale
    @Environment(\.sizeCategory) var sizeCategory

    var body: some View {
        VStack {
            Text("Current scheme: \(colorScheme == .dark ? "Dark" : "Light")")
            Text("Locale: \(locale.identifier)")
            Text("Font size: \(sizeCategory)")
        }
    }
}

مثال میں، View تین سسٹم ماحول قدرتیں پڑھتا ہے۔ جب colorScheme بدلتا ہے — مثال کے طور پر، صاحب استعمال نے ترتیبات میں ڈارک موڈ فعال کیا — View خودکار طور پر نئی قدرت کے ساتھ دوبارہ رینڈر ہوتا ہے۔ ایسے ہی جب علاقہ یا فونٹ کا سائز (Dynamic Type) بدلتا ہے۔ View کو اطلاعات کی رکندگی لینے یا refresh کال کرنے کی ضرورت نہیں ہے — SwiftUI اسے خودکار طور پر منتظم کرتا ہے۔

سسٹم ماحول کی قدرتیں

SwiftUI انٹرفیس اور رویہ کے مختلف پہلوئوں کو گھیرے کرنے والی درجنوں سسٹم ماحول قدرتیں فراہم کرتا ہے۔ رنگ اسکیم (\.colorScheme) سب سے زیاده استعمال کی جانے والی قدرتوں میں سے ایک ہے، جو انٹرفیس کو ہلکے اور اندھیرے ثیم کے مطابق ڢٹنے کی اجازت دیتا ہے۔ مقامی ترتیبات (\.locale) میں تاریخوں، عددوں اور کرنسیوں کی فرمیٹنگ کے لیے صاحب استعمال کی علاقائی ترتیبات شامل ہیں۔

Core Data کے لیے، managedObjectContext (\.managedObjectContext) استعمال ہوتا ہے — ایک سیاق جو استقلال کنٹینر سے ماحول کے ذریعے گزارا جاتا ہے۔ نیویگیشن کے لیے، موجودہ سکرین بند کرنے کے لیے dismiss (\.dismiss) اور موڈل پرستاونیوں کے لیے isPresented (\.isPresented) دستیاب ہیں۔ کیلنڈر اور وقتی زون کے لیے — بالترتیب calendar اور timeZone۔

سسٹم قدرتوں تک رسائی کے لیے، نقطے کے ساتھ key path استعمال کریں: @Environment(\.dismiss) var dismiss۔ کامپائلر EnvironmentValues میں key path کی موجودگی کی جانچ کرتا ہے، اس لیے ایک غلط کنجی کامپائل ٹائم کی غلطی کا سبب بنے گی۔ Apple iOS کے ہر نئے ورزن کے ساتھ نئی سسٹم قدرتیں شامل کرتا ہے — مکمل فہرست EnvironmentValues دستاویز میں دستیاب ہے۔

@Environment بنام @EnvironmentObject

ایک جیسے ناموں کے باوجود، @Environment اور @EnvironmentObject مختلف مقاصد کی تکمیل کرتے ہیں۔ @Environment EnvironmentKey کے ذریعے رجسٹر شدہ سسٹم یا کسٹم قدرتوں کو پڑھتا ہے۔ @EnvironmentObject ایک ObservableObject کے لیے property wrapper ہے جو بغیر واضح کنجی کے قسم کے اعتبار سے ماحول کے ذریعے گزارا جاتا ہے۔

@EnvironmentObject dependency injection کے لیے استعمال ہوتا ہے: ایک والد View ایک آبجیکٹ (مثال کے طور پر ViewModel) تیار کرتا ہے اور .environmentObject() موڈیفائر کے ذریعے تفریعی View میں بھیجتا ہے۔ تفریعی View اسے @EnvironmentObject کے ذریعے وصول کرتے ہیں اور اس کی خوصیات کو پڑھ اور ترمیم کر سکتے ہیں۔ دوسری جانب، @Environment سسٹم قدرتوں کے لیے صرف پڑھنے کے لیے ہے اور فیڈبیک کی حمایت نہیں کرتا۔

عملی طور پر: سسٹم پیرامیٹرز (ثیم، مقامی ترتیبات، فونٹ کا سائز) اور ایسے کسٹم ترتیبات جو رن ٹائم میں نہیں بدلتے تک رسائی کے لیے @Environment استعمال کریں۔ View کے درجہ بندی کے ذریعے ViewModel یا سروس گزارنے کے لیے @EnvironmentObject استعمال کریں جب حالت کو تفریعی اجزاء سے ترمیم کرنے کی ضرورت ہو۔

@Environment کوڈ کی مثالیں

ایک کسٹم ماحول قدرت بنانے پر غور کریں۔ ایسا کرنے کے لیے، آپ کو EnvironmentKey پروٹوکول کی پیروی کرنے والی ایک ساخت متعین کرنے اور EnvironmentValues کو ایک نئی خاصیت سے وسیع کرنے کی ضرورت ہے۔ یہ props کے بغیر پورے View درخت میں ثیم ترتیبات یا ایپ سیٹنگز گزارنے کی اجازت دیتا ہے۔

struct AppThemeKey: EnvironmentKey {
    static let defaultValue: AppTheme = .system
}

extension EnvironmentValues {
    var appTheme: AppTheme {
        get { self[AppThemeKey.self] }
        set { self[AppThemeKey.self] = newValue }
    }
}

enum AppTheme { case system, light, dark }

EnvironmentKey پروٹوکول کو ستاٹک defaultValue خاصیت کے نفاذ کی ضرورت ہے — وہ قدرت جو استعمال ہوگی اگر والد View نے کسٹم ماحول مقرر نہیں کیا۔ EnvironmentValues کو وسیع کرنا کنجی کے ساتھ subscript استعمال کرکے ایک حساب شدہ خاصیت appTheme شامل کرتا ہے۔ اس کے بعد، کئی بھی View @Environment(\.appTheme) کے ذریعے قدرت پڑھ سکتا ہے۔

ایک کسٹم کنجی کے ساتھ @Environment کا استعمال

struct ThemedView: View {
    @Environment(\.appTheme) var appTheme
    @Environment(\.colorScheme) var colorScheme

    var body: some View {
        VStack {
            if appTheme == .dark || (appTheme == .system && colorScheme == .dark) {
                Text("Dark mode active")
                    .foregroundStyle(.white)
                    .background(Color.black)
            } else {
                Text("Light mode active")
                    .foregroundStyle(.black)
                    .background(Color.white)
            }
        }
    }
}

struct ContentView: View {
    @State private var selectedTheme = AppTheme.system

    var body: some View {
        ThemedView()
            .environment(\.appTheme, selectedTheme)
    }
}

ThemedView دو ماحول پڑھتا ہے: کسٹم appTheme اور سسٹم colorScheme۔ یہ مجموعہ لچیلا ثیم ترتیب کی اجازت دیتا ہے: صاحب استعمال ہلکا، اندھیرا یا سسٹم ثیم منتخب کر سکتا ہے۔ اگر سسٹم منتخب کیا جاتا ہے، قدرت colorScheme سے لی جاتی ہے، جو iOS ترتیبات میں ثیم بدلنے پر خودکار طور پر بدلتا ہے۔ والد View (ContentView) .environment() موڈیفائر کے ذریعے appTheme قدرت مقرر کرتا ہے۔

ایک سکرین بند کرنے کے لیے dismiss کا استعمال

struct ModalView: View {
    @Environment(\.dismiss) var dismiss
    @State private var name = ""

    var body: some View {
        NavigationStack {
            Form {
                TextField("Your name", text: $name)
                Button("Save") { dismiss() }
            }
            .navigationTitle("Edit Profile")
        }
    }
}

یہ مثال dismiss کے عملی استعمال کو ظاہر کرتا ہے — ماحول سے DismissAction کی ایک مثال۔ ایک فنکشن کے طور پر dismiss() کو کال کرنے سے موڈل سکرین بند ہو جاتی ہے یا NavigationLink واپس آ جاتا ہے۔ واحد شرط یہ ہے کہ View موڈل طور پر پیش کیا جائے یا NavigationStack کے اندر ہو۔ dismiss سیاق سے خودکار طور پر متعین ہوتا ہے: اگر View ایک sheet کے طور پر کھولی گئی ہے — sheet بند ہوتی ہے، اگر popover کے طور پر — popover بند ہوتا ہے۔