mui-checkboxlist
v1.2.0
Published
A Material UI based react component for checkbox list.
Downloads
31
Maintainers
Readme
mui-checkboxlist
This package is a checkbox list component based on Material-UI. This is designed for use with react and react-final-form.
- It accepts an array of items to be listed for selection
- Produces an array of selected items
- Customizable in terms of style and function
Check out this Live Demo.
Usage
Your application must have the following packages installed, these are declared as peer dependencies and won't we installed automatically by installing this component:
- @material-ui/core
- @material-ui/icons
- lodash
Install the actual package:
$ npm install mui-checkboxlist
Then you just need to import it into your React application:
import { CheckboxLabelValueSelect, CheckboxValueSelect } from "mui-checkboxlist";
//Use **CheckboxLabelValueSelect** when passing items with the following structure:
const listItems_labelValue = [{
label: "White"
value: "#FFFFFF"
}];
//Use **CheckboxValueSelect** when passing plain strings:
const listItems_valueOnly = [ "white", ... ];
Props & Features
| Props | Mandatory | Default | Description | | ------ | ------ | ------ | ------ | | checkedIcon | no | | Icon to show when the checkbox controls are checked. | | disabled | no | false | If set to true, checkboxes and textfields are disabled. | | label | no | | Displays a label to describe the whole list. | limit | no | | If present, it should container a number called 'max' which limits the selected items to the specified number and 'deleteLast' which when set to true, will uncheck the last checked item instead of the first. | | icon | no | | Icon to show when the checkbox controls are not checked. | | listItems | yes | | Contains all the items available for selection. | | onChange | yes | | This function will provide the updated selected values. Basic structure is (selectedItems) => {}, where selectedItems is an array. | | searchBarLabel | no | | If provided, search bar will be displayed and its value will be the placeholder. | | selectAllLabel | no | | If provided, a select/deselect-all checkbox labeled with the provided value will be displayed. Event if present but field 'limit' is also present, the selectAll checkbox will not display. | | selectedItems | no | [] | Contains the initially selected items. | | selectedItemsFirst | no | false | If set to true, selected items will be displayed on top of the list. Perfect for long lists. | | statusBar | no | false | If provided, a status bar with the number of selected items will be displayed. |
Styling
If you want to override the styles, you can use withStyles:
import CheckboxValueSelect from './CheckboxValueSelect';
import {withStyles} from '@material-ui/styles';
const styles = {
root: {
textAlign: 'center'
}
}
const StyledCheckboxValueSelect = withStyles(styles)(CheckboxValueSelect);
License
MIT