A Shortcuts-like and highly customizable SFSymbol picker written in Swift.

SFTintedIconPicker

SFTintedIconPicker is a Shortcuts-like and highly customizable SFSymbol picker written in Swift.

Features

Native Appearance
Search Symbols
Gradient Color Support
Native Color Picker (iOS 14+)

And so much more...

Installation

Using CocoaPods

Add pod 'SFTintedIconPicker' to your Podfile and run pod install. Also add use_frameworks! to the Podfile.

target 'MyApp'
pod 'SFTintedIconPicker'
use_frameworks!

Using Swift Package Manager

Open SPM dependency manager through File > Swift Pakcages > Add Package Dependency....

and insert repository URL:

https://github.com/iamStephenFang/SFTintedIconPicker.git

To add dependency in your own package, just specify a package in dependencies of your Package.swift:

.package(
name: "SFTintedIconPicker",
url: "https://github.com/iamStephenFang/SFTintedIconPicker.git",
.upToNextMajor(from: "1.0.0")
)

Note: This has a minimum target iOS version of 13.0.

Configuration

All the configuration endpoints are in the SFTintedIconPickerConfiguration struct.

var config = SFTintedIconPickerConfiguration()
// config.showSystemColorPicker = true
// config.isDebugLogsEnabled = true
// config.isColorSelectionEnabled = true
// Build a picker with your configuration
let picker = SFTintedIconPicker(configuration: config)

Colors

config.colors.pickerTintColor = UIColor.systemBlue
config.colors.pickerBackgroundColor = UIColor.systemGroupedBackground
config.colors.pickerTitleColor = UIColor.label

config.colors.iconAreaBackgroundColor = UIColor.systemBackground

config.colors.colorPickerAreaBackgroundColor = UIColor.systemBackground
config.colors.colorPickerSelectedBorderColor = UIColor.systemFill

config.colors.searchBarBackgroundColor = UIColor.clear
config.colors.searchBarPlaceholderTextColor = UIColor.placeholderText

config.colors.iconPickerCellTintedColor = UIColor.gray
config.colors.iconPickerCellSelectedBackgroundColor = UIColor.systemFill
config.colors.iconPickerAreaBackgroundColor = UIColor.systemBackground

Titles

Rewrite the key value of the strings in the Bundle.main localization file can override the translation provided.

config.titles.navigationTitle = localizedStringInSFTintedIconPicker("SFTintedIconPickerNavigationTitle")
config.titles.navigationFinishTitle = localizedStringInSFTintedIconPicker("SFTintedIconPickerDone")
config.titles.searchBarPlaceHolder = localizedStringInSFTintedIconPicker("SFTintedIconPickerSearchBarPlaceHolder")

Provided Colors

Both solid color and gradient colours are supported.

config.demoIconConfig = [SFTintedColor(backgroundColor: .red),
                        SFTintedColor(backgroundColor: .orange),
                        SFTintedColor(backgroundColor: .yellow),
                        SFTintedColor(backgroundColor: .green),
                        SFTintedColor(backgroundColor: .cyan),
                        SFTintedColor(backgroundColor: .blue),
                        SFTintedColor(backgroundGradientColors: [.black, .purple])]

Component Configuration

config.demoIconConfig.topMargin = CGFloat(16)
config.demoIconConfig.horizontalMargin = CGFloat(16)
config.demoIconConfig.verticalPadding = CGFloat(17)
config.demoIconConfig.iconSize = CGFloat(61)
config.demoIconConfig.cornerRadius = CGFloat(10)

config.colorPickerConfig.topMargin = CGFloat(16)
config.colorPickerConfig.horizontalMargin = CGFloat(16)
config.colorPickerConfig.verticalPadding = CGFloat(16)
config.colorPickerConfig.horizontalPadding = CGFloat(16)
config.colorPickerConfig.lineSpacing = CGFloat(7)
config.colorPickerConfig.interitemSpacing = CGFloat(2)
config.colorPickerConfig.numberOfItemsInRow = Int(6)
config.colorPickerConfig.selectedBorderWidth = CGFloat(2)
config.colorPickerConfig.innerColorSizeRatio = CGFloat(0.7)
config.colorPickerConfig.cornerRadius = CGFloat(10)

config.iconPickerConfig.topMargin = CGFloat(16)
config.iconPickerConfig.bottomMargin = CGFloat(16)
config.iconPickerConfig.horizontalMargin = CGFloat(16)
config.iconPickerConfig.cornerRadius = CGFloat(10)
config.iconPickerConfig.searchBarTopPadding = CGFloat(14)
config.iconPickerConfig.searchBarHorizontalPadding = CGFloat(12)
config.iconPickerConfig.searchBarHeight = CGFloat(33)
config.iconPickerConfig.topPadding = CGFloat(20)
config.iconPickerConfig.bottomPadding = CGFloat(20)
config.iconPickerConfig.horizontalPadding = CGFloat(14)
config.iconPickerConfig.lineSpacing = CGFloat(22)
config.iconPickerConfig.interitemSpacing = CGFloat(15)
config.iconPickerConfig.numberOfItemsInRow = Int(6)
config.iconPickerConfig.cellCornerRadius = CGFloat(7)

Usage

import SFTintedIconPicker.
Set up didFinishPicking callback to handle the SFTintedItem struct.
Present the picker

UIImageView with UIColor & SFSymbols

let config = SFTintedIconPickerConfiguration()
let picker = SFTintedIconPicker(configuration:config)
picker.didFinishPicking { [self, unowned picker] item, cancelled in
    if cancelled {
        picker.dismiss(animated: true, completion: nil)
        return
    }

    if let item = item {
        self.imageView.backgroundColor = item.itemColor.backgroundColor
        self.imageView.image = UIImage(systemName: item.itemSymbol, withConfiguration: UIImage.SymbolConfiguration(pointSize: 20))
        picker.dismiss(animated: true, completion: nil)
    }
}
present(picker, animated: true, completion: nil)

SFTintedIcon with SFTintedItem

var currentItem = SFTintedItem()

var config = SFTintedIconPickerConfiguration()
config.selectedItem = currentItem

let picker = SFTintedIconPicker(configuration:config)
picker.didFinishPicking { [self, unowned picker] item, cancelled in
    if cancelled {
        picker.dismiss(animated: true, completion: nil)
        return
    }

    if let item = item {
        self.currentItem = item
        self.iconView.refreshWithItem(item)
        picker.dismiss(animated: true, completion: nil)
    }
}
present(picker, animated: true, completion: nil)

Roadmap

SF Symbols Categories
SF Symbols Localization
Objective-C Support
Cross-platform

License

SFTintedIconPicker is released under the MIT license.
See LICENSE for details.

A very useful and unique iOS library to open image picker in just few lines of code.

ImagePickerEasy A very simple solution to implement UIImagePickerController() in your application. Requirements Swift 4.2 and above Installation Image

6 May 13, 2022

FLImagePicker - A simple image picker supported multiple selection

FLImagePicker A simple image picker supported multiple selection. Features Multiple selection Gesture supported Dark mode Easy modification Installati

4 Aug 17, 2022

Cordova plugin to display a native color-picker dialog

Color Picker Plugin for Cordova (cordova-plugin-color-picker) Description This plugin allows you to display a color-picker native dialog in iOS and An

1 May 10, 2022

WLPhotoPicker - A multifunction photo picker for iOS

WLPhotoPicker Example To run the example project, clone the repo, and run pod in

20 Nov 25, 2022

A simple and customizable activity indicator.

日本語 KRActivityIndicatorView KRActivityIndicatorView is a simple and customizable activity indicator written in Swift. You can add KRActivityIndicatorV

47 Jul 11, 2022

DTPhotoViewerController - A fully customizable photo viewer ViewController to display single photo or collection of photos, inspired by Facebook photo viewer.

DTPhotoViewerController Example Demo video: https://youtu.be/aTLx4M4zsKk DTPhotoViewerController is very simple to use, if you want to display only on