Skip to content

A tiny, dependency-free, color input field helper that utilizes the native color picker.

License

Notifications You must be signed in to change notification settings

kodie/kolorfield

Repository files navigation

kolorfield

npm package version Travis build status npm package downloads code style license

A tiny, dependency-free, color input field helper that utilizes the native color picker.

Demo

Visit https://kolorfield.js.org

Installation

Manual Download

Download the latest version of kolorfield and then place the following HTML in your page's head element:

<script type="text/javascript" src="dist/kolorfield.min.js"></script>
<link rel="stylesheet" href="dist/kolorfield.min.css" />

CDN (Courtesy of jsDelivr)

Place the following HTML in your page's head element (check to make sure the version in the URLs are the version you want):

<script type="text/javascript" src="https://cdn.jsdelivr.net/gh/kodie/kolorfield@0.0.2/dist/kolorfield.min.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/kodie/kolorfield@0.0.2/dist/kolorfield.min.css" />
npm install kolorfield --save
// ES6
import kolorfield from 'kolorfield'

// CommonJS
const kolorfield = require('kolorfield')
gpm install kodie/kolorfield --save
bower install kodie/kolorfield --save

Usage

Basic HTML Structure

<div class="kolorfield">
  <input type="color" id="main-color" value="#5185b3">
  <button type="button" class="kolorfield-open kolorfield-value" data-kolorfield-style-prop="background-color"></button>
</div>

The kolorfield Function

Initiates kolorfield on any element that has the kolorfield class. This should be a container around your color input.

Example

window.addEventListener('load', function () {
  kolorfield()
})

Attributes/Classes

  • The kolorfield-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 kolorfield-open class - Any element with this class will open the color picker when clicked.

  • The kolorfield-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-kolorfield-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 kolorfield element (the element with the kolorfield class) will have the following methods attached to it available for use:

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 - A tiny, dependency-free, highly customizable and configurable, easy to use file input with some pretty sweet features.

  • growfield - A tiny, dependency-free JavaScript module for making textarea elements grow with their content.

  • hashjump - A tiny, dependency-free JavaScript module for handling anchor links and scrolling elements into view.

  • kloner - A tiny, dependency-free JavaScript module for cloning/repeating elements.

  • minitaur - The ultimate, dependency-free, easy to use, JavaScript plugin for creating and managing modals.

  • peekfield - A dependency-free, easy to use, JavaScript plugin for hiding and showing fields.

License

MIT. See the license file for more info.