NEW: Got a question? Get help on our new forums! >>

Understanding property wrappers in Swift and SwiftUI

Paul Hudson    @twostraws   

Fully updated for Xcode 11.4

SwiftUI relies heavily on property wrappers to make our code easier to read, write, and maintain, but if you’ve never used them before you’d be forgiven for wondering where all the @ and $ signs have come from – they can seem alien at first.

Although property wrappers are a general Swift feature since they were introduced in Swift 5.1, they are particularly common in SwiftUI – you’ll see @Published, @ObservedObject, @EnvironmentObject and many more, all with the purpose of helping reduce the amount of boilerplate in our code.

We’ll be going into detail on each one of SwiftUI’s property wrappers in the next few chapters, but just briefly it’s worth summarizing the basics:

  • Some property wrappers allow us to achieve effects that would otherwise not be possible, such as the way @State lets us modify properties inside a struct.
  • Some property wrappers specifically require you to have done extra work elsewhere, and may crash your app if that work isn’t done. For example, @FetchRequest expects you to have placed a Core Data managed object context into the environment ahead of time.
  • You may apply only one property wrapper at a time, which means @ObservedObject @Binding var value = SomeClass() is not allowed.
  • Even though some property wrappers look similar (looking at you, @Environment and @EnvironmentObject!) they are all different and it’s important you use them appropriately.
  • You can create your own property wrappers if you want, but this isn’t required to use SwiftUI.

That covers the basics, but to really understand how these property wrappers work it’s worth investigating them individually.

Hacking with Swift is sponsored by Instabug

SPONSORED Catch bugs as soon as they happen and know exactly why a crash occurred by integrating Instabug's SDK in one minute. You will automatically receive device data, network logs, and reproduction steps with every bug and crash report.

Learn more and get started for free

Sponsor Hacking with Swift and reach the world's largest Swift community!

Listen to the Swift over Coffee podcast

Similar solutions…

Buy Pro Swift Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift (Vapor Edition) Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Server-Side Swift (Kitura Edition) Buy Beyond Code

Was this page useful? Let us know!

Average rating: 1.0/5