margolisj/react-gcolor-picker

Simple color(hex, rgb/a and hsla) and gradient(linear and radial) picker for react apps

React gradient color picker

This is being published publicly to make my life a little eaiser using the previous version than linking my fixed/updated via github.

USE AT YOUR OWN RISK. SUBJECT TO CHANGES AT MY WHIM.

Inspired by gpickr

Inspired by react-gcolor-picker

Demo

Install

Important: this component uses React Hooks and works on React version 16.8.0 and higher

---

npm install --save react-gcolor-picker-2

OR

yarn add react-gcolor-picker-2

Usage

import React from 'react';

import ReactGPicker from 'react-gcolor-picker-2';

function App() {
  const onChange = (value) => {
    console.log(value);
  };

  return <ReactGPicker value='red' onChange={onChange} />;
}

export default App;

Props

Attribute	Type	Default	Description
value	string	#ffffff	Default color value. Accept: rgba/rgb, hsla/hsl, named colors
format	string	rgb	Return value format. Accept: 'rgb', 'hex', 'hsl'
gradient	bool	false	Show gradient color panel
solid	bool	true	Show solid color panel
debounceMS	number	300	Debounce ms value
debounce	bool	true	Debouce off/on
showAlpha	bool	true	Show/hide alpha input and range
showInputs	bool	true	Show/hide inputs alpha and color
showGradientResult	bool	true	Show/hide gradient result fields(angle, mode, position)
showGradientStops	bool	true	Show/hide gradient color stops
showGradientMode	bool	true	Show/hide gradient color mode switcher
showGradientAngle	bool	true	Show/hide gradient angle for linear-gradient
showGradientPosition	bool	true	Show/hide gradient position for radial-gradient
popupWidth	number	267	Popup width
colorBoardHeight	number	120	Board color height
defaultColors	array	List	Default colors array for panel picker
defaultActiveTab	string	undefined	Default value for active tab when initializing the component, takes two values: solid or gradient
onChangeTabs	function	null	Default onChange function detect when tabs change and return one of the values: solid or gradient
onChange	function	null	Default onChange function returns string value in the given format

When passing a value for a gradient, you must specify the position of all colors. Otherwise the component will throw an exception. For example:

Wrong

linear-gradient(180deg, #000000,#ff0000)

Correct

linear-gradient(180deg, #000000 0%,#ff0000 100%)

If you are using a radial gradient a list of possible directions for it:

circle at left top
circle at center top
circle at right top
circle at left
circle at center
circle at right
circle at left bottom
circle at center bottom
circle at right bottom

Default color list

'#FF6900',
'#FCB900',
'#7BDCB5',
'#00D084',
'#8ED1FC',
'#0693E3',
'#ABB8C3',
'#607d8b',
'#EB144C',
'#F78DA7',
'#ba68c8',
'#9900EF',
'linear-gradient(0deg, rgb(255, 177, 153) 0%, rgb(255, 8, 68) 100%)',
'linear-gradient(270deg, rgb(251, 171, 126) 8.00%, rgb(247, 206, 104) 92.00%)',
'linear-gradient(315deg, rgb(150, 230, 161) 8.00%, rgb(212, 252, 121) 92.00%)',
'linear-gradient(to left, rgb(249, 240, 71) 0%, rgb(15, 216, 80) 100%)',
'linear-gradient(315deg, rgb(194, 233, 251) 8.00%, rgb(161, 196, 253) 92.00%)',
'linear-gradient(0deg, rgb(0, 198, 251) 0%, rgb(0, 91, 234) 100%)',
'linear-gradient(0deg, rgb(167, 166, 203) 0%, rgb(137, 137, 186) 51.00%, rgb(137, 137, 186) 100%)',
'linear-gradient(0deg, rgb(80, 82, 133) 0%, rgb(88, 94, 146) 15.0%, rgb(101, 104, 159) 28.00%, rgb(116, 116, 176) 43.00%, rgb(126, 126, 187) 57.00%, rgb(131, 137, 199) 71.00%, rgb(151, 149, 212) 82.00%, rgb(162, 161, 220) 92.00%, rgb(181, 174, 228) 100%)',
'linear-gradient(270deg, rgb(255, 126, 179) 0%, rgb(255, 117, 140) 100%)',
'linear-gradient(90deg, rgb(120, 115, 245) 0%, rgb(236, 119, 171) 100%)',
'linear-gradient(45deg, #2e266f 0.00%, #9664dd38 100.00%)',
'radial-gradient(circle at center, yellow 0%, #009966 50%, purple 100%)'

FAQ

Q: There's any possibility to remove extra gradient lines?

A: Yes, you only need to drag them outside(bottom) the Gradient component area or double click on the element you want to remove.

License

MIT ©