wafflez

Waffelz

Create boxes in the terminal

Install

$ npm install --save wafflez

Usage

const wafflez = require('wafflez');
 
console.log(wafflez('unicorn', {padding: 1}));
/*
┌─────────────┐
│             │
│   unicorn   │
│             │
└─────────────┘
*/
 
console.log(wafflez('unicorn', {padding: 1, margin: 1, borderStyle: 'double'}));
/*
 
   ╔═════════════╗
   ║             ║
   ║   unicorn   ║
   ║             ║
   ╚═════════════╝
 
*/

API

wafflez(input, [options])

input

Type: string

Text inside the box.

options

borderColor

Type: string
Values: black red green yellow blue magenta cyan white gray

Color of the box border.

borderStyle

Type: string object
Default: single
Values:

• single

┌───┐
│foo│
└───┘

• double

╔═══╗
║foo║
╚═══╝

• round (single sides with round corners)

╭───╮
│foo│
╰───╯

• single-double (single on top and bottom, double on right and left)

╓───╖
║foo║
╙───╜

• double-single (double on top and bottom, single on right and left)

╒═══╕
│foo│
╘═══╛

• classic

+---+
|foo|
+---+

Style of the box border.

Can be any of the above predefined styles or an object with the following keys:

{
    topLeft: '+',
    topRight: '+',
    bottomLeft: '+',
    bottomRight: '+',
    horizontal: '-',
    vertical: '|'
}

dimBorder

Type: boolean
Default: false

Reduce opacity of the border.

padding

Type: number object
Default: 0

Space between the text and box border.

Accepts a number or an object with any of the top, right, bottom, left properties. When a number is specified, the left/right padding is 3 times the top/bottom to make it look nice.

margin

Type: number object
Default: 0

Space around the box.

Accepts a number or an object with any of the top, right, bottom, left properties. When a number is specified, the left/right margin is 3 times the top/bottom to make it look nice.

backgroundColor

Type: string
Values: black red green yellow blue magenta cyan white

Color of the background.

License

MIT © Kabir Shah