0Pricing
Swift Academy · Lesson

Composing Multiple Property Wrappers

Stacking property wrappers and understanding their initialization order.

Composing Multiple Property Wrappers is a free Swift Academy lesson on CoddyKit — lesson 4 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Swift Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Welcome

Multiple property wrappers can be applied to a single property. The order matters — outer wrappers wrap inner ones — and initialization order follows declaration order.

Stacking Wrappers

```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 } ```

Outer Wraps Inner

When you write `@A @B var x`, the desugaring is: ```swift var _x: A> = A(wrappedValue: B(wrappedValue: 0)) ``` A wraps B which wraps Int.

Real Example: @NonEmpty + @Trimmed

```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 = " " } ```

Initialization Order

Wrappers are initialised from outermost to innermost. This means the outer wrapper's init receives the result of the inner wrapper's transformation — not the original value.

Limitations of Stacking

• Not all wrappers compose cleanly — check `wrappedValue` types match • Swift compiler may not always allow multiple wrappers (depends on wrapped type compatibility) • projectedValue access `$x` only reaches the outermost wrapper's projection

SwiftUI Example: @EnvironmentObject + Observation

SwiftUI doesn't allow stacking `@EnvironmentObject` and `@Published` on the same property, but you can observe `@EnvironmentObject` models that use `@Published` internally.

Debugging Stacked Wrappers

Use `_propertyName` to directly access the wrapper instance: ```swift print(form._username) // A> — the outer wrapper instance ```

Alternative: Compose Inside One Wrapper

Often it's cleaner to compose logic inside a single wrapper: ```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 } } ```

Practical Stacking Patterns

Common valid stacks: • `@UserDefault` + `@Published` (data persistence + observation) • `@NonNegative` + `@Clamped` (validation layers) • Framework-specific: `@Environment` + `@Binding` in SwiftUI views

Quick Check

When two property wrappers are stacked, which initialises first?

Recap

Key takeaways: • `@A @B var x` desugars to `A>` • Outer initialises with inner's wrappedValue as input • `$x` reaches outermost projectedValue only • `_x` accesses the wrapper instance directly • Prefer single composed wrapper over deep stacking when possible Course complete! Next: Result type.

Frequently asked questions

Is the “Composing Multiple Property Wrappers” lesson free?

Yes — the full text of “Composing Multiple Property Wrappers” is free to read here on the web, and the Swift Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Swift Academy course, upgrade to CoddyKit PRO.

What will I learn in “Composing Multiple Property Wrappers”?

Stacking property wrappers and understanding their initialization order. You practise Swift Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Swift Academy?

No prior experience is required. Swift Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 4 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Composing Multiple Property Wrappers” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Swift Academy lesson?

Yes. Every Swift Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. Creating a Custom Property Wrapper
  2. Projected Values with $binding
  3. @Published and Observation in Combine
  4. Composing Multiple Property Wrappers
← Back to Swift Academy