.onDisappear: مبدأ العمل والاستخدام في SwiftUI

ما هو .onDisappear؟

.onDisappear هو معدّل View في SwiftUI يأخذ إغلاقًا Void وينفذه عند إزالة View من التسلسل. مع .onAppear يُشكل دورة الحياة الكاملة للشاشة: الظهور — العمل — الاختفاء. قدمت Apple onDisappear مع إصدار SwiftUI في iOS 13 كبديل لـ viewDidDisappear من UIKit.

من الناحية التركيبية، .onDisappear مطابق لـ onAppear: يعدّل أي View ويُرفق إغلاقًا يستدعيه محرك عرض SwiftUI عند إزالة العرض. على عكس UIKit حيث يتم استدعاء viewDidDisappear فقط بعد اكتمال رسم الانتقال، يمكن استدعاء onDisappear في SwiftUI قبل انتهاء الرسم — في اللحظة التي يتم فيها وضع علامة على View للحذف.

بناء جملة onDisappear

بناء الجملة الأساسي لـ onDisappear موجز مثل onAppear. لا يقبل المعدّل معاملات إضافية — فقط الإغلاق الذي ينفذ بشكل متزامن في الخيط الرئيسي.

struct DetailView: View {
    var body: some View {
        Text("Detail Screen")
            .onDisappear {
                print("اختفت DetailView من الشاشة")
            }
    }
}

كيف يعمل .onDisappear

آلية الاستدعاء لـ onDisappear معاكسة لـ onAppear: العناصر الفرعية تستقبل onDisappear أولاً، ثم الأصل. تضمن هذه القاعدة child-first تحرير الموارد الفرعية قبل تحرير موارد الأصل. إذا كان العنصر الفرعي يعتمد على بيانات الأصل، يجب أن يكون قادرًا على الإنهاء بشكل صحيح دون سياق الأصل.

SwiftUI يستدعي onDisappear عندما تتم إزالة View من رسم البيان. المشغلات تشمل: pop من NavigationStack، تبديل TabView، إلغاء المشروط (sheet/fullScreenCover)، أو View معروض بشكل شرطي (if/switch). في List و ScrollView، يُستدعى onDisappear عندما يتم تمرير خلية خارج مخزن التحميل المسبق.

ترتيب الاستدعاء child-first

ترتيب child-first يعني أنه إذا كان VStack يحتوي على ثلاث View فرعية، فإن onDisappear يُستدعى أولاً لكل فرعي بترتيب عكسي، ثم للأصل. هذا ضروري للتنظيف الصحيح: يتم إلغاء المؤقتات الفرعية قبل أن يحرر ViewModel الأصل الموارد المشتركة.

struct ParentView: View {
    var body: some View {
        VStack {
            ChildView(id: "A")
            ChildView(id: "B")
        }
        .onDisappear {
            print("Parent onDisappear — الأخير")
        }
    }
}

struct ChildView: View {
    let id: String
    var body: some View {
        Text("Child \(id)")
            .onDisappear {
                print("Child \(id) onDisappear")
            }
    }
}

مخرجات الكونسول: Child B onDisappear، Child A onDisappear، Parent onDisappear — الأخير. الترتيب العكسي مقارنة بـ onAppear يضمن سلسلة تنظيف صحيحة.

متى يُستدعى .onDisappear

سيناريوهات الاستدعاء لـ onDisappear تعتمد على نوع الحاوية. في NavigationStack، يتم تفعيل onDisappear عند pop-to-root أو pop-back العادي أو إلغاء الشاشة بالسحب (interactivePopGestureRecognizer). في TabView، يؤدي تبديل التبويب إلى استدعاء onDisappear للتبويب المخفي و onAppear للظاهر — كلا المعدّلين يتم تفعيلهما بشكل متزامن تقريبًا.

في Sheet و fullScreenCover، يُستدعى onDisappear عند الإلغاء البرمجي (عبر @Environment(\.dismiss)) أو إيماءة السحب لأسفل. تفاصيل مهمة: إذا تم فتح sheet لكن المستخدم بدّل التطبيق، فإن onDisappear لا يُستدعى حتى الإغلاق الفعلي.

أمثلة .onDisappear

حالات الاستخدام الرئيسية لـ onDisappear هي تنظيف الموارد وحفظ الحالة والتتبع. على عكس onAppear، تُنفذ مهام onDisappear عند الخروج ولا تحتاج إلى فحص التكرار لأن View تختفي مرة واحدة.

حفظ الحالة وإلغاء المؤقتات

حفظ الحالة في onDisappear مفيد بشكل خاص للنماذج حيث يجب حفظ البيانات عند مغادرة الشاشة. يتم إلغاء المؤقتات واشتراكات Combine في onDisappear لمنع التسرب عند العودة إلى الشاشة.

struct FormView: View {
    @State private var draftText = ""
    @State private var timer: Timer?
    
    var body: some View {
        TextField("Enter text", text: $draftText)
            .onAppear {
                timer = Timer.scheduledTimer(withTimeInterval: 60, repeats: true) { _ in
                    saveDraft()
                }
            }
            .onDisappear {
                timer?.invalidate()
                timer = nil
                saveDraft()
            }
    }
    
    private func saveDraft() {
        UserDefaults.standard.set(draftText, forKey: "draft")
    }
}

إلغاء المؤقت في onDisappear يمنع تنفيذ الكود بعد إغلاق الشاشة بالفعل. بدون الإلغاء، قد يحاول المؤقت تحديث @State الذي لم يعد ينتمي إلى View الحالية، مما يسبب تحذير وقت التشغيل.

تتبع الوقت على الشاشة

مدة المكوث على الشاشة هي سيناريو تتبع كلاسيكي. سجل الوقت في onAppear، احسب الفرق في onDisappear وأرسل حدث تحليلي بمدة الجلسة.

struct TrackedView: View {
    @State private var appearTime: Date?
    
    var body: some View {
        Text("Tracked Screen")
            .onAppear {
                appearTime = Date()
                Analytics.shared.logEvent("screen_view", params: ["screen": "TrackedView"])
            }
            .onDisappear {
                if let start = appearTime {
                    let duration = Date().timeIntervalSince(start)
                    Analytics.shared.logEvent("screen_close", params: [
                        "screen": "TrackedView",
                        "duration_ms": Int(duration * 1000)
                    ])
                }
            }
    }
}

.onDisappear مقابل .onAppear — الفروقات

الفرق الرئيسي بين onDisappear و onAppear هو ترتيب الاستدعاء وضمانات التنفيذ. onAppear يُستدعى عند إضافة View إلى التسلسل ويمكن استدعاؤه مرة أخرى عند إعادة الإنشاء. onDisappear يُستدعى عند الإزالة ويضمن تفعيله فقط عند الإغلاق العادي، وليس في سيناريوهات التعطل.

وفقًا لمؤتمر WWDC 2024، توصي Apple باعتبار onDisappear نقطة تنظيف وليس نقطة تأكيد بيانات. يجب حفظ البيانات المهمة (المدفوعات، التسجيلات) في الوقت الفعلي، وليس في لحظة اختفاء View، لأن onDisappear غير مضمون عند تصغير التطبيق.

توصية: استخدم onDisappear فقط للتنظيف غير الحرج والتتبع. لحفظ البيانات، استخدم scenePhase أو إشعارات applicationWillTerminate في AppDelegate.

سيناريوهات الاستخدام النموذجية

السيناريو 1: تشغيل شبيه بـ YouTube. على شاشة تفاصيل الفيديو، يحفظ onDisappear موضع التشغيل في UserDefaults. عند إعادة الفتح، يستعيد onAppear الموضع من UserDefaults مما يخلق تجربة مشاهدة مستمرة.

السيناريو 2: إلغاء اشتراك Combine. إذا كان ViewModel يستخدم ناشري Combine، يلغي onDisappear الاشتراك عبر cancellable?.cancel(). هذا يمنع تحديثات UI بعد مغادرة الشاشة، وهو مهم بشكل خاص للقوائم ذات الترقيم الصفحي واستعلامات البحث.

السيناريو 3: إغلاق WebSocket. في التطبيقات ذات الاتصالات الفورية (المراسلات، خلاصات الأسعار)، يغلق onDisappear اتصال WebSocket لتوفير البطارية والبيانات. تتم إعادة الاتصال في onAppear عند العودة إلى الشاشة.

إغلاق WebSocket في onDisappear

WebSocket هو مورد نموذجي يجب إغلاقه عند مغادرة الشاشة. في المثال أدناه، يفصل onDisappear الاتصال، ويعيد onAppear الاتصال، مما يوفر توفيرًا كبيرًا في البيانات للتطبيقات ذات الشاشات المتعددة.

struct ChatView: View {
    @StateObject private var socket = WebSocketManager()
    
    var body: some View {
        ChatListView(messages: socket.messages)
            .onAppear {
                socket.connect()
            }
            .onDisappear {
                socket.disconnect()
            }
    }
}

مهم: عند التبديل بين تبويبات TabView، يتم تفعيل onDisappear للتبويب الحالي و onAppear للتبويب التالي بشكل متزامن تقريبًا. بالنسبة لـ WebSocket، قد يتسبب هذا في دورة فصل-إعادة اتصال تخلق حملاً غير ضروري. الحل هو استخدام تأخير أو التحقق مما إذا كان الاتصال مطلوبًا على الشاشة التالية.