Logo

0x5a.live

for different kinds of informations and explorations.

GitHub - joncardasis/ChromaColorPicker: :art: An intuitive iOS color picker built in Swift.

:art: An intuitive iOS color picker built in Swift. - joncardasis/ChromaColorPicker

Visit SiteGitHub - joncardasis/ChromaColorPicker: :art: An intuitive iOS color picker built in Swift.

GitHub - joncardasis/ChromaColorPicker: :art: An intuitive iOS color picker built in Swift.

:art: An intuitive iOS color picker built in Swift. - joncardasis/ChromaColorPicker

Powered by 0x5a.live 💗

An intuitive HSB color picker built in Swift. Supports multiple selection handles and is customizable to your needs.

Examples

let colorPicker = ChromaColorPicker(frame: CGRect(x: 0, y: 0, width: 300, height: 300))
addSubview(colorPicker)

// Optional: Attach a ChromaBrightnessSlider to a ChromaColorPicker
let brightnessSlider = ChromaBrightnessSlider(frame: CGRect(x: 0, y: 0, width: 280, height: 32))
addSubview(brightnessSlider)

colorPicker.connect(brightnessSlider) // or `brightnessSlider.connect(to: colorPicker)`
  • View the Example app for more.

Usage

Multiple Handles

// Add handle at color
let peachColor = UIColor(red: 1, green: 203 / 255, blue: 164 / 255, alpha: 1)
colorPicker.addHandle(at: peachColor)

// Add handle with reference
let customHandle = ChromaColorHandle()
customHandle.color = UIColor.purple
colorPicker.addHandle(customHandle)

// Add handle and keep reference
let handle = colorPicker.addHandle(at: .blue)

Custom Handle Icon

let homeHandle = ChomaColorHandle(color: .blue)
let imageView = UIImageView(image: #imageLiteral(resourceName: "home-icon").withRenderingMode(.alwaysTemplate))
imageView.contentMode = .scaleAspectFit
imageView.tintColor = .white
homeHandle.accessoryView = imageView
homeHandle.accessoryViewEdgeInsets = UIEdgeInsets(top: 2, left: 4, bottom: 4, right: 4)

colorPicker.addHandle(homeHandle)

Installation

Carthage

github "joncardasis/ChromaColorPicker"

Cocoapods

pod 'ChromaColorPicker'

Manually

Add all files from the Source folder to your project.

Components

Component Description
ChromaColorPicker An HSB color picker with support for adding multiple color selection handles.
ChromaBrightnessSlider A slider UIControl which can be attached to any ChromaColorPicker via the connect(to:) method. ChromaBrightnessSlider can also function as a stand-alone UIControl.

Supported UIControlEvents

Both ChromaBrightnessSlider and ChromaColorPicker conform to UIControl. Each send UIControlEvents which can be observed via via UIControl's addTarget method.

ChromaColorPicker

Event Description
.valueChanged Called whenever the color has changed.
.touchUpInside Called when a handle is released.

ChromaBrightnessSlider

Event Description
.touchDown Called when a the slider is grabbed.
.valueChanged Called whenever the slider is moved and the value has changed.
.touchUpInside Called when the slider handle is released.
// Example
brightnessSlider.addTarget(self, action: #selector(sliderDidValueChange(_:)), for: .valueChanged)

@objc func sliderDidValueChange(_ slider: ChromaBrightnessSlider) {
  print("new color: \(slider.currentColor)")
}

License

ChromaColorPicker is available under the MIT license. See the LICENSE file for more info.

Swift Resources

are all listed below.

Resources

listed to get explored on!!

Made with ❤️

to provide different kinds of informations and resources.