Swift Academy · Lesson

Composing Multiple Property Wrappers

Stacking property wrappers and understanding their initialization order.

Lesson 4 of 412 steps

Composing Multiple Property Wrappers is a free Swift Academy lesson on CoddyKit. This is lesson 4 of 4. Any 3 lessons of this learning path are free to read in full — after that, CoddyKit PRO unlocks every lesson, plus hands-on practice with a built-in code editor and a 24/7 AI tutor. It is part of the Swift Academy learning path, and your progress syncs across the web and the CoddyKit app. The Swift Academy course includes 4 lessons in total.

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.
Free to start

Learn Swift with an AI tutor — free

Write and run real code in your browser, get instant help from a 24/7 AI tutor, and pick up where you left off on the web or in the app.

Courses
122
Lessons
409

Frequently Asked Questions

Is the “Composing Multiple Property Wrappers” lesson free?

Yes — any 3 lessons of the Swift Academy learning path, including “Composing Multiple Property Wrappers”, are free to read in full here on the web. After that, CoddyKit PRO unlocks every lesson, plus interactive practice with a built-in code editor and a 24/7 AI tutor. The Swift Academy course includes 4 lessons in total.

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, so you can start here or from the beginning and move at your own pace. This is lesson 4 of 4.

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