eltonjuan / hex-to-rgba

Converts CSS hexadecimal color codes to rgb()/rgba().

hex-to-rgba turns an old-fashioned css hex color value string into an rgba() string.

Optionally pass in an alpha value. The passed alpha value will override any alpha value from 4- or 8-digit hexes. If you don't pass in an alpha value at all, we will default to an alpha value of 1 (completely opaque).

Supports 3-, 4-, 6- and 8-digit hex values with or without a leading hash.

Installation

$ npm install --save hex-to-rgba

Usage

var hexToRgba = require("hex-to-rgba");

hexToRgba('112233'); // "rgba(17, 34, 51, 1)"
hexToRgba('#112233'); // "rgba(17, 34, 51, 1)"
hexToRgba('112233', '0.5'); // "rgba(17, 34, 51, 0.5)"
hexToRgba('#112233', 0.75); // "rgba(17, 34, 51, 0.75)"

hexToRgba('11223344') // "rgba(17, 34, 51, 0.27)"
hexToRgba('#11223344') // "rgba(17, 34, 51, 0.27)"
hexToRgba('11223344', '0.5') // "rgba(17, 34, 51, 0.5)"
hexToRgba('#11223344', 0.75) // "rgba(17, 34, 51, 0.75)"

hexToRgba('123'); // "rgba(17, 34, 51, 1)"
hexToRgba('#123'); // "rgba(17, 34, 51, 1)"
hexToRgba('123', 0.2) // "rgba(17, 34, 51, 0.2)"
hexToRgba('#123', 0.2) // "rgba(17, 34, 51, 0.2)"

hexToRgba('1234'); // "rgba(17, 34, 51, 0.27)"
hexToRgba('#1234'); // "rgba(17, 34, 51, 0.27)"
hexToRgba('1234', 0.5) // "rgba(17, 34, 51, 0.5)"
hexToRgba('#1234', 0.75) // "rgba(17, 34, 51, 0.75)"

Testing

npm run build && npm test

Signature

hexToRgba(hex, a=1)

Parameters

• hex: The hex color value to convert to rgba. (examples: '123456', '#123456', '123', '#123')
• a: An alpha value to apply. (optional, default: 1) (examples: '0.5', 0.25)

Returns

An rgba() string. (examples: 'rgba(11, 22, 33, 1)', 'rgba(11, 22, 33, 0.5)')

Changelog

1.0.0

• BREAKING CHANGE: Always return rgba(); even if the color is completely opaque
• Support 4-digit hexes
• Add typescript type declaration (props @gillchristian)

0.2.0

• Support 8-digit hexes

0.1.0

• Initial release
• Support 6-digit hexes
• Support 3-digit hexes