@santi100/coloring-lib
v1.1.2
Published
Santi's Coloring Library: Make your text look really cool!
Downloads
32
Maintainers
Readme
Santi's Coloring Library
What's this?
This is a coloring library that uses ANSI sequences to color text on a terminal. Be aware there might be bugs hidden in this code. Pull requests and issues are welcome!
Contribute
Wanna contribute? File an issue or pull request! Make sure you follow the contribution Code of Conduct.
Installation
- Via NPM:
npm install @santi100/coloring-lib
- Via Yarn:
yarn add @santi100/coloring-lib
- Via PNPM:
pnpm install @santi100/coloring-lib
API
Functions
The coloring
function is a deprecated alias for the colorize
function.
Use colorize
instead.
colorize(str: string, color: ColorOrEffect): string;
NEW! Colorstr
with colorcolor
.| Parameter | Type | Description | |-----------|-----------------|-------------------------------------| | str |
string
| The string to paint in color. | | color |ColorOrEffect
| The color to paint the string in. |Returns a string of the colored text.
colorize(str: string, colors: ArrayOfColorsOrEffects): string;
NEW! Colorstr
with colorscolors
.| Parameter | Type | Description | |-----------|--------------------------|-----------------------------------------------| |
str
|string
| The string to paint in color. | |colors
|ArrayOfColorsOrEffects
| The colors to paint the string in. |Returns a string of the colored text.
rainbowify(str: string): string;
NEW! Colorsstr
in a rainbow pattern.| Parameter | Type | Description | |-----------|-------------------------|----------------------------------------------| |
str
|string
| The string to paint in color. |Returns a string of the rainbow colored text.
function colorizeTemplate(template: string): string;
NEW! Fillstemplate
, given that it is a template like this:text %color,effect(more text) and more text
| Parameter | Type | Description | |----------------|-------------------------|----------------------------------------------| |
template
|string
| The template string to fill. |Returns the template string with all placeholders replaced with the correct colors or effects.
Classes
class Colorizer
: This is a colorizer object class. Its instance methods are called the same as the colors/effects, and you can chain them. To convert the object to a string, call theColorizer.prototype.toString()
method.Colorizer.prototype.resolve()
is a deprecated alias forColorizer.prototype.toString()
. UseColorizer.prototype.toString()
instead.The
Coloring
class is a deprecated alias for theColorizer
class. UseColorizer
instead.
Types
type Color = 'black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white';
A color to paint a string in.type Effect = 'bold' | 'blink' | 'conceal' | 'italic' | 'underline';
An effect you can give to a string. NEW! Italic and underline were introduced in version 1.1.2.type ColorOrEffect = Color | Effect;
A valid color or effect.type ArrayOfColorsOrEffects = ColorOrEffect[];
An array of valid colors or effects.
Disclaimers
*Hasn't been tested in an actual ES3 environment. Feel free to open an issue or pull request if you find any non-ES3 thing. See "Contribute" for instructions on how to do so.
^The source code is about 2 kilobytes.