1.0.1 • Published 2 years ago

@kostad/color-utils v1.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

Color Utils

Color-utils is a lightweight TypeScript library for working with colors in web development projects. It provides convenient methods for converting between different color formats, generating random colors, and more.

Installation

You can install color-uit via npm:

npm i @kostad/color-utils

Usage

This library is compatible with both JavaScript and TypeScript projects, allowing seamless integration into a wide range of web development environments.

For JavaScript:

const { getRandomHex, getRandomRgb } = require("@kostad/color-utils");

console.log(getRandomHex()); // #b68e0a
console.log(getRandomRgb()); // rgb(104,95,95)

For TypeScript

import { getRandomHex, getRandomRgb } from "@kostad/color-utils";

console.log(getRandomHex()); // #867220
console.log(getRandomRgb()); // rgb(59,135,164)

API

The library provides a variety of methods for working with RGB and hexadecimal color formats. In the future, additional functionalities such as HSL support will be added.

RGB

MethodParamsDescriptionReturn
getRandomRgbNoneThe function will return random RGB colorrgb
getRandomRgbaNoneThe function will return random RGBA colorrgba
rgbToHexrgbThe function will accept an RGB string in plain text format ('rgb(r,g,b)'). It will attempt to convert it to hexadecimal. If conversion is successful, it will return the hexadecimal value. If conversion is not possible, it will return null.hex or null
rgbaToHexargbaThe function will accept an RGBA string in plain text format ('rgba(r,g,b,a)'). It will attempt to convert it to hexadecimal. If conversion is successful, it will return the hexadecimal value. If conversion is not possible, it will return null.hexa or null

HEX

MethodParamsDescriptionReturn
getRandomHexNoneThe function will return random HEX colorhex
getRandomHexaNoneThe function will return random HEXA colorhexa
hexToRgbhexThe function will accept a hexadecimal string (#rrggbb) as input. It will attempt to convert it to an RGB format. If conversion is successful, it will return the RGB value. If conversion is not possible, it will return null.rgb or null
hexaToRgbahexaThe function will accept a hexadecimal string (#rrggbbaa) as input. It will attempt to convert it to an RGB format. If conversion is successful, it will return the RGB value. If conversion is not possible, it will return null.rgba or null

License

Color Utils is MIT licensed

1.0.1

2 years ago

1.0.0

2 years ago

0.0.3

2 years ago

0.0.2

2 years ago

0.0.1

2 years ago