Creates an image object containing a system symbol image with the specified configuration.
- iOS 13.0+
- Mac Catalyst 13.0+
- tvOS 13.0+
- watchOS 6.0+
The name of the system symbol image. Use the SF Symbols app to look up the names of system symbol images. You can download this app from the design resources page at developer.apple.com.
The image configuration that you want. Use this parameter to specify traits and other details that define which variant of the image you want. For example, you can request a symbol image with a specified weight.
The object containing the image variant that matches the specified configuration data, or
nil if no suitable image was found.
Use this method only to retrieve system-defined symbol images. To retrieve a custom symbol image stored in your app's asset catalog, use the
init(named: method instead.
This method checks the system caches for an image with the specified name and returns the variant of that image that is best suited for the specified configuration. If a matching image object is not already in the cache, this method creates the image from the specified system symbol image. The system may purge cached image data at any time to free up memory. Purging occurs only for images that are in the cache but are not currently being used.