fillinx-solutions-color-picker
v0.0.3
Published
React gradient color picker
Downloads
50
Maintainers
Readme
React gradient color picker
Inspired by gpickr
Install
Important: this component uses React Hooks and works on React version 16.8.0 and higher
npm install --save react-gcolor-picker
OR
yarn add react-gcolor-picker
Usage
import React from 'react';
import ReactGPicker from 'react-gcolor-picker';
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 © undind