Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 633 Commits
.github		.github
.storybook		.storybook
.vscode		.vscode
src		src
stories		stories
.eslintrc.cjs		.eslintrc.cjs
.gitignore		.gitignore
.nvmrc		.nvmrc
.prettierrc.json		.prettierrc.json
LICENSE		LICENSE
README.md		README.md
package.json		package.json
tsconfig.json		tsconfig.json
typings.d.ts		typings.d.ts
yarn.lock		yarn.lock

Repository files navigation

react-multi-select-component

Simple and lightweight multiple selection dropdown component withcheckboxes,search andselect-all

✨ Features

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

🔧 Installation

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

📦 Example

importReact,{useState}from"react";import{MultiSelect}from"react-multi-select-component";constoptions=[{label:"Grapes 🍇",value:"grapes"},{label:"Mango 🥭",value:"mango"},{label:"Strawberry 🍓",value:"strawberry",disabled:true},];constExample=()=>{const[selected,setSelected]=useState([]);return(<div><h1>Select Fruits</h1><pre>{JSON.stringify(selected)}</pre><MultiSelectoptions={options}value={selected}onChange={setSelected}labelledBy="Select"/></div>);};exportdefaultExample;

More examples can be foundhere ↗

👀 Props

Prop	Description	Type	Default
`labelledBy`	value for`aria-labelledby`	`string`
`options`	options for dropdown	`[{label, value, disabled}]`
`value`	pre-selected rows	`[{label, value}]`	`[]`
`hasSelectAll`	toggle 'Select All' option	`boolean`	`true`
`isLoading`	show spinner on select	`boolean`	`false`
`shouldToggleOnHover`	toggle dropdown on hover option	`boolean`	`false`
`overrideStrings`	localization ↗	`object`
`onChange`	onChange callback	`function`
`disabled`	disable dropdown	`boolean`	`false`
`disableSearch`	hide search textbox	`boolean`	`false`
`filterOptions`	custom filter options (async supported) ↗	`function`	Fuzzy Search
`className`	class name for parent component	`string`	`multi-select`
`valueRenderer`	custom dropdown header ↗	`function`
`ItemRenderer`	custom dropdown option ↗	`function`
`ClearIcon`	Custom Clear Icon for Search	`ReactNode`
`ArrowRenderer`	Custom Arrow Icon for Dropdown	`ReactNode`
`debounceDuration`	debounce duration for Search	`number`	`300`
`ClearSelectedIcon`	Custom Clear Icon for Selected Items (Hint: Pass`null` to prevent it from rendering completely)	`ReactNode`
`isCreatable`	Allows user to create unavailable option(s)example ↗	`boolean`	`false`
`onCreateOption`	allows to override newly created optionexample ↗	`function`
`closeOnChangedValue`	automatically closes dropdown when its value is changed	`boolean`	`false`