scrollable-cli
v1.0.4
Published
Create independent scrollable areas in the terminal.
Downloads
16
Maintainers
Readme
Create independent scrollable areas with ANSI support in the terminal.
Install
npm install scrollable-cli
Usage
Create a scrollable area with content and print it:
import Scrollable from 'scrollable-cli';
const box = Scrollable({
content:
"Lorem ipsum is boring but I couldn't think " +
"of anything else, so here's a yellow cat:" +
chalk.yellow(`
|\\---/|
| o_o |
`),
start: { x: 10, y: 3 },
size: { width: 22, height: 4 },
wrapOptions: { trim: false, hard: false, wordWrap: true }
})
.print();
Or use the fluent API:
const box = Scrollable()
.setContent("...")
.setStart({ x: 10, y: 3 })
.setSize({ width: 22, height: 4 })
.setWrapOptions({ trim: false, hard: false, wordWrap: true })
.print();
Scroll the content up and down:
box.scroll(1).print(); // Down
box.scroll(-1).print(); //Up
Key press events
This package doesn't handle keypress events to make it easier for you to integrate it with your own keypress event handler:
const box = Scrollable(/* ... */);
emitKeypressEvents(process.stdin);
process.stdin.setRawMode(true);
process.stdin.on('keypress', (str, key) => {
switch (key.name) {
case 'up':
box.scroll(-1).print();
break;
case 'down':
box.scroll(1).print();
break;
}
});
Examples
- Clone the repo:
git clone https://github.com/pawap90/scrollable-cli.git
- Install dependencies:
npm install
- Run the examples:
npm run example --file=<example-file-name>
## Or for windows:
npm run example:win --file=<example-file-name>
## E.g:
npm run example --file=1-simple-box
npm run example:win --file=1-simple-box
| Example file | Description | | -------- | -------- | | 1-simple-box | Prints a simple "lorem ipsum" box that scrolls automatically up and down. | | 2-keypress-events | Prints 3 independent boxes that can be scrolled up and down with the arrow keys. |
Test
npm test