ChromaColorPicker/README.md

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

TODO: Image / GIF

Examples

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

// Optional: Add multiple handles to the color picker

// 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)`

Usage

Multiple Handles

// Add handles
{TODO}

// Add a custom handle
{TODO}

// Remove handles
{TODO}

Supported UIControlEvents

Installation

Carthage

github "joncardasis/ChromaColorPicker"

Cocoapods

pod 'ChromaColorPicker'

Manually

Add all files from the Source folder to your project.

Components

ChromaColorPicker

An HSB color picker with support for adding multiple color selection handles.

ChromaBrightnessSlider

ChromaBrightnessSlider is 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

You can observe on the following UIControlEvents via UIControl's addTarget method:

addTarget(self, action: #selector(sliderDidValueChange(_:)), for: .valueChanged)

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

ChromaColorPicker

Event	Description
.touchDown	Called when a handle is first grabbed.
.touchUpInside	Called when a handle is let go.
.valueChanged	Called whenever the color has changed.
.touchDragInside	Called when a handle has moved via a drag action.
.editingDidEnd	Called when either a handle is let go or slider is let go.

ChromaBrightnessSlider

Event	Description
.valueChanged	Called whenever the slider is moved and the value has changed.
.editingDidEnd	Called when the slider handle is released.

Example

License

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