Skip to main content

How to render images using SF Symbols

About 3 minSwiftSwiftUIArticle(s)bloghackingwithswift.comcrashcourseswiftswiftuixcodeappstore

How to render images using SF Symbols 관련

SwiftUI by Example

Back to Home

How to render images using SF Symbols | SwiftUI by Example

How to render images using SF Symbols

Updated for Xcode 15

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 projectopen in new window

A symbol showing the cresent moon and stars.
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 projectopen in new window

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

And it also means you can tint the image using the same foregroundStyle() modifier you've already seen:

Image(systemName: "cloud.heavyrain.fill")
    .font(.largeTitle)
    .foregroundStyle(.red)

Download this as an Xcode projectopen in new window

A red symbol showing a cloud dispensing heavy rain.
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 projectopen in new window

A black circle on top of which is a symbol which depicts a white cloud dispensing blue rain and partially obscuring a yellow sun.
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 foregroundStyle() 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)
    .foregroundStyle(.blue)
    .font(.largeTitle)

Download this as an Xcode projectopen in new window

A symbol showing a circular blue person symbol, overlaid with a circular green plus symbol.
A symbol showing a circular blue person symbol, overlaid with a circular green plus symbol.
Similar solutions…
How to get custom colors and transparency with SF Symbols | SwiftUI by Example

How to get custom colors and transparency with SF Symbols
How to animate SF Symbols | SwiftUI by Example

How to animate SF Symbols
How to render a SwiftUI view to a PDF | SwiftUI by Example

How to render a SwiftUI view to a PDF
How to render Markdown content in text | SwiftUI by Example

How to render Markdown content in text
How to render a gradient | SwiftUI by Example

How to render a gradient

이찬희 (MarkiiimarK)
Never Stop Learning.