inquirer-sortable-list v1.1.0

inquirer-sortable-list

A custom prompt for Inquirer.js which displays a sortable list

This prompt supports navigation using arrow keys and reordering with Ctrl + Up/Down. Enter submits the changes or Escape to abort and return the original unchanged array.

Inspired by inquirer-sortable-checkbox.

Installation

Install the package using npm or yarn:

npm install inquirer-sortable-list

or

yarn add inquirer-sortable-list

Usage

Use the list prompt in your project by importing and configuring it:

import sortablePrompt from 'inquirer-sortable-list';

const choices = ['Option 1', 'Option 2', 'Option 3', 'Option 4'];

sortablePrompt(
  {
    message: 'Reorder the items:',
    choices,
  },
  (result) => {
    console.log('Final order:', result);
  }
);

Or using await:

import sortablePrompt from 'inquirer-sortable-list';

const choices = ['Option 1', 'Option 2', 'Option 3', 'Option 4'];

const result = await sortablePrompt({
  message: 'Reorder the items:',
  choices,
});

console.log('Final order:', result);

API Reference

The list prompt accepts a configuration object with the following properties:

The theme object allows customizing the appearance of the pointer and highlighted items.

Example Output

Before Reordering:

? Reorder the items:
  ❯ Option 1
    Option 2
    Option 3
    Option 4
(Use arrow keys to navigate, ctrl+up/down to reorder, enter to confirm, escape to cancel)

After Reordering (Ctrl + Down on "Option 1"):

? Reorder the items:
    Option 2
  ❯ Option 1
    Option 3
    Option 4

License Information

Licensed under the Apache License, Version 2.0:

http://www.apache.org/licenses/LICENSE-2.0