hex-format

Turn a string into a 6-digit hex color value.

Most color inputs accept hex values, but only if they are the standard, 6-digit format. They reject possible mistakes and shorter codes, which results in a bad user experience. hex-format is written to format a given string and return a valid, 6-digit hex code ready to be used in JavaScript and CSS.

Installation

Open Terminal and install the package with this command:

npm install hex-format --save

Then import hex-format into any file you are planning to use it:

// Node's require()
const Hex = require('hex-format');

// ES6 imports
import Hex from 'hex-format';

Finally, call hex-format’s class. If you want to use the default options, remove [options], otherwise, replace it with an object. Find all the available options in its section.

const hex = new Hex([options]);

Now you are ready to use hex-format.

API

.format

Returns false or a valid, 6-digit hex color code.

hex.format('154') //=> #115544
hex.format('#a9') //=> #A9A9A9
hex.format('#xx9') //=> false

Options

This options allow you to configure the behavior of a string when it its formatted.

Methods

Replace the default format algorithm with another predefined one.

key: number of valid characters (7 if there are more than 6).

Example:

const hex = Hex({
  1: 'repeat',
  4: 'fill'
  7: 'invalid'
})

About

Contributing

If you find any issue, have troubles figuring out something or want to suggest a change, please open an issue or make a pull request.