multi-select-checkbox
v3.2.3
Published
Simple and lightweight multiple selection component with checkboxes, search and select-all
Downloads
249
Maintainers
Readme
MultiSelectCheckBox
Simple and lightweight multiple selection component with checkboxes, search and select-all
✨ Features
- Select All Checkbox Field
- Search Box for searching list of checkbox items
- Web Accessibility(no need of mouse => Use
space
to select/unselect checkbox , Usetab
for switching element)
Installation and usage
yarn add multi-select-checkbox
npm i multi-select-checkbox
Then use it in your app:
With React Component
import React from "react";
import { MultiSelectCheckBox } from "multi-select-checkbox/dist/MultiSelectCheckBox";
function App() {
const CheckBoxList = [
{
label: "eat",
value: "eat",
},
{
label: "sleep",
value: "sleep",
},
{
label: "coding",
value: "coding",
},
{
label: "Repeat",
value: "Repeat",
},
{
label: "Reapeat again!",
value: "Reapeat again!",
},
{
label: "Reapeat again again!",
value: "Reapeat again again!",
},
];
const [selectedValue, setSelectedValue] = React.useState([]);
return (
<div className="">
<p>{JSON.stringify(selectedValue, null, 2)}</p>
<MultiSelectCheckBox
selectAllShow={true}
selectedCheckBox={[
{
label: "eat",
value: "eat",
},
]}
searchLabelName="Search : "
searchLabelClassName="searchLabelClassName"
searchFilterParentDivClassName="searchFilterParentDivClassName"
searchFilterClassName="searchFilterClassName"
searchPlaceHolderName="Search Here..."
showSearchBox={true}
selectAllClassLabelName="select_all_label_class_name"
listOfCheckBoxItemsLabelClassName="list_of_checkbox_item_label_class_name"
selectAllParentDivClassName="selectAllParentDivClassName"
listOfAllCheckBoxParentDivClassName="listOfAllCheckBoxParentDivClassName"
selectAllShowClassName="select_all_checkbox_classname"
listOfCheckBoxItemsClassName="list_of_all_checkbox_classname"
CheckBoxList={CheckBoxList}
selectAllLabelName="Select All..."
onChange={function (item) {
// get All list of selected Item....
setSelectedValue(item);
}}
/>
</div>
);
}
export default App;
Props
Common props you may want to specify include:
selectAllShow
- show select all optionselectedCheckBox
- show already selected checkboxselectAllClassLabelName
- apply a className to the select all label tagselectAllParentDivClassName
- apply classNames to select all div tag,which contains select all checkbox field and labelselectAllShowClassName
- apply a className to the select all checkboxselectAllLabelName
- change the text of select all label namelistOfCheckBoxItemsLabelClassName
- apply a className to the list of checkbox items labellistOfAllCheckBoxParentDivClassName
- apply classNames to list of checkbox items div tag,which contains list of checkbox field and labellistOfCheckBoxItemsClassName
- apply a className to the list of checkboxesCheckBoxList
- need to pass an array of an objects , to show list of all checkbox itemsonChange
- get All list of selected ItemsearchFilterParentDivClassName
- search box parent div class namesearchFilterClassName
- search box class namesearchPlaceHolderName
- search box placeholder nameshowSearchBox
- show search box , by default it will be truesearchLabelName
- search label namesearchLabelClassName
- search label class name