NEW: My new book Pro SwiftUI is out now – level up your SwiftUI skills today! >>

How to render images using SF Symbols

Paul Hudson    @twostraws   

Updated for Xcode 14.0 beta 1

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

A symbol showing the cresent moon and stars.

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

A large symbol showing a gust of wind blowing snowflakes along.

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

A red symbol showing a cloud dispensing heavy rain.

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

A black circle on top of which is a symbol which depicts a white cloud dispensing blue rain and partially obscuring a yellow sun.

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

A symbol showing a circular blue person symbol, overlaid with a circular green plus symbol.

Hacking with Swift is sponsored by Stream

SPONSORED Build Chat messaging quickly with Stream Chat. The Stream iOS Chat SDK is highly flexible, customizable, and crazy optimized for performance. Take advantage of this top-notch developer experience, get started for free today!

Click here

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

Similar solutions…

BUY OUR BOOKS
Buy Pro Swift Buy Pro SwiftUI 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 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 Beyond Code

Was this page useful? Let us know!

Average rating: 4.5/5

 
Unknown user

You are not logged in

Log in or create account
 

Link copied to your pasteboard.