الـ view في SwiftUI هو struct ينشئه SwiftUI ويقرؤه ويتخلّص منه متى شاء. فأين تعيش معلومة «فعّل المستخدم فلتر المصاريف الكبيرة فقط»؟ ليس في خاصية عادية: فالـ struct الذي يحملها قد يختفي بعد لحظة، ومن داخل body لا تستطيع حتى تغييرها. جواب SwiftUI مجموعة صغيرة من الـ property wrappers (أغلفة الخصائص)، كلٌّ منها يجيب عن سؤال واحد: من يملك هذه البيانات؟
import SwiftUI\n\nstruct ExpensesScreen: View {\n @State private var showLargeOnly = false\n\n var body: some View {\n Toggle(\"Large expenses only\", isOn: $showLargeOnly)\n }\n}يخبر @State إطار SwiftUI أن يحتفظ بالقيمة في تخزين يديره هو، مرتبط بموقع هذا الـ view في الهرمية. يمكن إعادة إنشاء الـ struct مئة مرة وتبقى القيمة. وحين تتغيّر القيمة، يعيد SwiftUI قراءة body ويحدّث الشاشة.
العلامة $ في $showLargeOnly تطلب binding (ربطًا): اتصالًا في الاتجاهين مع الـ state. الـ Toggle لا يملك قيمة التشغيل والإيقاف؛ بل يستقبل binding ليقرأ القيمة الحالية ويكتب القيمة الجديدة عند النقر. وكل عنصر إدخال (TextField وToggle وPicker وDatePicker وSlider) يعمل بهذه الطريقة.
استخرج الـ toggle إلى view مستقل، وسيحتاج الابن إلى تغيير state يملكها الأب:
\nstruct FilterBar: View {\n @Binding var showLargeOnly: Bool\n\n var body: some View {\n Toggle(\"Large expenses only\", isOn: $showLargeOnly)\n }\n}\n\n// In ExpensesScreen's body:\nFilterBar(showLargeOnly: $showLargeOnly)يبقى الأب مصدر الحقيقة الوحيد (single source of truth)؛ ويحصل الابن على binding إليه. لو أعلن الابن @State بدلًا من ذلك، لحمل نسخة منفصلة تبدأ بقيمة الأب ثم تبتعد عنها. هذا هو الخطأ الكامن وراء معظم أسئلة «الـ toggle عندي لا يفعل شيئًا».
مفتاح الفلتر ينتمي إلى شاشة واحدة. أما قائمة المصاريف فتنتمي إلى التطبيق كله: القائمة تعرضها، والملخّص يجمعها، ونموذج الإضافة يضيف إليها. هذه هوية مشتركة، وقد قال درس الـ structs إنها تستدعي class. علّمه بالماكرو @Observable من إطار Observation:
import Observation\nimport Foundation\n\n@Observable\nfinal class BudgetStore {\n var expenses: [Expense] = []\n var monthlyLimit: Decimal = 1500\n\n var totalSpent: Decimal {\n expenses.reduce(0) { $0 + $1.amount }\n }\n\n var remaining: Decimal {\n monthlyLimit - totalSpent\n }\n\n func add(_ expense: Expense) {\n expenses.append(expense)\n }\n}لا property wrappers على الخصائص، ولا publishers. يعيد الماكرو كتابة كل خاصية مخزّنة حتى يستطيع SwiftUI تسجيل أيّها يقرأ الـ body. الـ view الذي يعرض store.remaining يقرأ monthlyLimit وexpenses من خلالها، فيتحدّث حين تتغيّر أيٌّ منهما؛ أما الـ view الذي يعرض الحدّ فقط فيتجاهل المصاريف الجديدة.
لاحظ أن totalSpent وremaining محسوبتان لا مخزّنتان. من المغري أن تحتفظ بـ var total وتحدّثها في add، لكن عندئذٍ يجب على كل method مستقبلية تمسّ expenses (الحذف، التعديل، الاستيراد) أن تتذكّر تحديثها أيضًا، وذات يوم ستنسى إحداها. خزّن الحدّ الأدنى من الحقائق واشتقّ كل ما عداها. يتتبّع Observation الخصائص المحسوبة عبر الخصائص المخزّنة التي تقرؤها، فتبقى الشاشة صحيحة دون أي جهد.
أنشئ المخزن مرة واحدة، قرب قمّة التطبيق، وامتلكه عبر @State:
@main\nstruct PocketBudgetApp: App {\n @State private var store = BudgetStore()\n\n var body: some Scene {\n WindowGroup {\n ExpensesScreen(store: store) // ExpensesScreen now has `let store: BudgetStore`\n .environment(store)\n }\n }\n}تستطيع الـ views الأبناء أن تأخذ المخزن كخاصية عادية let store: BudgetStore وتستدعي store.add(…)؛ لا حاجة إلى أي wrapper للقراءة أو لاستدعاء الـ methods. وللشاشات العميقة في الهرمية، يجعله .environment(store) متاحًا دون تمريره عبر كل مُهيِّئ، ويلتقطه الـ view عبر @Environment(BudgetStore.self) private var store.
حقل TextField الذي يعدّل الحدّ الشهري يحتاج إلى binding إلى store.monthlyLimit. و@Bindable يوفّره:
struct SettingsScreen: View {\n @Environment(BudgetStore.self) private var store\n\n var body: some View {\n @Bindable var store = store\n Form {\n TextField(\"Monthly limit\", value: $store.monthlyLimit, format: .currency(code: \"USD\"))\n .keyboardType(.decimalPad)\n }\n }\n}حين يصل المخزن كخاصية، اكتب @Bindable var store: BudgetStore بدلًا من ذلك؛ أما الصيغة المحلية المعروضة هنا فهي للكائنات القادمة من الـ environment.
لتقرّر أيّ wrapper تستخدم، اسأل من يملك البيانات. هل يملك هذا الـ view قيمة بسيطة؟ @State. هل يحتاج إلى تغيير قيمة يملكها غيره؟ @Binding. هل هي بيانات تطبيق مشتركة؟ class من نوع @Observable، يُملَك مرة واحدة عبر @State ويُمرَّر إلى الأسفل. الدرس التالي يشغّل المخزن في قائمة حقيقية مع تنقّل ونموذج لإضافة مصروف.
@State يخزّن القيمة خارج الـ struct الخاص بالـ view فتبقى بعد كل re-render؛ علّمها بـ private، لأن الـ view هو من يملكها.","البادئة $ تعطيك Binding: صلاحية قراءة وكتابة على مصدر حقيقة يملكه غيرك، وهذا ما تحتاجه عناصر التحكّم مثل Toggle وTextField.","علّم الـ class الخاص بالنموذج المشترك بـ @Observable، فيعيد SwiftUI رسم الـ views التي قرأ الـ body الخاص بها خاصية تغيّرت فقط.","امتلك كائن @Observable عبر @State في الأعلى، ثم مرّره إلى الأسفل مباشرةً أو عبر .environment(_:).","استخدم @Bindable حين تحتاج bindings إلى خصائص كائن @Observable، مثلًا لتعديلها في نموذج."],"further":[{"title":"Managing model data in your app","url":"https://developer.apple.com/documentation/swiftui/managing-model-data-in-your-app"},{"title":"State","url":"https://developer.apple.com/documentation/swiftui/state"},{"title":"Observation","url":"https://developer.apple.com/documentation/observation"}],"quiz":[{"q":"يعلن view عن var count = 0 وينفّذ زرٌّ count += 1. ماذا يحدث؟
body لا يستطيع تعديل خاصية مخزّنة عادية، فتفشل الترجمة."},{"text":"لا يُترجَم، لأن self غير قابل للتغيير داخل body؛ الخاصية تحتاج إلى @State.","why":"صحيح. @State ينقل التخزين من الـ struct إلى SwiftUI، فيجعلها قابلة للكتابة ومراقَبة."},{"text":"يعمل، لأن الـ views في SwiftUI هي classes.","why":"الـ views هي structs، وهذا بالضبط سبب عدم قدرة الخصائص العادية على التغيّر من داخل body."}],"answer":1},{"q":"يملك الأب @State private var showLargeOnly = false. ويجب على الابن FilterBar أن يبدّل قيمتها. ماذا يعلن الابن، وماذا يمرّر الأب؟
@Binding var showLargeOnly: Bool. والأب يمرّر $showLargeOnly.","why":"صحيح. الـ binding يعطي الابن صلاحية القراءة والكتابة، بينما يبقى الأب مصدر الحقيقة الوحيد."},{"text":"الابن: @State var showLargeOnly: Bool. والأب يمرّر showLargeOnly.","why":"@State سينشئ نسخة ثانية مستقلّة؛ ولن يرى الأب التغيير أبدًا."},{"text":"الابن: var showLargeOnly: Bool. والأب يمرّر $showLargeOnly.","why":"الخاصية العادية لا تستطيع استقبال Binding، وحتى لو تطابق النوع لما استطاعت الكتابة رجوعًا."}],"answer":0},{"q":"أيّ الـ views يُعاد رسمها حين تتغيّر store.monthlyLimit في مخزن من نوع @Observable؟
body الخاص به فعلًا."},{"text":"فقط الـ views التي قرأ الـ body الخاص بها monthlyLimit، أو خاصية محسوبة تستخدمها.","why":"صحيح. هذا التتبّع الدقيق هو التحسين الأساسي مقارنةً بـ ObservableObject الأقدم."}],"answer":2},{"q":"تحصل شاشة الإعدادات على المخزن عبر @Environment(BudgetStore.self) private var store وتحتاج إلى $store.monthlyLimit لحقل TextField. ماذا تضيف؟
@State.","why":"@State سينشئ مخزنًا جديدًا تملكه هذه الشاشة بدل استخدام المخزن المشترك."},{"text":"@Bindable var store = store في أعلى body.","why":"صحيح. @Bindable ينشئ bindings إلى خصائص كائن @Observable، ويمكن إعلانه كمتغيّر محلي داخل body."},{"text":"تعلّم monthlyLimit بـ @Published.","why":"@Published ينتمي إلى نظام ObservableObject الأقدم ولا ينشئ bindings بنفسه."}],"answer":1}],"exercise":{"kind":"spot-bug","language":"swift","code":"import SwiftUI\n\nstruct ExpenseCard: View {\n let expense: Expense\n var isExpanded = false\n\n var body: some View {\n VStack(alignment: .leading, spacing: 8) {\n Text(expense.title)\n .font(.headline)\n if isExpanded {\n Text(expense.date, format: .dateTime.weekday().day().month())\n Text(expense.category.title)\n }\n Button(isExpanded ? \"Less\" : \"More\") {\n isExpanded.toggle()\n }\n }\n }\n}","bugLines":[5],"title":"البطاقة التي لا تتوسّع","prompt":"يجب أن تعرض هذه البطاقة التاريخ والتصنيف حين ينقر المستخدم More. لكنها لا تُبنى: يُبلغ Xcode عن “cannot use mutating member on immutable value: ‘self’ is immutable” عند استدعاء toggle(). اختر السطر الذي يجب تغييره لإصلاح المشكلة.
isExpanded؟","الـ structs الخاصة بالـ views لا تستطيع تغيير خصائصها المخزّنة العادية من داخل body.","أيّ property wrapper يخبر SwiftUI أن يملك قيمة ويخزّنها لهذا الـ view؟"],"explanation":"السطر 5 يعلن isExpanded كخاصية مخزّنة عادية في struct، فلا شيء داخل body يستطيع تغييرها، ولن يعرف SwiftUI أن عليه إعادة الرسم حتى لو استطاع. أعلنها كـ state يملكها الـ view:
@State private var isExpanded = falseالآن يخزّن SwiftUI القيمة خارج الـ struct، ويُترجَم toggle()، وكل نقرة تعيد رسم البطاقة. وتشير private إلى أن هذا الـ view وحده يملك القيمة؛ أما الأب الذي يحتاج إلى التحكّم بها فسيمرّر @Binding بدلًا من ذلك.