prompt-choices

prompt-choices

Create an array of multiple choice objects for use in prompts.

Install

Install with npm:

$ npm install --save prompt-choices

Usage

var Choices = require('prompt-choices');
var choices = new Choices(['foo', 'bar', 'baz']);

API

Choices

Create a new Choices collection.

Params

• choices {Array}: One or more choice strings or objects.

Example

var choices = new Choices(['foo', 'bar', 'baz']);
var choices = new Choices([{name: 'foo'}, {name: 'bar'}, {name: 'baz'}]);

.addChoices

Add an array of normalized choice objects to the choices array. This method is called in the constructor, but it can also be used to add choices after instantiation.

Params

• choices {Array|Object}: One or more choices to add.

Example

choices.addChoices(['a', 'b', 'c']);

.choice

Create a new Choice object.

Params

• choice {String|Object}
• returns {Object}: Returns a choice object.

Example

choices.choice('blue');

.separator

Create a new Separator object. See choices-separator for more details.

Params

• separator {String}: Optionally pass a string to use as the separator.
• returns {Object}: Returns a separator object.

Example

choices.separator();

.getChoice

Get a non-separator choice from the collection.

Params

• idx {Number}: The selected choice index
• returns {Object|undefined}: Return the matched choice object or undefined

Example

choices.getChoice(1);

.getIndex

Get the index of a non-separator choice from the collection.

Params

• key {String}: The key of the choice to get
• returns {Number}: Index of the choice or -1;

Example

choices.getChoice('foo');

.get

Get the choice or separator object at the specified index.

Params

• idx {Number}: The index of the object to get
• returns {Object}: Returns the specified choice

Example

choices.getChoice(1);

.enable

Enable the choice at the given idx.

Params

• idx {Number}: The index of the choice to enable.

Example

choices.enable(1);

.disable

Disable the choice at the given idx.

Params

• idx {Number}: The index of the choice to enable.

Example

choices.disable(1);

.toggleChoices

Enable the choice at the given index, and disable all other choices.

Params

• idx {Number}: The index of the choice to toggle.

Example

choices.toggleChoices(1);

.toggleChoice

Toggle the choice at the given idx.

Params

• idx {Number}: The index of the choice to toggle.

Example

choices.toggleChoice(1);

.where

Return choices that return truthy based on the given val.

Params

• val {Object|Function|String}
• returns {Array}: Matching choices or empty array

.pluck

Pluck an object with the specified key from the choices collection.

Params

• key {String}: Property name to use for plucking objects.
• returns {Array}: Plucked objects

.length

Getter for getting the length of the collection.

.realChoices

Getter for getting all non-separator choices from the collection.

.realLength

Getter for getting the length of the collection excluding non-separator choices.

.Separator

Create a new Separator object. See choices-separator for more details.

Params

• separator {String}: Optionally pass a string to use as the separator.
• returns {Object}: Returns a separator object.

Example

new Choices.Separator();

Attribution

Code is partially based on the Choices class in Inquirer.

About

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

(This document was generated by verb-generate-readme (a verb generator), please don't edit the readme directly. Any changes to the readme must be made in .verb.md.)

To generate the readme and API documentation with verb:

$ npm install -g verb verb-generate-readme && verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.

---

This file was generated by verb-generate-readme, v0.1.30, on August 30, 2016.