npmpackage.info

Gathering detailed insights and metrics for react-native-sectioned-multi-select-with-icon

react-native-sectioned-multi-select-with-icon - 0.7.8 | npmpackage.info

react-native-sectioned-multi-select-with-icon

a multi (or single) select component with support for sub categories, search, chips.

0.7.8

MIT

JavaScript

3.32 MB

2.5

Installations

npm install react-native-sectioned-multi-select-with-icon

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

14.2.0

NPM Version

6.14.4 Pull Requests

Open

0

Total

0

Closed

0

Issues

Open

0

Total

0

Closed

0

Releases

Unable to fetch releases

Languages

JavaScript

TypeScript

JavaScript (75.24%)

TypeScript (24.76%)

Developer

jonno85

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

1 Stars

376 Commits

1 Forks

10 Branches

1 Contributors

Updated on Jan 22, 2022

Maintainers

View All 1 Contributors

Package Meta Information

Latest Version

0.7.8

Package Id

react-native-sectioned-multi-select-with-icon@0.7.8

Unpacked Size

3.32 MB

Size

2.24 MB

File Count

NPM Version

6.14.4

Node Version

14.2.0

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Peer Dependencies

prop-types react-native-vector-icons

Dev Dependencies

babel-eslint eslint eslint-config-airbnb eslint-plugin-import eslint-plugin-jsx-a11y eslint-plugin-react

react-native-sectioned-multi-select

A multi (or single) select component with support for sub categories, search, chips. It's intended for long-ish lists, as it opens in a Modal (I might make this optional in the future).

This is based on https://github.com/toystars/react-native-multiple-select. The problems I had were that I needed it to be in a modal, because of nested ScrollViews not working on Android, and I needed to display categories with sub-categories.

Caveats

Currently all ids must be unique. So if you're pulling data from multiple sources, be aware that id clashes will cause (major) problems i.e both items with the same id will get selected. Looking for contributors for this - would require a bit of a refactor (see #33).
There is no ajax support.

Preview

preview 1 preview 2 preview 3 preview 4

Usage

You can install this package with the following command: npm i react-native-sectioned-multi-select or yarn add react-native-sectioned-multi-select

Icons

By default, the library uses React Native Vector Icons Material Icons. Before installing, please make sure you have react-native-vector-icons set up.

If you prefer to use your own icon images or icon font, the iconRenderer prop can be used to replace the icons used. See an example here: https://github.com/renrizzolo/react-native-sectioned-multi-select/blob/9c5f71852aef7a7ac03e7761d5dd810cd2ccef5d/exampleapp/App.js#L322-L397 (note the switch, you can refer to this to know what to map icon names to e.g if you're just passing in a different RN Vector Icons font).

Required props:

items | array
uniqueKey | string
onSelectedItemsChange | function

Basic Example

1import React, { Component } from 'react';
2import { View } from 'react-native';
3import SectionedMultiSelect from 'react-native-sectioned-multi-select';
4
5const items = [
6  // this is the parent or 'item'
7  {
8    name: 'Fruits',
9    id: 0,
10    // these are the children or 'sub items'
11    children: [
12      {
13        name: 'Apple',
14        id: 10,
15      },
16      {
17        name: 'Strawberry',
18        id: 17,
19      },
20      {
21        name: 'Pineapple',
22        id: 13,
23      },
24      {
25        name: 'Banana',
26        id: 14,
27      },
28      {
29        name: 'Watermelon',
30        id: 15,
31      },
32      {
33        name: 'Kiwi fruit',
34        id: 16,
35      },
36    ],
37  },
38  {
39    // next parent item
40   ...
41  },
42
43];
44
45export default class App extends Component {
46  constructor() {
47    super();
48    this.state = {
49      selectedItems: [],
50    };
51  }
52  onSelectedItemsChange = (selectedItems) => {
53    this.setState({ selectedItems });
54  };
55
56  render() {
57    return (
58      <View>
59        <SectionedMultiSelect
60          items={items}
61          uniqueKey="id"
62          subKey="children"
63          selectText="Choose some things..."
64          showDropDowns={true}
65          readOnlyHeadings={true}
66          onSelectedItemsChange={this.onSelectedItemsChange}
67          selectedItems={this.state.selectedItems}
68        />
69      </View>
70    );
71  }
72}

You can programatically remove all items by setting up a ref to the component:

<SectionedMultiSelect
    ...
    ref={SectionedMultiSelect => this.SectionedMultiSelect = SectionedMultiSelect}
/>

and then use the _removeAllItems function:

onPress={() => this.SectionedMultiSelect._removeAllItems()}

You can open the modal programatically with the _toggleSelector() method:

onPress={() => this.SectionedMultiSelect._toggleSelector()}

Recipes

See Recipes for more detailed usage examples / customizations.

Items

Your items should have a uniqueKey(default: 'id') and a displayKey (default: 'name'). Any child items of that item should be in subKey, and they will have uniqueKey and displayKey properties. As you can see from the example above, my items all have a unique id property and the child items is an array within the subKey property.

Sub categories are optional, there's no need to have subKey items if you don't want to.

You can also pass in extra options to individual items:

disabled: true - the item will be disabled
Icons: the component prop iconKey is the name of the property that individual item icons will be derived from. E.g icon: {uri: ...}. See full example here

Props

Props, there are lots.

Main

Prop	Default	type	Desc
items		array	the items
uniqueKey	'id'	string	the unique key for your items
subKey	'sub'	string	the array of sub items within items
displayKey	'name'	string	the key for the display name / title of the item
iconKey		string	the key for the display icon / bitmap of the item
selectedItems	[]	array	the selected items
onSelectedItemsChange		function	function that runs when an item is toggled
onSelectedItemObjectsChange		function	function that returns the selected items as their original objects instead of an array of ids
onCancel		function	function that runs when the cancel button is pressed
onConfirm		function	function that runs when the confirm button is pressed
onToggleSelector		function	callback function that runs when the selector is toggled. receives a boolean for the open/close state of the modal

Options

Prop	Default	type	Desc
loading	false	bool	set the loading state, shows `loadingComponent` if true
single	false	bool	allow only one selection
showDropDowns	true	bool	whether to allow dropdown toggles to show/hide the sub items (if false, sub items are always shown)
expandDropDowns	false	bool	when using `showDropDowns`, set to true to expand all the dropdowns on mount
animateDropDowns	true	bool	whether to animate toggling of dropdowns
showChips	true	bool	whether to show the chips of the selected items
hideSelect	false	bool	hide the select component
hideConfirm	false	bool	hide the confirm buttom
showCancelButton	false	bool	Show a cancel button next to the confirm button. Dismisses modal and removes all selected items.
alwaysShowSelectText	false	bool	Don't show number of items selected or the single selected item on the select label (unless `single` is true).
readOnlyHeadings	false	bool	whether the parent items can be pressed or not. If true and `showDropdowns` is true, pressing the parent item will toggle the dropdown
hideSearch	false	bool	hide the search bar entirely
selectChildren	false	bool	if true, selecting a parent item will automatically select its children
highlightChildren	false	bool	if true, selecting a parent item will automatically highlight its children (but the child ids won't be broadcast to the selectedItems state)
showRemoveAll	false	bool	Whether to show a Remove all chip at the beginning of the selected items chips
modalSupportedOrientations	['landscape', 'portrait']	array	The supportedOrientations of the Modal
modalAnimationType	'fade'	string	The animation type of the Modal (fade or slide)
modalWithSafeAreaView	false	bool	If true uses a `<SafeAreaView>` component for the backdrop component. Useful for e.g iPhone X notch
modalWithTouchable	false	bool	If true wraps the backdrop component with `<TouchableWithoutFeedback>` . Closes modal on press (`this._closeSelector()`; fires `onToggleSelector(false)`).
parentChipsRemoveChildren	false	bool	If true, pressing a parent chip's remove button will remove all of its selected children.

Customization

Prop	Default	type	Desc
selectText	'Select'	string	the text for the select component
confirmText	'Confirm'	string	the text for the confirm button
selectedText	'selected'	string OR function	the text that follows the number of items selected
renderSelectText		function	Function that allows you to set custom Select Text given access to component's `props`
searchPlaceholderText	'Search categories...'	string	the placeholder text for the search input
searchAdornment		function	receives search input text and is output on the right side of the search input
removeAllText	'Remove all'	string	Text for optional remove all button
filterItems	null	function	Use a custom filtering function for the search: receives searchText, items, props. Should return an array of item objects.
headerComponent	undefined	object	optional component to display above the search bar
footerComponent	undefined	object	optional component to display below the confirm button
stickyFooterComponent	undefined	object	optional component to display below the confirm button, but outside of the scroll view
noResultsComponent	Sorry, no results	object	the component to display when the search results are empty
loadingComponent	`ActivityIndicator`	object	the component to display when `loading` is set to true
noItemsComponent	No Items	object	Shown when the items array is empty / null
selectToggleIconComponent	Material `keyboard-arrow-down`	object	The icon to the right of the dropdown in its initial state )
searchIconComponent	Material `search`	object	The search input icon (default Magnifying glass)
selectedIconComponent	Material `check`	object	The icon component to the left of the selected item (default Checkmark)
unselectedIconComponent		object	The icon component to the left of the unselected item
dropDownToggleIconUpComponent	Material `keyboard-arrow-up`	object	The parent dropdown icon in closed state
dropDownToggleIconDownComponent	Material `keyboard-arrow-down`	object	The parent dropdown icon in opened state
cancelIconComponent	Material `cancel`	object	The cancel button's inner component
customChipsRenderer		function	Use a custom render function for custom chips: receives uniqueKey, subKey, displayKey, items, selectedItems, colors, styles. should return valid jsx
chipRemoveIconComponent	Material `close`	object	The chip remove button's icon component
styles	{}	object	Styles object - see styles section
colors	{...}	object	colors object - see colors section
itemFontFamily	Avenir / normal - bold	object	font family for the parent items. Can be a regular style object
subItemFontFamily	Avenir / normal - 200	object	font family for the sub items. Can be a regular style object
searchTextFontFamily	Avenir / normal - 200	object	font family for the search input. Can be a regular style object
confirmFontFamily	Avenir / normal - bold	object	font family for the confirm button.
itemNumberOfLines	null	number	numberOfLines for item text
selectLabelNumberOfLines	1	number	numberOfLines for select label text
customLayoutAnimation	easeInEaseOut	object	define your own `LayoutAnimation` preset or custom animation
iconRenderer		function OR object	Use your own icon component function. Receives name, size (in some cases), and style props
itemsFlatListProps	{}	object	extra props to add to / override the FlatList of parent items
subItemsFlatListProps	{}	object	extra props to add to / override the parent items' sub items FlatList

Colors

You can pass a colors object to theme it how you like.

These are the available colors and their defaults:

Name	Default	Description
primary	#3f51b5	used for the dropdown toggle icon, the no results text and the background of the confirm button.
success	#4caf50	used for the selected checkmark icon.
cancel	#1A1A1A	used for the cancel button background
text	#2e2e2e	Parent item text color
subText	#848787	Sub item text color
selectToggleTextColor	#333	Select button text color
searchPlaceholderTextColor	#999	Search input placeholder text color
searchSelectionColor	rgba(0,0,0,0.2)	Search input text selection color
itemBackground	#fff	parent item background color
subItemBackground	#ffffff	sub item background color
chipColor	#848787	chip color
disabled	#d7d7d7	Selected icon color for sub items when highlight children is used

Styles

You can pass a styles object to style it how you like.

These are the styles you can change:
container modalWrapper backdrop listContainer
selectToggle
selectToggleText
item
selectedItem
subItem
itemText selectedItemText
selectedSubItemText selectedSubItem subItemText
searchBar
center
separator
subSeparator
chipsWrapper
chipContainer parentChipContainer parentChipText chipText
chipIcon
searchTextInput
scrollView
button
confirmText
cancelButton
itemIconStyle

Changelog

View changelog.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

SAST

Determines if the project uses static code analysis.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.5

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More