Swift Package Manager is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.
Xcode 11+ is required to build SnapKit using Swift Package Manager.
To integrate TNGradientPickerSlider into your Xcode project using Swift Package Manager, add it to the dependencies value of your Package.swift:
If you prefer not to use SPM, you can integrate TNGradientPickerSlider into your project manually.
Usage
Quick Start
It’s really simple to use TNGradientPickerSlider, just follow these 4 steps and you’re good to go!
Add import TNGradientPickerSlider at the top of your file
Create an array of TNGradientColor, which hold the initial colors that you want to show on the track
Create an instance of TNGradientPickerSliderViewController and add it as a child viewcontroller.
Add it to the view hierarchy and setup your AutoLayout constraints.
Register some object as the delegate of TNGradientPickerSliderViewController. This class will receive the information needed whenever the array of gradient colors changes, so you can update your own UI.
import TNGradientPickerSlider
override func viewDidLoad() {
super.viewDidLoad()
// 1. Create an array which hold the initial colors you want to show on the track
let initialGradientColors = [
TNGradientColor(location: 0.0, color: NSColor.red),
TNGradientColor(location: 1.0, color: NSColor.blue)
]
// 2. Create the view controller
let gradientSliderViewController = TNGradientPickerSliderViewController(configuration: TNGradientPickerSliderConfiguration.standard(), gradientColors: initialGradientColors)
// 3. Add it as a child view controller of the current view controller
addChild(gradientSliderViewController)
// 4. Add it to the view hierarchy + setup the constraints
view.addSubview(gradientSliderViewController.view)
gradientSliderViewController.view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
gradientSliderViewController.view.widthAnchor.constraint(equalToConstant: 200),
gradientSliderViewController.view.heightAnchor.constraint(equalToConstant: 28),
gradientSliderViewController.view.centerXAnchor.constraint(equalTo: view.centerXAnchor),
gradientSliderViewController.view.centerYAnchor.constraint(equalTo: view.centerYAnchor),
])
// 5. Register some object to be the delegate which will receive information when the colors array has changed.
gradientSliderViewController.delegate = self
}
Implement the delegate method, so you can update your own UI with the picked colors.
When you create an instance of TNGradientPickerSliderViewController you can pass in a TNGradientPickerSliderConfiguration.
The TNGradientPickerSliderConfiguration struct has a static method standard(), which will give you the style as seen in the Demo Video.
You can alter the look of the track and the color handles.
Track
The track is the visual part where you add color handles.
To create a different configuration, create an instance of TNGradientPickerSliderConfiguration.Track and fill in the necessary properties.
Available properties:
height
borderColor
borderWidth
Color Handle
The Color Handle is view that holds the color information which you add to the track.
To create a different configuration, create an instance of TNGradientPickerSliderConfiguration.ColorHandle and fill in the necessary properties.
TNGradientPickerSlider is a ready-to-use AppKit component that let your users select multiple colors to build a gradient for your macOS application.
✨ Features
Demo video
Contents
Requirements
Communication
Installation
Swift Package Manager
Swift Package Manager is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.
To integrate TNGradientPickerSlider into your Xcode project using Swift Package Manager, add it to the dependencies value of your
Package.swift:Manually
If you prefer not to use SPM, you can integrate TNGradientPickerSlider into your project manually.
Usage
Quick Start
It’s really simple to use TNGradientPickerSlider, just follow these 4 steps and you’re good to go!
import TNGradientPickerSliderat the top of your fileTNGradientColor, which hold the initial colors that you want to show on the trackTNGradientPickerSliderViewControllerand add it as a child viewcontroller.delegateof TNGradientPickerSliderViewController. This class will receive the information needed whenever the array of gradient colors changes, so you can update your own UI.Implement the delegate method, so you can update your own UI with the picked colors.
That’s it!
Configuration
When you create an instance of
TNGradientPickerSliderViewControlleryou can pass in aTNGradientPickerSliderConfiguration.The
TNGradientPickerSliderConfigurationstruct has a static methodstandard(), which will give you the style as seen in the Demo Video. You can alter the look of thetrackand thecolor handles.Track
The track is the visual part where you add color handles.
To create a different configuration, create an instance of
TNGradientPickerSliderConfiguration.Trackand fill in the necessary properties.Available properties:
Color Handle
The Color Handle is view that holds the color information which you add to the track.
To create a different configuration, create an instance of
TNGradientPickerSliderConfiguration.ColorHandleand fill in the necessary properties.Available properties:
Credits
License
TNGradientPickerSlider is released under the MIT license. See LICENSE for details.