Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/instea/react-native-color-picker

Color picker component for IOS/Android
https://github.com/instea/react-native-color-picker

android color-picker ios react-native

Last synced: 5 days ago
JSON representation

Color picker component for IOS/Android

Awesome Lists containing this project

README

        

# react-native-color-picker

React Native implementation of color picker for both Android and iOS.

![android preview](doc/preview_android.png)
![iphone preview](doc/preview_iphone.png)

* [x] works both in controlled and uncontrolled way
* [x] old color can be displayed for visual comparison
* [x] holo and triangle color pickers

## Getting started
Install the color picker

```
npm install react-native-color-picker --save
```

And use it in your application

```javascript
import { ColorPicker } from 'react-native-color-picker'

const Picker = () => (
alert(`Color selected: ${color}`)}
style={{flex: 1}}
/>
)
```

Color picker will use space you provide. Therefore it is necessary to provide styles that will determine picker's size.

For HoloPicker (`ColorPicker`) you might need to install `@react-native-community/slider` and pass it (or any other Slider compatible component) as `sliderComponent` prop if you don't want to use deprecated RN `Slider`.

## API

### Color picker type

We provide two types of color picker - holo (default) and triangle color picker. Both has the same API so that they are interchangable. Just import it and use it the same way:

```javascript
import { ColorPicker, TriangleColorPicker } from 'react-native-color-picker'
```

| ColorPicker | TriangleColorPicker |
| ----------- | ------------------- |
| ![](doc/holo.png) | ![](doc/triangle.png) |

### Props

Color pickers accepts properties below. Each property which define color is represented as a [color string](https://github.com/bgrins/TinyColor#accepted-string-input).

Both color pickers are [PureComponents](https://facebook.github.io/react/docs/react-api.html#react.purecomponent) thus if you want to update it you should not mutate its properties deeply.

| Property | Type | Note |
|--------------------|------------|--------|
|`color` |`String\|HSV`|[Color string](https://github.com/bgrins/TinyColor#accepted-string-input) or HSV object (see below). Defines selected color in controlled component. |
|`defaultColor` |`String` |Defines initial selected color in uncontrolled component.|
|`oldColor` |`String` |Old color to be used for visual comparision. If it is not defined, whole circle is representing selected color.|
|`style` |`Style` |Styles passed to color picker container|
|`onColorSelected` |`Function` |Callback with color (HEX string) as argument called when user confirms color selection.|
|`onColorChange` |`Function` |Callback called each time when color is changed. Used in controlled component. Argument is color in HSV representation (see below)|
|`onOldColorSelected`|`Function` |Callback with color (HEX string) as argument called when user selects old color.|
|`hideSliders` |`Boolean` |Option to hide bottom sliders (holo picker only) |
|`hideControls` |`Boolean` |Option to hide bottom buttons (triangle picker only) |

When using color picker as a controlled component you should always use HSV color representation to avoid conversion from/to HEX or RGB. HSV color representation is an object literal with properties:

```javascript
{
h: number, // <0, 360>
s: number, // <0, 1>
v: number, // <0, 1>
}

```

### Helper functions

To utilize HSV -> HEX/RGB conversion we provide helper functions:

```javascript
import { toHsv, fromHsv } from 'react-native-color-picker'

toHsv('blue') // { h: 24, s: 1, v: 1 }

fromHsv({ h: 200, s: 0.4, v:0.4 }) // #3d5866

```

## Examples

See our examples on [Expo](https://snack.expo.io/@sodik82/react-native-color-picker-example)

## Limitations
* Does not work well within `ScrollView` due to touch event interference.
* RN has deprecated `Slider` component. You need to provide Slider component as prop to overcome this.
* There is known [bug](https://github.com/instea/react-native-color-picker/issues/17) affecting RN 0.61. See more info about the workaround.

## Thanks
Our implementation was inspired by [Android Holo ColorPicker](https://github.com/LarsWerkman/HoloColorPicker)