How to render images using SF Symbols
Updated for Xcode 14.2
SwiftUI’s Image view lets us load any of the 2400+ icons from SF Symbols, with many of them working in multi-color too.
To load icons from Apple’s SF Symbols set, use the Image(systemName:) initializer, passing in the icon string to load, like this:
Image(systemName: "moon.stars.fill")
Download this as an Xcode project
The image you get back is scalable and colorable, which means you can ask SwiftUI to scale up the image to match whatever Dynamic Type text style it accompanies, if any:
Image(systemName: "wind.snow")
.font(.largeTitle) Download this as an Xcode project
And it also means you can tint the image using the same foregroundColor() modifier you’ve already seen:
Image(systemName: "cloud.heavyrain.fill")
.font(.largeTitle)
.foregroundColor(.red) Download this as an Xcode project
If you’re using an image that has color elements, you can activate multi-color mode using .renderingMode(.original), like this:
Image(systemName: "cloud.sun.rain.fill")
.renderingMode(.original)
.font(.largeTitle)
.padding()
.background(.black)
.clipShape(Circle()) Download this as an Xcode project
You can optionally apply a foregroundColor() modifier to a multi-color SF Symbol, which will cause part of the symbol to be recolored. For example, this will render part of the icon blue and part green:
Image(systemName: "person.crop.circle.fill.badge.plus")
.renderingMode(.original)
.foregroundColor(.blue)
.font(.largeTitle) Download this as an Xcode project
SAVE 50% To celebrate WWDC23, all our books and bundles are half price, so you can take your Swift knowledge further without spending big! Get the Swift Power Pack to build your iOS career faster, get the Swift Platform Pack to builds apps for macOS, watchOS, and beyond, or get the Swift Plus Pack to learn advanced design patterns, testing skills, and more.
Similar solutions…
- How to get custom colors and transparency with SF Symbols
- How to render a SwiftUI view to a PDF
- How to draw images using Image views
- How to render Markdown content in text
- How to render a gradient
