https://github.com/fivefifteen/colortap
A tiny, dependency-free, color input field helper that utilizes the native color picker.
https://github.com/fivefifteen/colortap
color color-picker colors field fields html input javascript js vanilla-javascript vanilla-js
Last synced: about 1 year ago
JSON representation
A tiny, dependency-free, color input field helper that utilizes the native color picker.
- Host: GitHub
- URL: https://github.com/fivefifteen/colortap
- Owner: fivefifteen
- License: mit
- Created: 2021-09-29T16:07:51.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-05T15:21:15.000Z (about 1 year ago)
- Last Synced: 2025-03-05T16:43:20.497Z (about 1 year ago)
- Topics: color, color-picker, colors, field, fields, html, input, javascript, js, vanilla-javascript, vanilla-js
- Language: JavaScript
- Homepage: http://colortap.js.org/
- Size: 200 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license.md
Awesome Lists containing this project
README
# ColorTap
A tiny, dependency-free, color input field helper that utilizes the native color picker.
[](https://www.npmjs.com/package/colortap)
[](https://www.npmjs.com/package/colortap)
[](https://github.com/fivefifteen/colortap)
[](https://github.com/standard/standard)
[](license.md)
## Demo
Visit https://colortap.js.org
## Installation
### Manual Download
[Download the latest version of colortap](https://github.com/fivefifteen/colortap/archive/refs/heads/main.zip) and then place the following HTML in your page's head element:
```html
```
### CDN (Courtesy of [jsDelivr](https://jsdelivr.com))
Place the following HTML in your page's head element (check to make sure the version in the URLs is the version you want):
```html
```
### [NPM](https://npmjs.com)
```
npm install colortap --save
```
```js
// ES6
import colortap from 'colortap'
// CommonJS
const colortap = require('colortap')
```
### [Fetcher](https://github.com/fivefifteen/fetcher)
```
fetcher install fivefifteen/colortap --save
```
### [Bower](https://bower.io)
```
bower install fivefifteen/colortap --save
```
## Usage
### Basic HTML Structure
```html
```
### The `colortap` Function
Initiates ColorTap on any element that has the `colortap` class. This should be a container around your color input.
#### Example
```js
window.addEventListener('load', function () {
colortap()
})
```
## Attributes/Classes
* The `colortap-input` class - Any input element with this class will have it's value set to the selected color any time the color is changed. The color will also be set to any value that is entered into this input field.
* The `colortap-open` class - Any element with this class will open the color picker when clicked.
* The `colortap-value` class - Any element with this class will have it's text content set to the color when the color is changed. If this element is an input, it's value will be updated instead of text content.
* The `data-colortap-style-prop` attribute - Set this attribute to a style property (like `background` or `color`) on an element to have it's style updated when the color is changed. Multiple style properties can be defined by separating them with a comma (ie. `background,color`).
## JavaScript Methods
The containing colortap element (the element with the `colortap` class) will have the following methods attached to it available for use:
```js
var color = document.querySelector('.color')
color.open() // Opens the color picker
color.set('#00ff00') // Sets the color
var currentColor = color.get() // Gets the current color
// The `change` event bubbles up to the containing element so you can detect changes like so:
color.addEventListener('change', function () {
document.body.style.setProperty('--color', event.target.value)
})
```
## Related
- [FileBokz](https://github.com/fivefifteen/filebokz) - A tiny, dependency-free, highly customizable and configurable, easy to use file input with some pretty sweet features.
- [GrowField](https://github.com/fivefifteen/growfield) - A tiny, dependency-free JavaScript module for making textarea elements grow with their content.
- [HashJump](https://github.com/fivefifteen/hashjump) - A tiny, dependency-free JavaScript module for handling anchor links and scrolling elements into view.
- [Kloner](https://github.com/fivefifteen/kloner) - A tiny, dependency-free JavaScript module for cloning/repeating elements.
## License
MIT. See the [license file](license.md) for more info.
