4.3.4 • Published 2 years ago

react-multi-select-component v4.3.4

Weekly downloads
14,122
License
MIT
Repository
github
Last release
2 years ago

react-multi-select-component

Simple and lightweight multiple selection dropdown component with checkboxes, search and select-all

Storybook GitHub Actions Status NPM gzip

✨ Features

  • 🕶 Zero Dependency
  • 🍃 Lightweight (<5KB)
  • 💅 Themeable
  • ✌ Written w/ TypeScript

🔧 Installation

npm i react-multi-select-component    # npm
yarn add react-multi-select-component # yarn

📦 Example

Example

import React, { useState } from "react";
import { MultiSelect } from "react-multi-select-component";

const options = [
  { label: "Grapes 🍇", value: "grapes" },
  { label: "Mango 🥭", value: "mango" },
  { label: "Strawberry 🍓", value: "strawberry", disabled: true },
];

const Example = () => {
  const [selected, setSelected] = useState([]);

  return (
    <div>
      <h1>Select Fruits</h1>
      <pre>{JSON.stringify(selected)}</pre>
      <MultiSelect
        options={options}
        value={selected}
        onChange={setSelected}
        labelledBy="Select"
      />
    </div>
  );
};

export default Example;

More examples can be found here ↗

👀 Props

PropDescriptionTypeDefault
labelledByvalue for aria-labelledbystring
optionsoptions for dropdown[{label, value, disabled}]
valuepre-selected rows[{label, value}][]
hasSelectAlltoggle 'Select All' optionbooleantrue
isLoadingshow spinner on selectbooleanfalse
shouldToggleOnHovertoggle dropdown on hover optionbooleanfalse
overrideStringslocalization ↗object
onChangeonChange callbackfunction
disableddisable dropdownbooleanfalse
disableSearchhide search textboxbooleanfalse
filterOptionscustom filter options (async supported) ↗functionFuzzy Search
classNameclass name for parent componentstringmulti-select
valueRenderercustom dropdown header ↗function
ItemRenderercustom dropdown option ↗function
ClearIconCustom Clear Icon for SearchReactNode
ArrowRendererCustom Arrow Icon for DropdownReactNode
debounceDurationdebounce duration for Searchnumber300
ClearSelectedIconCustom Clear Icon for Selected Items (Hint: Pass null to prevent it from rendering completely)ReactNode
isCreatableAllows user to create unavailable option(s) example ↗booleanfalse
onCreateOptionallows to override newly created option example ↗function
closeOnChangedValueautomatically closes dropdown when its value is changedbooleanfalse

📝 Changelog

For every release changelog/migration-guide will be available in releases

🤠 Credits

📜 License

MIT © harshzalavadiya

4.3.4

2 years ago

4.3.2

2 years ago

4.3.1

2 years ago

4.3.3

2 years ago

4.3.0

2 years ago

4.2.7

2 years ago

4.2.9

2 years ago

4.2.8

2 years ago

4.2.5

2 years ago

4.2.4

2 years ago

4.2.3

2 years ago

4.2.2

2 years ago

4.2.1

2 years ago

4.2.0

2 years ago

4.1.16

2 years ago

4.1.15

2 years ago

4.1.14

2 years ago

4.1.13

3 years ago

4.1.12

3 years ago

4.1.11

3 years ago

4.1.1-0.canary-7

3 years ago

4.1.1-0.canary-6

3 years ago

4.1.1-0.canary-5

3 years ago

4.1.1-0.canary-4

3 years ago

4.1.1-0.canary-9

3 years ago

4.1.1-0.canary-3

3 years ago

4.1.1-0.canary-2

3 years ago

4.1.1-0.canary-1

3 years ago

4.1.10

3 years ago

4.1.9

3 years ago

4.1.8

3 years ago

4.1.7

3 years ago

4.1.6

3 years ago

4.1.2-canary.1

3 years ago

4.0.6-canary.1

3 years ago

4.1.4

3 years ago

4.1.3

3 years ago

4.1.5

3 years ago

4.1.0

3 years ago

4.1.2

3 years ago

4.1.1

3 years ago

4.0.6

3 years ago

4.0.5

3 years ago

4.0.4

3 years ago

4.0.3

3 years ago

4.0.2

3 years ago

4.0.1

3 years ago

4.0.0

3 years ago

3.1.7-canary.3

3 years ago

3.1.7-canary.2

3 years ago

3.1.7

3 years ago

3.1.6-canary.1

3 years ago

3.1.6

3 years ago

3.1.5

3 years ago

3.1.4

3 years ago

3.1.3

3 years ago

3.1.2

3 years ago

3.1.1

3 years ago

3.0.8

3 years ago

3.0.7

3 years ago

3.0.6

3 years ago

3.0.5

3 years ago

3.0.5-canary.1

4 years ago

3.0.4

4 years ago

3.0.3

4 years ago

3.0.2

4 years ago

3.0.1

4 years ago

3.0.0

4 years ago

2.0.14

4 years ago

2.0.13

4 years ago

2.0.12

4 years ago

2.0.11

4 years ago

2.0.10

4 years ago

2.0.9

4 years ago

2.0.9-alpha-r4

4 years ago

2.0.9-alpha-r3

4 years ago

2.0.9-alpha

4 years ago

2.0.9-alpha-r2

4 years ago

2.0.8

4 years ago

2.0.7-alpha

4 years ago

2.0.7

4 years ago

2.0.6

4 years ago

2.0.5

4 years ago

2.0.4

4 years ago

2.0.2-alpha

4 years ago

2.0.3

4 years ago

2.0.2

4 years ago

2.0.1

4 years ago

2.0.0-alpha

4 years ago

2.0.0

4 years ago

1.3.3

4 years ago

1.3.2

4 years ago

1.3.1

4 years ago

1.3.0

4 years ago

1.2.0

4 years ago

1.0.1

4 years ago

1.0.0

4 years ago

0.0.1

4 years ago