ChromaColorPicker/README.md

2.4 KiB

ChromaColorPicker 2.0

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

Installation

Carthage

github "joncardasis/ChromaColorPicker"

Cocoapods

pod 'ChromaColorPicker'

Manually

Add all files from the Source folder to your project.

Usage

Multiple Handles

// Add handles
{TODO}

// Add a custom handle
{TODO}

// Remove handles
{TODO}

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

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.
Example

License

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