0.0.7 • Published 8 years ago

cli-plugin v0.0.7

Weekly downloads
4
License
MIT
Repository
github
Last release
8 years ago

CLI Plugin

This project is a simple and easy to use command-line interface (CLI) for web applications.

Inspired by minimalistic user interfaces that are rich in functionality.
Designed for simplicity and built to empower.
Very light weight.

Features:

  • configurable commands
  • configurable colorschemes
  • keeps history of used commands

Demo

Click here for a live demo.

Install

  • Install 'cli-plugin' with bower
bower install cli-plugin
  • Install 'cli-plugin' with npm
npm install cli-plugin
  • Or include files directly in your html:
<link rel="stylesheet" type="text/css" href="dist/cli-plugin.min.css">
<script src="dist/cli-plugin.min.js"></script>

Setup

Initialize cliPlugin using a custom colorscheme/config file.

cliPlugin.init(config);

Config accepts following properties:

PropertyUsageDefaultRequired
textColortext color#111111no
cursorColorcursor color#111111no
backgroundColorbackground colorwhitesmokeno

Feel free to use hex, rgb(a) or html5 color names :)

Register commands

Register your own commands:

cliPlugin.bind('list', function () {
  cliPlugin.print('<p>items on the shopping list:</p>');
  cliPlugin.print('<ul><li>milk</li><li>bacon</li><li>eggs</li></ul>');
});

Useful functions

Use cliPlugin.print(text) command to print text on the screen, accepts html.

Use cliPlugin.clear() command to clear the screen.

Example

See index.html for an example implementation.