react-native-multiple-select-list

react-native-multiple-select-list

Stats

StarsIssuesVersionUpdatedCreatedSize
react-native-multiple-select-list
74141.0.45 years ago5 years agoMinified + gzip package size for react-native-multiple-select-list in KB

Readme

react-native-multiple-select-list

Multiple select list with search bar

Install :

npm install --save react-native-multiple-select-list

Example usage :

import CustomMultiPicker from "react-native-multiple-select-list";

const userList = {
  "123":"Tom",
  "124":"Michael",
  "125":"Christin"
}

<CustomMultiPicker
  options={userList}
  search={true} // should show search bar?
  multiple={true} //
  placeholder={"Search"}
  placeholderTextColor={'#757575'}
  returnValue={"label"} // label or value
  callback={(res)=>{ console.log(res) }} // callback, array of selected items
  rowBackgroundColor={"#eee"}
  rowHeight={40}
  rowRadius={5}
  iconColor={"#00a2dd"}
  iconSize={30}
  selectedIconName={"ios-checkmark-circle-outline"}
  unselectedIconName={"ios-radio-button-off-outline"}
  scrollViewHeight={130}
  selected={[1,2]} // list of options which are selected by default
/>

react-native-multiple-select-list

Props:

Prop Type Description
options Object list of options/items
search Boolean if the search bar should be shown or not
multiple Boolean if user can select multiple options or not. if you select an item which is already selected, it will be unselected. if multiple is disabled, it will work like radio buttons.
placeholder String placeholder text for search bar
placeholderTextColor String placeholder text color for search bar
returnValue String should it return keys of selected options or values?
callback Function whenever user selects or changes selections it will be called.
rowBackgroundColor String background color for each row in list
rowHeight Integer row height
rowRadius Integer row border radius
iconColor String icon color for checked/unchecked icons and search icon also border color of search bar
iconSize Integer icon size for checked/unchecked icons
selectedIconName String selected/checked icon name (react-native-vector-icons/Ionicon)
unselectedIconName String unselected/unchecked icon name (react-native-vector-icons/Ionicon)
scrollViewHeight Integer scrollview height (list of items)
selected Object list of options which are selected by default

Author:

Ata S.Mohammadi. ataomega@gmail.com

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.