urltomarkdown/node_modules/justify-text/README.md

1.1 KiB
Executable File

justify-text

This is a simple module, which allows for left or right justifying text in a given width. The padding character can be specified, and it defaults to a space.

Numbers are explicily handled now, so they do not need to be converted to a string before passing them to ljust or rjust any more.

If the padding width specified is less than the length of the initial string, no truncation occurs.

Installation

npm install -S justify-text

or

yarn add justify-text

Functions

ljust() and rjust() take a string or number, a width to render it in, and an optional padding character, which is a space by default.

ljust(string, width, padding=' ')
rjust(string, width, padding=' ')

Usage

const { ljust, rjust } = require('justify-text');

ljust('text', 7);
// => "text   "

ljust('text', 6, '0');
// => "text00"

rjust('text', 8);
// => "    text"

rjust('longtext', 7);
// => "longtext", i.e. unchanged because it is already more than 7 characters

rjust('text', 9, '.');
// => ".....text"

rjust(936, 5);
// => "  936"

ljust(780.25, 8);
// => "780.25  "

License

MIT