ansi-center-align

Center-align the text in a string. Handles ANSI styles.

This package was based on the wonderful center-align package created by Jon Schlinkert

Install

Install with your favorite package manager:

1npm install --save ansi-center-align

Usage

1import { centerAlign } from 'ansi-center-align';
2centerAlign(val, width);

Params

• val {string | string[]}: the string or array of strings to center align
• width {number} (optional): the total width of each line in the expected result, after it's centered.

Examples

1console.log(centerAlign('foo')); //=> 'foo' (does nothing)
2console.log(centerAlign('foo', 12)); //=> '    foo    '
3console.log(centerAlign('foo', 10)); //=> '   foo   '
4console.log(centerAlign('foo', 8));  //=> '  foo  '

Multiple lines

If expected width is not provided, the length of the longest line will be used.

Example

If used on the following:

1// value can be a string, or an array of strings
2centerAlign([
3  'Lorem ipsum dolor sit amet,',
4  'consectetur adipiscing',
5  'elit, sed do eiusmod tempor incididunt',
6  'ut labore et dolore',
7  'magna aliqua. Ut enim ad minim',
8  'veniam, quis'
9]);

The result would be:

1     Lorem ipsum dolor sit amet,
2        consectetur adipiscing
3elit, sed do eiusmod tempor incididunt
4         ut labore et dolore
5    magna aliqua. Ut enim ad minim
6             veniam, quis

About

Related projects

• center-align: Center-align the text in a string. (but doesn't handle ANSI styles). | homepage
• align-text: Align the text in a string. | homepage
• justified: Wrap words to a specified length and justified the text. | homepage
• right-align: Right-align the text in a string. | homepage
• word-wrap: Wrap words to a specified length. | homepage