Skip to content
An unified React Native Picker Modal component for iOS and Android.
Branch: master
Clone or download
Latest commit 549e9d4 Jul 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
__tests__ lifecycle methods tests fix Jul 18, 2019
dist deprecated lifecycle methods fixed Jul 18, 2019
example Bump lodash from 4.17.11 to 4.17.14 in /example Jul 13, 2019
screenshots add expo_preview.png May 16, 2019
src deprecated lifecycle methods fixed Jul 18, 2019
.babelrc.js test files created Apr 22, 2019
.codeclimate.yml code climate fix Jun 11, 2019
.editorconfig first init Apr 12, 2019
.gitignore .expo added to gitignore May 17, 2019
.travis.yml version bump 1.2.6 Jul 18, 2019
codeclimate.html code climate fix Jun 11, 2019
index.js first init Apr 12, 2019
jest.config.js expo demo added May 16, 2019
package-lock.json Merge branch 'master' into dependabot/npm_and_yarn/lodash-4.17.14 Jul 13, 2019
package.json version bump 1.2.6 Jul 18, 2019
setupTests.ts code coverage and refactor components Jun 11, 2019
tsconfig.json code coverage and refactor components Jun 11, 2019
tslint.json added common Apr 18, 2019

React Native Picker Modal View

React Native Module to select item picker modal.

Maintainability Test Coverage npm version npm downloads per month dependencies Status dev-dependencies Status Build Status

Created by Pankod

An alternative to Picker and PickerIOS components with an unified API and consistent look & feel on both plaforms. It's fully configurable and includes built-in support for text search and alphabetical index. Ideal for longer lists not suitable for "wheel-pickers".

Getting started

$ npm install react-native-picker-modal-view --save


$ yarn add react-native-picker-modal-view

Live Demo with Expo

Explore with Expo Snack


import * as React from 'react';
import { Button, SafeAreaView, Text, View } from 'react-native';

import PickerModal from 'react-native-picker-modal-view';

import data from '../../../top20.json';

export default class Main extends React.Component<{}, { selectedItem: {} }> {

	constructor(props: {}) {

		this.state = {
			selectedItem: {}

	public render(): JSX.Element {
		const { selectedItem } = this.state;

		return (
			<SafeAreaView style={{ flex: 1, justifyContent: 'center', marginHorizontal: 20 }}>
					renderSelectView={(disabled, selected, showModal) =>
						<Button disabled={disabled} title={'Show me!'} onPress={showModal} />
					selectPlaceholderText={'Choose one...'}
					onEndReached={() => console.log('list ended...')}
				<View style={{ padding: 10, alignItems: 'center', backgroundColor: '#ddd' }}>
					<Text>Chosen: </Text>

	private onClosed(): void {
		console.log('close key pressed');

	private onSelected(selected: any): void {
		this.setState({ selectedItem: selected });

		return selected;

	private onBackButtonPressed(): void {
		console.log('back key pressed');


Properties Type Description Default
modalAnimationType string The RN Modal show/hide animation type "slide"
showAlphabeticalIndex boolean Hides alphabetical index "true"
onClosed Function Fired when the modal is closed
onBackButtonPressed Function Fired when the back key is pressed
Function Returns selected item object "{Id, Name, Value, [key: string]: any}"
array Array of list items "[{Id, Name, Value, [key: string]: any}]"
renderSelectView Element Render Select Component <SelectBoxComponent (built-in)>
renderListItem Element Render List item <ListItemComponent (built-in)/>
alphabeticalIndexChars array Chracters array for the alphabetical index <Turkish alphabet chracters>
searchInputTextColor string Search input placeholder text color "#252525"
keyExtractor Function Flatlist defined {key} function <Predefined return map index>
autoGenerateAlphabeticalIndex boolean Auto-generates alphabetical index from list items data "false"
sortingLanguage string Country ISO (Alpha 2) Code for localeCompare "tr"
showToTopButton boolean Button for scroll to offset 0 "true"
onEndReached Function Fired when the list reaches the end
selectPlaceholderText string Select box placeholder text "Choose one..."
searchPlaceholderText string Search input placeholder text "Search..."
selected object Default selected item
autoSort boolean Auto-sort data list "false"
disabled boolean Disable Select box
requireSelection boolean Require at least one list item is selected "false"

Core Props of React Native

Properties Type Description Default
ModalProps object React Native Modal Props
FlatListProps object React Native Flatlist Props
SearchInputProps object React Native TextInput Props

Running example project

  1. You should have React Expo CLI to be installed in order to run example. Follow this instructions if you need to install Expo CLI.

  1. Install the dependencies:
npm install
  1. Once the installation is done, you can run the following command:


npm start

You can also use:


expo start


expo start


  • Auto-alphabetical index supported for Turkish and English languages.


  • 1.2.6 - Deprecated lifecycle methods fix
  • 1.2.5 - Flatlist initialNumToRender property hotfix
  • 1.2.3 - Refactor and code coverage
  • 1.2.2 - Fixed #5
  • 1.2.0 - Added renderSelectView and renderListItem properties.
  • 1.0.0 - Initial release
You can’t perform that action at this time.