All Projects → iGenius-Srl → Igcolorpicker

iGenius-Srl / Igcolorpicker

Licence: mit
A customizable color picker for iOS in Swift

Programming Languages

swift
15916 projects
crystal
512 projects

Projects that are alternatives of or similar to Igcolorpicker

Alderis
iOS color picker library
Stars: ✭ 128 (-46.67%)
Mutual labels:  color-picker
React Native Color
Color components for React Native 🌈
Stars: ✭ 178 (-25.83%)
Mutual labels:  color-picker
React Input Color
React color picker
Stars: ✭ 208 (-13.33%)
Mutual labels:  color-picker
Orc.controls
Timespan, DateTime and various other controls
Stars: ✭ 140 (-41.67%)
Mutual labels:  color-picker
Flexcolorpicker
Modern color picker library written in Swift 5 that can be easily extended and customized. It aims to provide great UX and performance with stable, quality code.
Stars: ✭ 164 (-31.67%)
Mutual labels:  color-picker
React Colorpickr
A themeable colorpicker with HSL and RGB support for React
Stars: ✭ 180 (-25%)
Mutual labels:  color-picker
Verte
🎨 A Color picker component. Built from the bottom to work with Vue.js.
Stars: ✭ 117 (-51.25%)
Mutual labels:  color-picker
React Native Color Picker
Color picker component for IOS/Android
Stars: ✭ 221 (-7.92%)
Mutual labels:  color-picker
Angular Color Picker
Vanilla AngularJS Color Picker Directive with no requirement on jQuery
Stars: ✭ 173 (-27.92%)
Mutual labels:  color-picker
Huekit
A UI framework for iOS that provides components and utilities for building color pickers.
Stars: ✭ 198 (-17.5%)
Mutual labels:  color-picker
Pikolo
An android color picker library
Stars: ✭ 142 (-40.83%)
Mutual labels:  color-picker
Mscolorpicker
Color picker component for iOS
Stars: ✭ 162 (-32.5%)
Mutual labels:  color-picker
Jscolor
JavaScript color picker with opacity (alpha channel) and customizable palette. Single file of plain JS with no dependencies.
Stars: ✭ 182 (-24.17%)
Mutual labels:  color-picker
React Native Color Wheel
🌈 A react native reusable and color picker wheel
Stars: ✭ 137 (-42.92%)
Mutual labels:  color-picker
Xcolor
Lightweight color picker for X11
Stars: ✭ 209 (-12.92%)
Mutual labels:  color-picker
Colordrop
Interactive Drag & Drop Coloring with Material Design Color palette
Stars: ✭ 120 (-50%)
Mutual labels:  color-picker
Colorsheet
A color picker bottom sheet 🌈
Stars: ✭ 179 (-25.42%)
Mutual labels:  color-picker
Handycontrol
Contains some simple and commonly used WPF controls
Stars: ✭ 3,349 (+1295.42%)
Mutual labels:  color-picker
Androidphotoshopcolorpicker
A fully featured Color picker Library for Android
Stars: ✭ 220 (-8.33%)
Mutual labels:  color-picker
Flutter colorpicker
A HSV(HSB)/HSL color picker inspired by chrome devtools and a material color picker for your flutter app.
Stars: ✭ 185 (-22.92%)
Mutual labels:  color-picker

alt text

Language: Swift 5 License: MIT Platform: iOS

IGColorPicker is a fantastic color picker 🎨 written in Swift.

alt text

Table of Contents

Documentation

Colors

The color picker comes with our set of colors:

alt text

But if you don't like them, you are free to use your own colors 🖍:

colorPickerView.colors = [UIColor.red, UIColor.yellow, UIColor.green, UIColor.black]

Style

  • style enum: look and feel of color picker cells

    • circle

      alt text

    • square

      alt text

  • selectionStyle enum: style applied when a color is selected

    • check

      alt text

    • none

      alt text

Other features

  • preselectedIndex Int?: the index of the preselected color in the color picker

  • isSelectedColorTappable Bool: if true, the selected color can be deselected by a tap

  • scrollToPreselectedIndex Bool: if true, the preselectedIndex is showed in the center of the color picker

Installation

IGColorPicker is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'IGColorPicker'

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Getting Started

ColorPickerView

ColorPickerView is just a class that inheritance from UIView, so you can both use a storyboard or you can create the color picker programmatically:

Storyboard

  • Add a UIView to the storyboard. Go to the Identity inspector and in set its class to ColorPickerView.
  • Just drag and drop the view in the correct class 🤙🏻

Programmatically

Just initialize the color picker like one would initialize a UIView, and add it as a subview to your view hierarchy.

import IGColorPicker

class ViewController {
  var colorPickerView: ColorPickerView!

  override func viewDidLoad() {
    super.viewDidLoad()

    colorPickerView = ColorPickerView(frame: CGRect(x: 0.0, y: 0.0, width: widthSize, height: heightSize))
    view.addSubview(colorPickerView)
  }

}

Delegate

ColorPickerViewDelegate is the delegate protocol that recognizes the tap gesture on a color. This is an option delegate, but if you need to know when the user selects a color you should implement it.

// Set the delegate 🙋🏻‍♂️
colorPickerView.delegate = self

// MARK: - ColorPickerViewDelegate
extension ViewController: ColorPickerViewDelegate {

  func colorPickerView(_ colorPickerView: ColorPickerView, didSelectItemAt indexPath: IndexPath) {
    // A color has been selected
  }

  // This is an optional method
  func colorPickerView(_ colorPickerView: ColorPickerView, didDeselectItemAt indexPath: IndexPath) {
    // A color has been deselected
  }

}

Layout

Every developer can customize the color picker layout in the way to fit with their design. To do that you have to implement our layout delegate ColorPickerViewDelegateFlowLayout

// Set the delegate 🙋🏻‍♂️
colorPickerView.layoutDelegate = self

// MARK: - ColorPickerViewDelegateFlowLayout
extension ViewController: ColorPickerViewDelegateFlowLayout {

  // ------------------------------------------------------------------
  // All these methods are optionals, your are not to implement them 🖖🏻
  // ------------------------------------------------------------------

  func colorPickerView(_ colorPickerView: ColorPickerView, sizeForItemAt indexPath: IndexPath) -> CGSize {
    // The size for each cell
    // 👉🏻 WIDTH AND HEIGHT MUST BE EQUALS!
  }

  func colorPickerView(_ colorPickerView: ColorPickerView, minimumLineSpacingForSectionAt section: Int) -> CGFloat {
    // Space between cells
  }

  func colorPickerView(_ colorPickerView: ColorPickerView, minimumInteritemSpacingForSectionAt section: Int) -> CGFloat {
    // Space between rows
  }

  func colorPickerView(_ colorPickerView: ColorPickerView, insetForSectionAt section: Int) -> UIEdgeInsets {
    // Inset used aroud the view
  }

}

Project Details

Requirements

  • Swift 4.1
  • Xcode 9.0+
  • iOS 8.3+

Contributing

Feel free to collaborate with ideas 💭 , issues ⁉️ and/or pull requests 🔃.

Here is a list of ToDo about bug fix and new features you can work on:

  • Custom check size
  • Support to custom view in ColorPickerViewSelectStyle
  • Support custom style in ColorPickerViewStyle
  • Substitute M13Checkbox with another framework. Or just create a custom checkbox with animation

P.S. If you use IGColorPicker in your app we would love to hear about it! 😉

License

Copyright (c) 2018 iGenius Srl

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].