@ObservedObject: bu nədir, obyektlərin müşahidəsi və View yenilənməsi

SwiftUI-də @ObservedObject nədir

@ObservedObject — View-i ObservableObject dəyişikliklərinə abunə edən property wrapper-dır. @ObservedObject ilə işarələnmiş obyekt @Published ilə elan edilmiş hər hansı xassəsini dəyişdikdə, SwiftUI avtomatik olaraq View-i yenidən çəkir. @ObservedObject obyekt yaratmır — o, yalnız mövcud ObservableObject nümunəsi ilə onun dəyişikliklərinə reaksiya verməli olan View arasında əlaqə qurur.

@ObservedObject ilə @StateObject arasındakı əsas fərq — sahiblikdir. @ObservedObject obyektin View iyerarxiyasında yuxarıda yaradıldığını və saxlandığını nəzərdə tutur. Uşaq View bu obyektin istinadını inizializator vasitəsilə alır və sadəcə onu müşahidə edir. Uşaq View yenidən yaradılarsa, valideyndən eyni istinadı alacaq — məlumatlar itirilməyəcək.

Apple Developer Documentation — SwiftUI (2025)-yə görə, @ObservedObject iOS 13-dən etibarən mövcuddur ki, bu da onu köhnə iOS versiyalarını dəstəkləyən layihələrdə ObservableObject-i müşahidə etmək üçün yeganə seçim edir. iOS 14+-də obyekt yaratmaq üçün @StateObject üstünlük təşkil edir, lakin @ObservedObject mövcud obyektlərini ötürmək üçün aktual qalır.

@ObservedObject necə işləyir

@ObservedObject mexanizmi Combine framework-dan ObservableObject protokoluna əsaslanır. ObservableObject-ə uyğun gələn hər bir sinif avtomatik olaraq objectWillChange publisher-ı alır ki, o da hər hansı @Published xassəsi dəyişməzdən əvvəl siqnal göndərir. SwiftUI @ObservedObject vasitəsilə bu publisher-a abunə olur və siqnal aldıqda View-i yenidən çəkilməli kimi qeyd edir.

class TaskViewModel: ObservableObject {
    @Published var tasks: [Task] = []
    @Published var isLoading = false
    
    func loadTasks() async {
        isLoading = true
        // məlumatları yüklə
        isLoading = false
    }
}

struct TaskListView: View {
    @ObservedObject var viewModel: TaskViewModel
    
    var body: some View {
        List(viewModel.tasks) { task in
            Text(task.title)
        }
        .task { await viewModel.loadTasks() }
    }
}

Valideyn View viewModel-i TaskListView-ə inizializator vasitəsilə ötürdükdə, SwiftUI obyekt və View arasında əlaqə yaradır. tasks massivi və ya isLoading bayrağı dəyişdikdə SwiftUI TaskListView-i yenidən çəkir. Obyekt isə dəyişməz qalır — o, valideyn View-də @StateObject vasitəsilə saxlanılır.

@ObservedObject vs @StateObject: nə vaxt nə istifadə etməli

@ObservedObject ilə @StateObject arasındakı fərq — müşahidəçi ilə sahib arasındakı fərqdir. @StateObject obyekt yaradır və onun həyat dövrünü idarə edir. @ObservedObject yalnız başqa yerdə yaradılmış və saxlanılmış obyekti müşahidə edir. Onlar arasında seçim View-in məlumatlara görə məsuliyyəti ilə müəyyən edilir.

Əsas qayda: əgər View obyekt yaradırsa — @StateObject. Əgər View obyekt qəbul edirsə — @ObservedObject. Bu qaydanın @ObservedObject lehinə pozulması obyekt yaratmaq üçün View yenidən qurulduqda məlumat itkisinə səbəb olur. @StateObject lehinə pozulması isə valideyndən asılı olmayan təkrarlanan nümunə yaradır.

@ObservedObject istifadə nümunələri

@ObservedObject üçün tipik ssenari — kök View-in view model yaratdığı və siyahı xanasının onu @ObservedObject vasitəsilə aldığı tapşırıq siyahısıdır. Hər bir xana view model metodlarını çağıra bilər və dəyişikliklər avtomatik olaraq bütün siyahıda əks olunur, çünki bütün xanalar eyni obyekti müşahidə edir.

struct TaskRow: View {
    @ObservedObject var viewModel: TaskViewModel
    let task: Task
    
    var body: some View {
        HStack {
            Text(task.title)
            Spacer()
            Button("Hazır") {
                viewModel.completeTask(task)
            }
        }
    }
}

struct TaskListContainer: View {
    @StateObject var viewModel = TaskViewModel()
    
    var body: some View {
        List(viewModel.tasks) { task in
            TaskRow(viewModel: viewModel, task: task)
        }
    }
}

Bu nümunədə TaskListContainer viewModel-i @StateObject vasitəsilə yaradır, hər bir TaskRow isə onu @ObservedObject vasitəsilə alır. İstifadəçi hər hansı sətirdə “Done” düyməsini kliklədikdə, viewModel.completeTask published xassəsini dəyişir və bu obyekti müşahidə edən bütün View-lər avtomatik yenilənir.

@ObservedObject ilə tipik səhvlər

Ən geniş yayılmış səhv — View daxilində obyekt yaratmaq üçün @ObservedObject istifadə etməkdir. View yenidən qurulduqda (məsələn, state dəyişdikdə), SwiftUI yeni ObservableObject nümunəsi yaradır ki, bu da bütün toplanmış məlumatların itirilməsinə səbəb olur. Bu səhv xüsusilə NavigationStack-də ağrılıdır, burada istifadəçi formu doldura və geri qayıtdıqda məlumatları itirə bilər.

Səhv: @ObservedObject @StateObject əvəzinə

// ❌ Məlumat itkisi: @ObservedObject obyekti saxlamır
struct FormView: View {
    @ObservedObject var formVM = FormViewModel()
    // Hər View yenidən qurulduqda yeni formVM yaradılır!
}

// ✅ Düzgün: @StateObject obyekti saxlayır
struct FormView: View {
    @StateObject var formVM = FormViewModel()
    // Obyekt View-in həyatı boyunca bir dəfə yaradılır
}

Səhv: @StateObject-in @ObservedObject lazım olan yerdə ötürülməsi

Əgər uşaq View eyni ObservableObject-i @StateObject vasitəsilə elan edirsə, müstəqil surət yaradır. Valideyn obyektində dəyişikliklər uşaqda görünməyəcək və əksinə. Həmişə xaricdən obyekt alan uşaq View-lər üçün @ObservedObject istifadə edin.

SwiftUI-də @ObservedObject alternativləri

Müasir SwiftUI-də @ObservedObject-ə bir neçə alternativ var, hər birinin öz üstünlükləri ilə. Seçim tətbiqin arxitekturasından, iOS versiyasından və konkret istifadə ssenarisindən asılıdır.

• @EnvironmentObject — SwiftUI mühitindən obyekti açıq ötürmədən almağa imkan verir. Çox ekrana ehtiyacı olan obyektlər üçün əlverişlidir, lakin .environmentObject() vasitəsilə açıq tətbiq tələb edir.
• @State + @Binding — sadə dəyər tipləri üçün ObservableObject lazım deyil. Saxlamaq üçün @State və uşaq View-lərə ötürmək üçün @Binding istifadə edin.
• @AppStorage — View ilə avtomatik sinxronlaşmalı UserDefaults dəyərləri üçün.
• @SceneStorage — səhnənin yenidən başladılması arasında müvəqqəti vəziyyəti saxlamaq üçün (məsələn, siyahıdakı mövqe).

@ObservedObject ilə @EnvironmentObject arasında seçim — üslub və arxitektura məsələsidir. @ObservedObject View-in asılılıqlarını inizializator vasitəsilə açıq şəkildə göstərir ki, bu da kodu daha proqnozlaşdırılan edir. @EnvironmentObject dərin iyerarxiyalar üçün əlverişlidir, lakin asılılıqları gizlədir ki, bu da sazlamağı çətinləşdirə bilər.