multi-select-checkbox
v3.2.3
Published
Simple and lightweight multiple selection component with checkboxes, search and select-all
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
spaceto select/unselect checkbox , Usetabfor switching element)
Installation and usage
yarn add multi-select-checkbox
npm i multi-select-checkboxThen 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
