cli-box

A library to generate ASCII boxes via NodeJS

☁️ Installation

$ npm i --save cli-box

📋 Example

// Dependencies
var Box = require("cli-box");

// Create a simple box
var b1 = Box("20x10");
console.log(b1.toString());

// Set custom marks
var b2 = new Box({
    w: 10
  , h: 10
  , stringify: false
  , marks: {
        nw: "╔"
      , n:  "══"
      , ne: "╗"
      , e:  "║"
      , se: "╝"
      , s:  "══"
      , sw: "╚"
      , w:  "║"
      , b: "░░"
    }
});
console.log(b2.stringify());


// Box with text and use the stringify
var b3 = Box("20x10", "I will be \u001b[31mdis\u001b[0mplayed inside! \n A\u001b[34mnd I'm in a\u001b[0m new line!");
console.log(b3);

// Box with aligned text to top-right
var b4 = Box("30x20", {
    text: "Box content"
  , stretch: true
  , autoEOL: true
  , vAlign: "top"
  , hAlign: "right"
});
console.log(b4);

// Full screen box
var b5 = Box({fullscreen: true, marks: {}}, "Hello World!");
console.log(b5.toString());

📝 Documentation

CliBox(options, text)

Creates a new ASCII box.

Params

• Object|String options: A string representing the size: WIDTHxHEIGHT (e.g. 10x20) or an object:

• width or w (Number): The box width.

• height or h (Number): The box height.

• fullscreen (Boolean): If true, the box will have full size (default: false).

• stringify (Boolean): If false the box will not be stringified (the CliBox object will be returned instead).

• marks (Object): An object containing mark characters. Default:

  • nw: "┌"
  • n: "─"
  • ne: "┐"
  • e: "│"
  • se: "┘"
  • s: "─"
  • sw: "└"
  • w: "|"
  • b: " "

• Object|String text: A string to be displayed or an object:

• text (String): The text to be displayed.

• stretch (Boolean): Stretch box to fix text (default: false).

• autoEOL (Boolean): Break lines automatically (default: false).

• hAlign (String): Horizontal alignement (default: "middle"). It can take one of the values: "left", "middle", "right".

• vAlign (String): Vertical alignement (default: "center"). It can take one of the values: "top", "center", "bottom".

Return

• Object|Stringify The CliBox object (if options.stringify is false) or the stringified box.

stringify()

Returns the stringified box.

Return

• String Stringified box string.

😋 How to contribute

Have an idea? Found a bug? See how to contribute.

💰 Donations

Another way to support the development of my open-source modules is to set up a recurring donation, via Patreon. 🚀

PayPal donations are appreciated too! Each dollar helps.

Thanks! ❤️

💫 Where is this library used?

If you are using this library in one of your projects, add it in this list. ✨

• 3abn—A 3ABN radio client in the terminal.
• artstack-downloader—Download artworks from your following users.
• ascii-github—GitHub CLI Client
• cli-cal (by Falco Nogatz)—Github-like calendar graph for the CLI
• cli-gh-cal—GitHub like calendar graphs in command line.
• cli-github—A fancy GitHub client for command line.
• csk-cli (by Josh Max)—A command-line client to ClearDarkSky.com, written in Node.js
• fluxmockserverapi (by Leo Cuello)—Rest service flux-gal
• ghcal—See the GitHub contributions calendar of a user in the command line.
• le-table—Another NodeJS module for creating ASCII tables.
• overlap—Overlap two strings that contain new lines. Useful for ASCII drawings.
• text-animation—Create beautiful ASCII text animations using NodeJS.

📜 License

MIT © Ionică Bizău