Cordelia NPM | npm.io

Cordelia

Cordelia is a JavaScript library that allows you to add a rich color picker into your web pages. See the documentation and demo for more information: https://cevadtokatli.github.io/cordelia

NPM

npm install --save-dev cordelia

Yarn

yarn add cordelia

Installation

You can simply import Cordelia and create a new object with it.

import Cordelia from 'cordelia'

const picker = new Cordelia({
    elm: '#picker',
    color: '#EEA55B'
});

You can also add the script file into your html.

<script src="/node_modules/cordelia/dist/js/cordelia.min.js"></script>
<script>
var picker = new Cordelia({
    elm: '#picker',
    color: '#EEA55B'
});
</script>

Put the CSS file in the head tag.

<link rel="stylesheet" href="/node_modules/cordelia/dist/css/cordelia.min.css" />

Settings

Option	Type	Default	Description
color	String	#FF0000	The picker's initial value.
colorFormat	String	hex	The format of the picker's value. Cordelia supports three types of formats: HEX, RGB and HSL. If the opacity is less than 1, HSL is automatically converted to HSLA, HEX and RGB are automatically converted to RGBA.
pickerStyle	Number	0	Cordelia comes with two style options. In the first style, the main box allows setting the saturation and lightness of the color and the second box allows setting the color; this is the default. In the second style, the main box allows setting the color and the second box allows setting the saturation and lightness. For more information please view the demo.
embed	Boolean	true	A boolean value that indicates whether the picker is shown when a button is clicked or embedded into the page directly. If it is false, a button is displayed that allows users to show the picker.
size	String	medium	The picker's size. Three options available Small, Medium, Large.
allowOpacity	Boolean	true	A boolean value that indicates whether the opacity bar is visible or not.
allowClearColor	Boolean	false	A boolean value that indicates whether the clear color button (an eraser icon that allows clearing selection) is visible or not.
showColorValue	Boolean	true	A boolean value that indicates whether the color value box is visible or not. Color value box allows you to set a color by typing its name or code. All of the CSS color formats are supported (HEX, RGB, RGBA, HSL, HSLA).
showButtons	Boolean	true	A boolean value that indicates whether the buttons are visible or not. If the `embed` property is false, the only way to close the picker is to click on the Save or Cancel button.
showPalette	Boolean	true	A boolean value that indicates whether the color table is visible or not. Color table allows you to show pre-defined colors. It is also possible for users to save colors for later use by adding this table.
paletteColors	String[]	#FFFFB5, #FBBD87, #F45151, #7AEA89, #91C8E7, #8EB4E6, #B0A7F1	An array that holds the name or codes of the colors that will be shown in the Color Table as default.
allowPaletteAddColor	Boolean	true	A boolean value that indicates whether users can add a color to the color table or not.

Events

Event	Description
open	Fires when the picker is open.
close	Fires when the picker is closed.
save	Fires when the selection is saved.
cancel	Fires when the picker is closed without being saved.
changed	Fires when the color is changed.

Methods

Method	Params	Return	Description
get		Object	Returns the current color.
set	newColor:String	void	Changes the current color.
show		void	Shows the picker.
hide		void	Hides the picker.
save		void	Saves the selection.
cancel		void	Cancels the selection.