تركيب أغلفة خصائص متعددة

يمكن تطبيق عدة مغلفات خصائص على خاصية واحدة. ويهم الترتيب — إذ تغلف المغلفات الخارجية المغلفات الداخلية — كما يتبع ترتيب التهيئة ترتيب التصريح.

```swift @propertyWrapper struct A { var wrappedValue: Int { didSet { print("A") } } init(wrappedValue: Int) { self.wrappedValue = wrappedValue } } @propertyWrapper struct B { var wrappedValue: Int { didSet { print("B") } } init(wrappedValue: Int) { self.wrappedValue = wrappedValue } } struct S { @A @B var x = 0 } ```

عند كتابة `@A @B var x`، تكون إعادة الصياغة كما يلي: ```swift var _x: A> = A(wrappedValue: B(wrappedValue: 0)) ``` يغلّف A، ‏B الذي يغلّف Int.

```swift @propertyWrapper struct Trimmed { var wrappedValue: String { didSet { wrappedValue = wrappedValue.trimmingCharacters(in:.whitespaces) } } init(wrappedValue: String) { self.wrappedValue = wrappedValue.trimmingCharacters(in:.whitespaces) } } @propertyWrapper struct NonEmpty { var wrappedValue: String { didSet { if wrappedValue.isEmpty { wrappedValue = "(empty)" } } } init(wrappedValue: String) { self.wrappedValue = wrappedValue.isEmpty ? "(empty)" : wrappedValue } } struct Form { @NonEmpty @Trimmed var username = " " } ```

تتم تهيئة المغلّفات من المغلّف الخارجي إلى الداخلي. وهذا يعني أن مُهيّئ المغلّف الخارجي يتلقى نتيجة تحويل المغلّف الداخلي، وليس القيمة الأصلية.

• لا تتوافق جميع المغلّفات معًا بسلاسة — تحقّقوا من تطابق أنواع `wrappedValue` • قد لا يسمح مترجم Swift دائمًا باستخدام مغلّفات متعددة (يعتمد ذلك على توافق نوع القيمة المغلّفة) • لا يتيح الوصول إلى `projectedValue` عبر `$x` سوى إسقاط المغلّف الخارجي

لا يتيح SwiftUI تكديس `@EnvironmentObject` و`@Published` على الخاصية نفسها، ولكن يمكنكم مراقبة نماذج `@EnvironmentObject` التي تستخدم `@Published` داخليًا.

استخدموا `_propertyName` للوصول مباشرةً إلى مثيل المغلّف: ```swift print(form._username) // A> — the outer wrapper instance ```

غالبًا ما يكون تركيب المنطق داخل مغلّف واحد أوضح: ```swift @propertyWrapper struct CleanUsername { var wrappedValue: String { didSet { wrappedValue = clean(wrappedValue) } } func clean(_ s: String) -> String { let t = s.trimmingCharacters(in:.whitespaces) return t.isEmpty ? "(empty)" : t } } ```

المكدسات الشائعة الصالحة: • `@UserDefault` + `@Published` (حفظ البيانات + المراقبة) • `@NonNegative` + `@Clamped` (طبقات التحقّق) • المخصصة لإطار العمل: `@Environment` + `@Binding` في عروض SwiftUI

أيّ مغلّف تتم تهيئته أولًا عند تكديس مغلّفي خاصية؟

النقاط الأساسية: • تُعاد صياغة `@A @B var x` إلى `A>` • تتم تهيئة المغلّف الخارجي باستخدام `wrappedValue` الخاص بالمغلّف الداخلي كمدخل • يصل `$x` إلى `projectedValue` الخاص بالمغلّف الخارجي فقط • يتيح `_x` الوصول مباشرةً إلى مثيل المغلّف • يُفضّل استخدام مغلّف واحد مركّب بدلًا من التكديس العميق متى أمكن اكتملت الدورة! التالي: نوع Result.