text-align

A wide-character aware text alignment function for use in terminals / on the console. This package is a modern implementation of wide-align with String.prototype.padLeft and String.prototype.padRight.

Requirements

• Node.js v12 or higher

Getting Started

This package is available in the Node Package Repository and can be easily installed with npm or yarn.

$ npm i @slimio/text-align
# or
$ yarn add @slimio/text-align

Usage example

const align = require("@slimio/text-align");

console.log(align.center('abc', 10));     // '   abc    '
console.log(align.center('古古古', 10));   // '  古古古  '
console.log(align.left('abc', 10));       // 'abc       '
console.log(align.left('古古古', 10));     // '古古古    '
console.log(align.right('abc', 10));      // '       abc'
console.log(align.right('古古古', 10));    // '    古古古'

API

align.center(str: string, length: number) → string

Returns str with spaces added to both sides such that that it is length chars long and centered in the spaces.

align.left(str: string, length: number) → string

Returns str with spaces to the right such that it is length chars long.

align.right(str: string, length: number) → string

Returns str with spaces to the left such that it is length chars long.

Dependencies

|Name|Refactoring|Security Risk|Usage| |---|---|---|---| |@slimio/wcwidth|Minor|Low|Determine columns needed for a fixed-size wide-character string|

License

MIT