\r\n\r\n### Features\r\n* Themes\r\n* Simple usage\r\n* Zero dependencies\r\n* Multiple color representations\r\n* Color comparison\r\n* Opacity control\r\n* Detail adjustments via. mouse-wheel\r\n* Responsive and auto-positioning\r\n* Supports touch devices\r\n* Swatches for quick-selection\r\n* Fully accessible and i18n\r\n* [Shadow-dom support](#selection-through-a-shadow-dom)\r\n\r\n### Status of this project\r\nThis project might continue to get important security- and bug-related updates but its _feature set_ is frozen, and it's highly unlikely that it'll get new features or enhancements.\r\n\r\nThe reason behind this decision is the way this tool has been build (monolithic, the core is one single file, everything is in plain JS etc.) which makes it incredible hard to maintain, tests become impossible at this stage without a complete rewrite, and the fun is gone at such a level of cramped complexity.\r\n\r\n> Personally I recommend building these UI-Related \"widgets\" directly into the app with the framework you're using which takes more time but in return gives you full power of how it should work and look like. Frameworks such as [(p)react](https://preactjs.com/), [vue](https://vuejs.org/) and [svelte](https://svelte.dev/) will make it a breeze to develop such things within a day.\r\n\r\n##### Update\r\n\r\nThis project will be archived at the end of 2021!\r\nAfter this there will be no more bug / security fixes or feature requests.\r\n\r\n### Themes\r\n|Classic|Monolith|Nano|\r\n|-------|--------|----|\r\n||||\r\n\r\n> Nano uses css-grid thus it won't work in older browsers.\r\n\r\n## Getting Started\r\n### Node\r\nNote: The readme is always up-to-date with the latest commit. See [Releases](https://github.com/Simonwep/pickr/releases) for installation instructions regarding to the latest version.\r\n\r\nInstall via npm:\r\n```shell\r\n$ npm install @simonwep/pickr\r\n```\r\n\r\nInstall via yarn:\r\n```shell\r\n$ yarn add @simonwep/pickr\r\n```\r\n\r\nInclude code and style:\r\n```js\r\n\r\n// One of the following themes\r\nimport '@simonwep/pickr/dist/themes/classic.min.css'; // 'classic' theme\r\nimport '@simonwep/pickr/dist/themes/monolith.min.css'; // 'monolith' theme\r\nimport '@simonwep/pickr/dist/themes/nano.min.css'; // 'nano' theme\r\n\r\n// Modern or es5 bundle (pay attention to the note below!)\r\nimport Pickr from '@simonwep/pickr';\r\nimport Pickr from '@simonwep/pickr/dist/pickr.es5.min';\r\n```\r\n---\r\n\r\n> Attention: The es5-bundle (e.g. legacy version) is quite big (around a triple of the modern bundle).\r\n> Please take into consideration to use the modern version and add polyfills later to your final bundle!\r\n> (Or better: give a hint to users that they should use the latest browsers).\r\n> Browsers such as IE are **not supported** (at least not officially).\r\n\r\n### Browser\r\n\r\njsdelivr:\r\n```html\r\n\r\n\r\n \r\n \r\n \r\n\r\n\r\n\r\n\r\n```\r\n\r\nBe sure to load the `pickr.min.js` (or the es5 version) **after** `pickr.min.css`. Moreover the `script` tag doesn't work with the `defer` attribute.\r\n\r\n## Usage\r\n```javascript\r\n// Simple example, see optional options for more configuration.\r\nconst pickr = Pickr.create({\r\n el: '.color-picker',\r\n theme: 'classic', // or 'monolith', or 'nano'\r\n\r\n swatches: [\r\n 'rgba(244, 67, 54, 1)',\r\n 'rgba(233, 30, 99, 0.95)',\r\n 'rgba(156, 39, 176, 0.9)',\r\n 'rgba(103, 58, 183, 0.85)',\r\n 'rgba(63, 81, 181, 0.8)',\r\n 'rgba(33, 150, 243, 0.75)',\r\n 'rgba(3, 169, 244, 0.7)',\r\n 'rgba(0, 188, 212, 0.7)',\r\n 'rgba(0, 150, 136, 0.75)',\r\n 'rgba(76, 175, 80, 0.8)',\r\n 'rgba(139, 195, 74, 0.85)',\r\n 'rgba(205, 220, 57, 0.9)',\r\n 'rgba(255, 235, 59, 0.95)',\r\n 'rgba(255, 193, 7, 1)'\r\n ],\r\n\r\n components: {\r\n\r\n // Main components\r\n preview: true,\r\n opacity: true,\r\n hue: true,\r\n\r\n // Input / output Options\r\n interaction: {\r\n hex: true,\r\n rgba: true,\r\n hsla: true,\r\n hsva: true,\r\n cmyk: true,\r\n input: true,\r\n clear: true,\r\n save: true\r\n }\r\n }\r\n});\r\n```\r\n\r\n> You can find more examples [here](EXAMPLES.md).\r\n\r\n## Events\r\nSince version `0.4.x` Pickr is event-driven. Use the `on(event, cb)` and `off(event, cb)` functions to bind / unbind eventlistener.\r\n\r\n| Event | Description | Arguments |\r\n| -------------- | ----------- | --------- |\r\n| `init` | Initialization done - pickr can be used | `PickrInstance` |\r\n| `hide` | Pickr got closed | `PickrInstance` |\r\n| `show` | Pickr got opened | `HSVaColorObject, PickrInstance` |\r\n| `save` | User clicked the save / clear button. Also fired on clear with `null` as color. | `HSVaColorObject or null, PickrInstance` |\r\n| `clear` | User cleared the color. | `PickrInstance` |\r\n| `change` | Color has changed (but not saved). Also fired on `swatchselect` | `HSVaColorObject, eventSource, PickrInstance` |\r\n| `changestop` | User stopped to change the color | `eventSource, PickrInstance` |\r\n| `cancel` | User clicked the cancel button (return to previous color). | `PickrInstance` |\r\n| `swatchselect` | User clicked one of the swatches | `HSVaColorObject, PickrInstance` |\r\n\r\n> Example:\r\n```js\r\npickr.on('init', instance => {\r\n console.log('Event: \"init\"', instance);\r\n}).on('hide', instance => {\r\n console.log('Event: \"hide\"', instance);\r\n}).on('show', (color, instance) => {\r\n console.log('Event: \"show\"', color, instance);\r\n}).on('save', (color, instance) => {\r\n console.log('Event: \"save\"', color, instance);\r\n}).on('clear', instance => {\r\n console.log('Event: \"clear\"', instance);\r\n}).on('change', (color, source, instance) => {\r\n console.log('Event: \"change\"', color, source, instance);\r\n}).on('changestop', (source, instance) => {\r\n console.log('Event: \"changestop\"', source, instance);\r\n}).on('cancel', instance => {\r\n console.log('Event: \"cancel\"', instance);\r\n}).on('swatchselect', (color, instance) => {\r\n console.log('Event: \"swatchselect\"', color, instance);\r\n});\r\n```\r\n\r\nWhere `source` can be\r\n* `slider` _- Any slider in the UI._\r\n* `input` _- The user input field._\r\n* `swatch` _- One of the swatches._\r\n\r\n## Options\r\n```javascript\r\nconst pickr = new Pickr({\r\n\r\n // Selector or element which will be replaced with the actual color-picker.\r\n // Can be a HTMLElement.\r\n el: '.color-picker',\r\n\r\n // Where the pickr-app should be added as child.\r\n container: 'body',\r\n\r\n // Which theme you want to use. Can be 'classic', 'monolith' or 'nano'\r\n theme: 'classic',\r\n\r\n // Nested scrolling is currently not supported and as this would be really sophisticated to add this\r\n // it's easier to set this to true which will hide pickr if the user scrolls the area behind it.\r\n closeOnScroll: false,\r\n\r\n // Custom class which gets added to the pcr-app. Can be used to apply custom styles.\r\n appClass: 'custom-class',\r\n\r\n // Don't replace 'el' Element with the pickr-button, instead use 'el' as a button.\r\n // If true, appendToBody will also be automatically true.\r\n useAsButton: false,\r\n\r\n // Size of gap between pickr (widget) and the corresponding reference (button) in px\r\n padding: 8,\r\n\r\n // If true pickr won't be floating, and instead will append after the in el resolved element.\r\n // It's possible to hide it via .hide() anyway.\r\n inline: false,\r\n\r\n // If true, pickr will be repositioned automatically on page scroll or window resize.\r\n // Can be set to false to make custom positioning easier.\r\n autoReposition: true,\r\n\r\n // Defines the direction in which the knobs of hue and opacity can be moved.\r\n // 'v' => opacity- and hue-slider can both only moved vertically.\r\n // 'hv' => opacity-slider can be moved horizontally and hue-slider vertically.\r\n // Can be used to apply custom layouts\r\n sliders: 'v',\r\n\r\n // Start state. If true 'disabled' will be added to the button's classlist.\r\n disabled: false,\r\n\r\n // If true, the user won't be able to adjust any opacity.\r\n // Opacity will be locked at 1 and the opacity slider will be removed.\r\n // The HSVaColor object also doesn't contain an alpha, so the toString() methods just\r\n // print HSV, HSL, RGB, HEX, etc.\r\n lockOpacity: false,\r\n\r\n // Precision of output string (only effective if components.interaction.input is true)\r\n outputPrecision: 0,\r\n\r\n // Defines change/save behavior:\r\n // - to keep current color in place until Save is pressed, set to `true`,\r\n // - to apply color to button and preview (save) in sync with each change\r\n // (from picker or palette), set to `false`.\r\n comparison: true,\r\n\r\n // Default color. If you're using a named color such as red, white ... set\r\n // a value for defaultRepresentation too as there is no button for named-colors.\r\n default: '#42445a',\r\n\r\n // Optional color swatches. When null, swatches are disabled.\r\n // Types are all those which can be produced by pickr e.g. hex(a), hsv(a), hsl(a), rgb(a), cmyk, and also CSS color names like 'magenta'.\r\n // Example: swatches: ['#F44336', '#E91E63', '#9C27B0', '#673AB7'],\r\n swatches: null,\r\n\r\n // Default color representation of the input/output textbox.\r\n // Valid options are `HEX`, `RGBA`, `HSVA`, `HSLA` and `CMYK`.\r\n defaultRepresentation: 'HEX',\r\n\r\n // Option to keep the color picker always visible.\r\n // You can still hide / show it via 'pickr.hide()' and 'pickr.show()'.\r\n // The save button keeps its functionality, so still fires the onSave event when clicked.\r\n showAlways: false,\r\n\r\n // Close pickr with a keypress.\r\n // Default is 'Escape'. Can be the event key or code.\r\n // (see: https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)\r\n closeWithKey: 'Escape',\r\n\r\n // Defines the position of the color-picker.\r\n // Any combinations of top, left, bottom or right with one of these optional modifiers: start, middle, end\r\n // Examples: top-start / right-end\r\n // If clipping occurs, the color picker will automatically choose its position.\r\n // Pickr uses https://github.com/Simonwep/nanopop as positioning-engine.\r\n position: 'bottom-middle',\r\n\r\n // Enables the ability to change numbers in an input field with the scroll-wheel.\r\n // To use it set the cursor on a position where a number is and scroll, use ctrl to make steps of five\r\n adjustableNumbers: true,\r\n\r\n // Show or hide specific components.\r\n // By default only the palette (and the save button) is visible.\r\n components: {\r\n\r\n // Defines if the palette itself should be visible.\r\n // Will be overwritten with true if preview, opacity or hue are true\r\n palette: true,\r\n\r\n preview: true, // Display comparison between previous state and new color\r\n opacity: true, // Display opacity slider\r\n hue: true, // Display hue slider\r\n\r\n // show or hide components on the bottom interaction bar.\r\n interaction: {\r\n\r\n // Buttons, if you disable one but use the format in default: or setColor() - set the representation-type too!\r\n hex: false, // Display 'input/output format as hex' button (hexadecimal representation of the rgba value)\r\n rgba: false, // Display 'input/output format as rgba' button (red green blue and alpha)\r\n hsla: false, // Display 'input/output format as hsla' button (hue saturation lightness and alpha)\r\n hsva: false, // Display 'input/output format as hsva' button (hue saturation value and alpha)\r\n cmyk: false, // Display 'input/output format as cmyk' button (cyan mangenta yellow key )\r\n\r\n input: false, // Display input/output textbox which shows the selected color value.\r\n // the format of the input is determined by defaultRepresentation,\r\n // and can be changed by the user with the buttons set by hex, rgba, hsla, etc (above).\r\n cancel: false, // Display Cancel Button, resets the color to the previous state\r\n clear: false, // Display Clear Button; same as cancel, but keeps the window open\r\n save: false, // Display Save Button,\r\n },\r\n },\r\n\r\n // Translations, these are the default values.\r\n i18n: {\r\n\r\n // Strings visible in the UI\r\n 'ui:dialog': 'color picker dialog',\r\n 'btn:toggle': 'toggle color picker dialog',\r\n 'btn:swatch': 'color swatch',\r\n 'btn:last-color': 'use previous color',\r\n 'btn:save': 'Save',\r\n 'btn:cancel': 'Cancel',\r\n 'btn:clear': 'Clear',\r\n\r\n // Strings used for aria-labels\r\n 'aria:btn:save': 'save and close',\r\n 'aria:btn:cancel': 'cancel and close',\r\n 'aria:btn:clear': 'clear and close',\r\n 'aria:input': 'color input field',\r\n 'aria:palette': 'color selection area',\r\n 'aria:hue': 'hue selection slider',\r\n 'aria:opacity': 'selection slider'\r\n }\r\n});\r\n```\r\n\r\n## Selection through a Shadow-DOM\r\nExample setup:\r\n```html\r\n
\r\n #shadow-root\r\n
\r\n
\r\n #shadow-root\r\n \r\n
\r\n
\r\n
\r\n```\r\n\r\nTo select the `.pickr` element you can use the custom `>>` shadow-dom-selector in `el`:\r\n```js\r\nel: '.entry >> .innr .another >> .pickr'\r\n```\r\n\r\nEvery `ShadowRoot` of the query-result behind a `>>` gets used in the next query selection.\r\nAn alternative would be to provide the target-element itself as `el`.\r\n\r\n## The HSVaColor object\r\nAs default color representation is hsva (`hue`, `saturation`, `value` and `alpha`) used, but you can also convert it to other formats as listed below.\r\n\r\n* hsva.toHSVA() _- Converts the object to a hsva array._\r\n* hsva.toHSLA() _- Converts the object to a hsla array._\r\n* hsva.toRGBA() _- Converts the object to a rgba array._\r\n* hsva.toHEXA() _- Converts the object to a hexa-decimal array._\r\n* hsva.toCMYK() _- Converts the object to a cmyk array._\r\n* hsva.clone() _- Clones the color object._\r\n\r\nThe `toString()` is overridden, so you can get a color representation string.\r\n\r\n```javascript\r\nhsva.toRGBA(); // Returns [r, g, b, a]\r\nhsva.toRGBA().toString(); // Returns rgba(r, g, b, a) with highest precision\r\nhsva.toRGBA().toString(3); // Returns rgba(r, g, b, a), rounded to the third decimal\r\n```\r\n\r\n## Methods\r\n* pickr.setHSVA(h`:Number`,s`:Number`,v`:Number`,a`:Float`, silent`:Boolean`) _- Set an color, returns true if the color has been accepted._\r\n* pickr.setColor(str: `:String | null`, silent`:Boolean`)`:Boolean` _- Parses a string which represents a color (e.g. `#fff`, `rgb(10, 156, 23)`) or name e.g. 'magenta', returns true if the color has been accepted. `null` will clear the color._\r\n\r\nIf `silent` is true (Default is false), the button won't change the current color.\r\n\r\n* pickr.on(event`:String`, cb`:Function`)`:Pickr` _- Appends an event listener to the given corresponding event-name (see section Events)._\r\n* pickr.off(event`:String`, cb`:Function`)`:Pickr` _- Removes an event listener from the given corresponding event-name (see section Events)._\r\n* pickr.show()`:Pickr` _- Shows the color-picker._\r\n* pickr.hide()`:Pickr` _- Hides the color-picker._\r\n* pickr.disable()`:Pickr` _- Disables pickr and adds the `disabled` class to the button._\r\n* pickr.enable()`:Pickr` _- Enables pickr and removes the `disabled` class from the button._\r\n* pickr.isOpen()`:Pickr` _- Returns true if the color picker is currently open._\r\n* pickr.getRoot()`:Object` _- Returns the dom-tree of pickr as tree-structure._\r\n* pickr.getColor()`:HSVaColor` _- Returns the current HSVaColor object._\r\n* pickr.getSelectedColor()`:HSVaColor` _- Returns the currently applied color._\r\n* pickr.destroy() _- Destroys all functionality._\r\n* pickr.destroyAndRemove() _- Destroys all functionality and removes the pickr element including the button._\r\n* pickr.setColorRepresentation(type`:String`)`:Boolean` _- Change the current color-representation. Valid options are `HEX`, `RGBA`, `HSVA`, `HSLA` and `CMYK`, returns false if type was invalid._\r\n* pickr.getColorRepresentation()`:String` _- Returns the currently used color-representation (eg. `HEXA`, `RGBA`...)_\r\n* pickr.applyColor(silent`:Boolean`)`:Pickr` _- Same as pressing the save button. If silent is true the `onSave` event won't be called._\r\n* pickr.addSwatch(color`:String`)`:Boolean` _- Adds a color to the swatch palette. Returns `true` if the color has been successful added to the palette._\r\n* pickr.removeSwatch(index`:Number`)`:Boolean`_- Removes a color from the swatch palette by its index, returns true if successful._\r\n\r\n## Static methods\r\n**Pickr**\r\n* create(options`:Object`)`:Pickr` _- Creates a new instance._\r\n\r\n**Pickr.utils**\r\n* once(element`:HTMLElement`, event`:String`, fn`:Function`[, options `:Object`]) _- Attach an event handle which will be fired only once_\r\n* on(elements`:HTMLElement(s)`, events`:String(s)`, fn`:Function`[, options `:Object`]) _- Attach an event handler function._\r\n* off(elements`:HTMLElement(s)`, event`:String(s)`, fn`:Function`[, options `:Object`]) _- Remove an event handler._\r\n* createElementFromString(html`:String`)`:HTMLElement` _- Creates an new HTML Element out of this string._\r\n* eventPath(evt`:Event`)`:[HTMLElement]` _- A polyfill for the event-path event propery._\r\n* createFromTemplate(str`:String`) _- See [inline doumentation](https://github.com/Simonwep/pickr/blob/master/src/js/lib/utils.js#L88)._\r\n* resolveElement(val`:String|HTMLElement`) _- Resolves a `HTMLElement`, supports `>>>` as shadow dom selector._\r\n* adjustableInputNumbers(el`:InputElement`, mapper`:Function`) _- Creates the possibility to change the numbers in an inputfield via mouse scrolling.\r\nThe mapper function takes three arguments: the matched number, an multiplier and the index of the match._\r\n\r\nUse this utils carefully, it's not for sure that they will stay forever!\r\n\r\n## Static properties\r\n* version _- The current version._\r\n* I18N_DEFAULTS _- i18n default values._\r\n* DEFAULT_OPTIONS _- Default options (Do not override this property itself, only change properties of it!)._\r\n\r\n## FAQ\r\n> How do I initialize multiple pickr's? Can I access the instance via `class` or `id`?\r\n\r\nNo, you can't. You need to keep track of your instance variables - pickr is (not yet) a web-component.\r\nThe best option would be to create new elements via `document.createElement` and directly pass it as `el`.\r\n[example](https://jsfiddle.net/Simonwep/9ghk71c3/).\r\n\r\n> I want to use pickr in a form, how can I do that?\r\n\r\nYou can use `useAsButton: true` and pass a reference (or selector) of your input-element as `el`. Then you can update the input-element whenever a change was made. [example](https://jsfiddle.net/Simonwep/wL1zyqcd/).\r\n\r\n> I want to update options after mounting pickr, is that possible?\r\n\r\nUnfortunately not. The core-code of this project is rather old (over 2 years), and I made it in my early js-days - the widget is not able to dynamically re-render itself in that way.\r\nYou have to destroy and re-initialize it.\r\n\r\n## Contributing\r\nIf you want to open a issue, create a Pull Request or simply want to know how you can run it on your local machine, please read the [Contributing guide](https://github.com/Simonwep/pickr/blob/master/.github/CONTRIBUTING.md).\r\n","_attachments":{},"homepage":"https://github.com/Simonwep/pickr#readme","bugs":{"url":"https://github.com/Simonwep/pickr/issues"},"license":"MIT"}
![\"Logo\"](\"https://user-images.githubusercontent.com/30767528/57573928-1e78db80-7430-11e9-940c-aecbf3226b7c.png\")
\r\n![\"gzip](\"https://img.badgesize.io/https://raw.githubusercontent.com/Simonwep/pickr/master/dist/pickr.min.js?compression=gzip&style=flat-square\")
![\"brotli](\"https://img.badgesize.io/https://raw.githubusercontent.com/Simonwep/pickr/master/dist/pickr.min.js?compression=brotli&style=flat-square\")
![\"No](\"https://img.shields.io/badge/dependencies-none-27ae60.svg?style=popout-square\"){kind=icon}
\r\n ![\"Current](\"https://img.shields.io/github/tag/Simonwep/pickr.svg?color=3498DB&label=version&style=flat-square\")
\r\n ![\"Demo\"](\"https://user-images.githubusercontent.com/30767528/53578134-4e297e80-3b77-11e9-9d74-4d2ed547c274.gif\"/)
\r\n![](\"https://user-images.githubusercontent.com/30767528/63641974-ade08c80-c6b7-11e9-827a-faa526b5c2bf.png\")
\r\n \r\n \r\n ![](\"https://user-images.githubusercontent.com/30767528/63641973-9d301680-c6b7-11e9-9d29-2ad1da50fdce.png\")
\r\n \r\n