@rowy/multiselect
TypeScript icon, indicating that this package has built-in type declarations

0.4.1 • Public • Published

MultiSelect npm latest release Minified size

A component to select multiple items from a list of options using the Material-UI Autocomplete component.

Storybook badge

Full documentation with props

Quick start

To use, you must provide at least the value, onChange, and options props. You should also provide a label and labelPlural prop. By default, the component is in multi-select mode and values are strings.

<MultiSelect
  value={value} // From useState
  onChange={setValue} // From useState
  options={['The Shawshank Redemption', 'The Godfather', ...]}
  label="Movie"
  labelPlural="Movies"
/>

options prop

The simplest value for the options prop is an array of strings.

If you need more control over the value returned by MultiSelect, pass an array of Option objects, which must follow this type:

type Option<T = string> = {
  value: T;
  label: string;
  disabled?: boolean;
};

value and onChange prop types depend on the multiple prop

value must be an array of T in multi-select mode.

In single-select mode, it must be either T itself or null.

The first parameter of onChange follows the same type as value.

Readme

Keywords

none

Package Sidebar

Install

npm i @rowy/multiselect

Weekly Downloads

141

Version

0.4.1

License

MIT

Unpacked Size

272 kB

Total Files

44

Last publish

Collaborators

  • shamsrowy
  • harinij