Author: | mdbassit |
---|---|
Views Total: | 569 views |
Official Page: | Go to website |
Last Update: | April 20, 2023 |
License: | MIT |
Preview:

Description:
Coloris.js is a vanilla JavaScript library for creating responsive, mobile-friendly, and fully accessible color pickers.
More Features:
- Allows you to pre-define color swatches.
- Dark and Light themes.
- Supports HEXa, HEX, RGBa, RGB color formats.
- Saturation and Brightness sliders.
How to use it:
1. Import the stylesheet coloris.min.css
and JavaScript coloris.min.js
into the HTML document.
<link rel="stylesheet" href="coloris.min.css" /> <script src="coloris.min.js"></script>
2. To initialize the color picker automatically, just add the data-coloris attribute to the target input field as follows:
<input type="text" data-coloris />
3. Or initialize the color picker in JavaScript.
<input type="text" class="coloris" />
Coloris({ el: '.coloris' });
4. Specify the initial color using the value
attribute:
<input type="text" class="coloris" value="rgb(255, 0, 0)" />
5. Change the theme: default, large, polaroid, pill (horizontal).
<input type="text" class="coloris" />
Coloris({ theme: 'large', themeMode: 'light', // light, dark, auto });
6. Define an array of predefined swatches to display.
Coloris({ swatches: [ '#264653', '#2a9d8f', '#e9c46a', '#f4a261', '#e76f51', '#d62828', '#023e8a', '#0077b6', '#0096c7', '#00b4d8', '#48cae4', ] });
7. Set the color format:
- hex
- rgb
- auto
- mixed (default)
Coloris({ format: 'hex', });
8. Call a function whenever a new color is picked
Coloris({ onChange: (color) => undefined });
9. More configurations.
Coloris({ // parent container parent: null, // The bound input fields are wrapped in a div that adds a thumbnail showing the current color // and a button to open the color picker (for accessibility only). wrap: true, // enable format toggle button formatToggle: true, // Margin in px margin: 2, // Show only the color swatches in the picker dialog swatchesOnly: false, // disable alpha alpha: true, // not focus the color value input focusInput: true, // select the color value input when the picker opens selectInput: false, // auto close autoClose: false, // set to true to use the color picker as an inline widget inline: false, // default colorin inline mode defaultColor: '#000000', // config the clear button clearButton: { show: false, label: 'Clear' }, // close button closeButton: false, closeLabel: 'Close', // a11y a11y: { open: 'Open color picker', close: 'Close color picker', clear: 'Clear the selected color', marker: 'Saturation: {s}. Brightness: {v}.', hueSlider: 'Hue slider', alphaSlider: 'Opacity slider', input: 'Color value field', format: 'Color format', swatch: 'Color swatch', instruction: 'Saturation and brightness selector. Use up, down, left and right arrow keys to select.' } });
10. API methods.
// Close the color picker Coloris.close(); // Close the color picker and reset the color Coloris.close(true);
11. Event handlers.
- open
- close
- input
- change
Changelog:
v0.19.0 (02/14/2022)
- Improve focus outline of the transparent close button
v0.18.0 (02/14/2022)
- Add a new onChange callback to the settings
v0.17.0 (01/15/2022)
- Always show focus rings when using keyboard navigation.
- Add an optional visible close button.
- Add a more accessible label to the clear button.
- Bugfixes
v0.16.2 (10/13/2022)
- Fix setting a color manually from text input in inline mode
v0.16.1 (09/20/2022)
- Fix an issue where the change event wasn’t triggered in some cases
v0.16.0 (08/11/2022)
- Add a new “pill” (horizontal) theme
- Do not position the picker above the input if there is not enough space
v0.15.0 (07/20/2022)
- Add support for (virtual) instances
v0.14.1 (07/10/2022)
- Remove unnecessary autoClose setting
v0.14.0 (06/04/2022)
- Added an option to select the color value input when the picker opens
v0.13.0 (06/01/2022)
- Add an option to always include the alpha value in the output color string
- Set the default color format when switching to inline mode
v0.12.2 (05/22/2022)
- Add type=”button” to all button elements to avoid submitting a container form
v0.12.1 (05/01/2022)
- Fix an issue with the calculation of the color area position in inline mode
v0.12.0 (04/26/2022)
- Add a new inline (static) mode
- Trigger an event when a new color is picked
v0.11.0 (04/24/2022)
- Add an “open” and “close” events.
v0.10.3 (04/06/2022)
- Fix a bug where the color swatches are not reset.
v0.10.2 (03/09/2022)
- Mitigate a Chromium bug where the alpha value is rounded incorrectly
v0.10.1 (03/04/2022)
- Add spellcheck=”false” to the color value field.
v0.10.0 (01/05/2021)
- Add an option to show only the color swatches in the picker dialog
v0.9.2 (01/03/2021)
- Fix issue where clear button was not clearing the selected color anymore
v0.9.1 (12/18/2021)
- Improved dark mode alpha gradient
v0.9.0 (12/14/2021)
- Add an option to not focus the color value input
v0.8.0 (11/13/2021)
- Add support for automatic dark mode
v0.7.0 (11/09/2021)
- Add a color format toggle to switch between Hex, RGB and HSL
- Add a new “auto” color format
- Add a new “large” theme
11/03/2021
- Add the ability to disable alpha
10/27/2021
- Fix swatches distribution for the polaroid theme
10/19/2021
- Add a clear button
10/16/2021
- Add an arrow to the polaroid theme that points to the active input field