react-native-picker-select

🔽 A Picker component for React Native which emulates the native <select> interfaces for iOS and Android

1,743

498

1,743

View on GitHub View on NPM

Top Related Projects

picker

1,487

Picker is a cross-platform UI component for selecting an item from a list of options.

picker

1,486

Picker is a cross-platform UI component for selecting an item from a list of options.

React Native Date Picker is datetime picker for Android and iOS. It includes date, time and datetime picker modes. The datepicker is customizable and is supporting different languages. It's written with native code to achieve the best possible look, feel and performance.

react-native-modal-datetime-picker

2,951

A React-Native datetime-picker for Android and iOS

react-native-paper

12,844

Material Design for React Native (Android & iOS)

react-native-ui-lib

6,423

UI Components Library for React Native

Quick Overview

React Native Picker Select is a customizable dropdown/picker component for React Native applications. It provides a cross-platform solution for creating native-looking select inputs on both iOS and Android, with additional support for Web platforms.

Pros

Cross-platform compatibility (iOS, Android, and Web)
Customizable appearance and behavior
Easy integration with form libraries like Formik
Supports both controlled and uncontrolled component usage

Cons

Limited styling options for some native picker elements
Occasional issues with keyboard avoidance on iOS
Requires additional setup for Web platform support
Some users report performance issues with large datasets

Code Examples

Basic usage:

import RNPickerSelect from 'react-native-picker-select';

const MyComponent = () => (
  <RNPickerSelect
    onValueChange={(value) => console.log(value)}
    items={[
      { label: 'Football', value: 'football' },
      { label: 'Baseball', value: 'baseball' },
      { label: 'Hockey', value: 'hockey' },
    ]}
  />
);

Customizing the appearance:

import RNPickerSelect from 'react-native-picker-select';

const MyComponent = () => (
  <RNPickerSelect
    onValueChange={(value) => console.log(value)}
    items={[
      { label: 'Red', value: 'red' },
      { label: 'Green', value: 'green' },
      { label: 'Blue', value: 'blue' },
    ]}
    style={{
      inputIOS: {
        fontSize: 16,
        paddingVertical: 12,
        paddingHorizontal: 10,
        borderWidth: 1,
        borderColor: 'gray',
        borderRadius: 4,
        color: 'black',
        paddingRight: 30,
      },
      inputAndroid: {
        fontSize: 16,
        paddingHorizontal: 10,
        paddingVertical: 8,
        borderWidth: 0.5,
        borderColor: 'purple',
        borderRadius: 8,
        color: 'black',
        paddingRight: 30,
      },
    }}
  />
);

Using with Formik:

import { Formik } from 'formik';
import RNPickerSelect from 'react-native-picker-select';

const MyForm = () => (
  <Formik
    initialValues={{ color: '' }}
    onSubmit={(values) => console.log(values)}
  >
    {({ handleChange, values }) => (
      <RNPickerSelect
        onValueChange={handleChange('color')}
        value={values.color}
        items={[
          { label: 'Red', value: 'red' },
          { label: 'Green', value: 'green' },
          { label: 'Blue', value: 'blue' },
        ]}
      />
    )}
  </Formik>
);

Getting Started

Install the package:

npm install react-native-picker-select

yarn add react-native-picker-select

Import and use the component in your React Native application:

import RNPickerSelect from 'react-native-picker-select';

const App = () => (
  <RNPickerSelect
    onValueChange={(value) => console.log(value)}
    items={[
      { label: 'Option 1', value: 'option1' },
      { label: 'Option 2', value: 'option2' },
      { label: 'Option 3', value: 'option3' },
    ]}
  />
);

Customize the component as needed using the available props and style options.

Competitor Comparisons

picker

1,487

Picker is a cross-platform UI component for selecting an item from a list of options.

Pros of picker

Official React Native component, ensuring better compatibility and support
Simpler implementation for basic picker functionality
Smaller package size, potentially reducing app bundle size

Cons of picker

Limited customization options compared to react-native-picker-select
Lacks some advanced features like search functionality or custom styling
May require additional work to achieve a consistent look across platforms

Code Comparison

react-native-picker-select:

import RNPickerSelect from 'react-native-picker-select';

<RNPickerSelect
  onValueChange={(value) => console.log(value)}
  items={[
    { label: 'Option 1', value: 'option1' },
    { label: 'Option 2', value: 'option2' },
  ]}
/>

picker:

import {Picker} from '@react-native-picker/picker';

<Picker
  selectedValue={selectedValue}
  onValueChange={(itemValue, itemIndex) => setSelectedValue(itemValue)}
>
  <Picker.Item label="Option 1" value="option1" />
  <Picker.Item label="Option 2" value="option2" />
</Picker>

Both libraries provide picker functionality for React Native applications. react-native-picker-select offers more customization options and advanced features, while picker provides a simpler, official implementation. The choice between the two depends on the specific requirements of your project, such as the need for advanced styling or cross-platform consistency.

picker

1,486

Picker is a cross-platform UI component for selecting an item from a list of options.

Pros of picker

Official React Native component, ensuring better compatibility and support
Simpler implementation for basic picker functionality
Smaller package size, potentially reducing app bundle size

Cons of picker

Limited customization options compared to react-native-picker-select
Lacks some advanced features like search functionality or custom styling
May require additional work to achieve a consistent look across platforms

Code Comparison

react-native-picker-select:

import RNPickerSelect from 'react-native-picker-select';

<RNPickerSelect
  onValueChange={(value) => console.log(value)}
  items={[
    { label: 'Option 1', value: 'option1' },
    { label: 'Option 2', value: 'option2' },
  ]}
/>

picker:

import {Picker} from '@react-native-picker/picker';

<Picker
  selectedValue={selectedValue}
  onValueChange={(itemValue, itemIndex) => setSelectedValue(itemValue)}
>
  <Picker.Item label="Option 1" value="option1" />
  <Picker.Item label="Option 2" value="option2" />
</Picker>

react-native-date-picker

2,189

Pros of react-native-date-picker

Specialized for date and time selection, offering more date-specific features
Supports both iOS and Android with a native look and feel
Provides more customization options for date and time formats

Cons of react-native-date-picker

Limited to date and time selection, less versatile for other types of data
May have a steeper learning curve due to more date-specific props and options

Code Comparison

react-native-date-picker:

import DatePicker from 'react-native-date-picker'

<DatePicker
  date={new Date()}
  onDateChange={setDate}
  mode="datetime"
/>

react-native-picker-select:

import RNPickerSelect from 'react-native-picker-select'

<RNPickerSelect
  onValueChange={(value) => console.log(value)}
  items={[
    { label: 'Option 1', value: 'option1' },
    { label: 'Option 2', value: 'option2' },
  ]}
/>

react-native-date-picker is specifically designed for date and time selection, offering a more tailored experience for these use cases. It provides native-looking pickers on both iOS and Android, ensuring a consistent user experience across platforms.

On the other hand, react-native-picker-select is more versatile, allowing for the creation of various types of dropdown selectors. It's not limited to date and time, making it more flexible for general-purpose selection needs.

The code comparison shows that react-native-date-picker is more straightforward for date selection, while react-native-picker-select requires more setup but offers greater flexibility for different types of data.

react-native-modal-datetime-picker

2,951

A React-Native datetime-picker for Android and iOS

Pros of react-native-modal-datetime-picker

Specifically designed for date and time picking, offering a more specialized and potentially user-friendly interface for these tasks
Includes a modal component, which can provide a better user experience by clearly separating the picker from the rest of the app's content
Supports both iOS and Android platforms with a consistent API

Cons of react-native-modal-datetime-picker

Limited to date and time selection, lacking the flexibility to pick other types of data
May require additional setup or customization for non-standard date/time formats or localization

Code Comparison

react-native-modal-datetime-picker:

<DateTimePickerModal
  isVisible={isDatePickerVisible}
  mode="date"
  onConfirm={handleConfirm}
  onCancel={hideDatePicker}
/>

react-native-picker-select:

<RNPickerSelect
  onValueChange={(value) => console.log(value)}
  items={[
    { label: 'Football', value: 'football' },
    { label: 'Baseball', value: 'baseball' },
    { label: 'Hockey', value: 'hockey' },
  ]}
/>

The code comparison shows that react-native-modal-datetime-picker is more focused on date/time selection with built-in modal functionality, while react-native-picker-select offers a more general-purpose picker with customizable options.

react-native-paper

12,844

Material Design for React Native (Android & iOS)

Pros of react-native-paper

Comprehensive UI component library with a wide range of pre-built components
Follows Material Design guidelines, ensuring a consistent and modern look
Active development and community support, with frequent updates and improvements

Cons of react-native-paper

Larger bundle size due to the extensive component library
May require additional configuration for custom styling and theming
Learning curve for developers unfamiliar with Material Design principles

Code Comparison

react-native-picker-select:

import RNPickerSelect from 'react-native-picker-select';

<RNPickerSelect
  onValueChange={(value) => console.log(value)}
  items={[
    { label: 'Option 1', value: 'option1' },
    { label: 'Option 2', value: 'option2' },
  ]}
/>

react-native-paper:

import { Picker } from 'react-native-paper';

<Picker
  selectedValue={selectedValue}
  onValueChange={(value) => setSelectedValue(value)}
>
  <Picker.Item label="Option 1" value="option1" />
  <Picker.Item label="Option 2" value="option2" />
</Picker>

While react-native-picker-select focuses specifically on providing a customizable picker component, react-native-paper offers a more comprehensive set of UI components, including a picker. The react-native-paper implementation follows Material Design guidelines and integrates well with other components from the library. However, react-native-picker-select may be more lightweight and easier to implement if you only need a picker component in your project.

react-native-ui-lib

6,423

UI Components Library for React Native

Pros of react-native-ui-lib

Comprehensive UI component library with a wide range of pre-built components
Consistent design system and theming capabilities
Active development and regular updates

Cons of react-native-ui-lib

Larger package size due to the extensive component library
Steeper learning curve for developers new to the library
May include unnecessary components for projects with specific requirements

Code Comparison

react-native-picker-select:

import RNPickerSelect from 'react-native-picker-select';

<RNPickerSelect
  onValueChange={(value) => console.log(value)}
  items={[
    { label: 'Football', value: 'football' },
    { label: 'Baseball', value: 'baseball' },
    { label: 'Hockey', value: 'hockey' },
  ]}
/>

react-native-ui-lib:

import { Picker } from 'react-native-ui-lib';

<Picker
  value={selectedValue}
  onChange={(value) => setSelectedValue(value)}
  placeholder="Select a sport"
>
  <Picker.Item label="Football" value="football" />
  <Picker.Item label="Baseball" value="baseball" />
  <Picker.Item label="Hockey" value="hockey" />
</Picker>

The react-native-picker-select library focuses specifically on providing a customizable picker component, while react-native-ui-lib offers a more comprehensive set of UI components, including a picker. The code comparison shows that both libraries provide similar functionality for creating a picker, but react-native-ui-lib uses a more declarative approach with nested Picker.Item components.

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

react-native-picker-select

A Picker component for React Native which emulates the native <select> interfaces for iOS and Android

For iOS, by default we are wrapping an unstyled TextInput component. You can then pass down styles to customize it to your needs.

For Android, by default we are using the native Picker component. If you prefer, you can set useNativeAndroidPickerStyle to false, which will also render an unstyled TextInput component. You can then pass down styles to customize it to your needs.

For either platform, you can alternatively pass down a child element of your choice that will be wrapped in a touchable area.

iOS Example Android Example

View examples on snack.expo.io

Getting Started

Installing

This package is built around and depends on @react-native-picker/picker. Please make sure you install it correctly (as seen below in installation steps).

npm install react-native-picker-select

# React Native users
npm install @react-native-picker/picker
npx pod-install

# Expo
expo install @react-native-picker/picker

Basic Usage

import RNPickerSelect from 'react-native-picker-select';

export const Dropdown = () => {
  return (
    <RNPickerSelect
      onValueChange={(value) => console.log(value)}
      items={[
        { label: 'Football', value: 'football' },
        { label: 'Baseball', value: 'baseball' },
        { label: 'Hockey', value: 'hockey' },
      ]}
    />
  );
};

Versioning

Version	Notes
>= 8.0.0	Uses @react-native-picker/picker. React Native 0.60 or above. If using Expo, SDK38 or above.
>= 3.0.0	React v16.3 or above.
< 3.0.0	React v16.2 or below.

Props

Name	Description	Details
`onValueChange`	Callback which returns `value, index`	required function
`items`	The items for the component to render - Each item should be in the following format: `{label: 'Orange', value: 'orange', key: 'orange', color: 'orange', inputLabel: 'Orange!', testID: 'e2e-orange'}` - `label` and `value` are required - `key`, `color`, `testID`, and `inputLabel` are optional - `key` will be set to equal `label` if not included - `value` can be any data type - If `inputLabel` exists, the TextInput will display that value instead of the `label`	required array
`placeholder`	- An override for the default placeholder object with a label of `Select an item...` and a value of `null` - An empty object can be used if you'd like to disable the placeholder entirely	object
`disabled`	Disables interaction with the component	boolean
`value`	Will attempt to locate a matching item from the `items` array by checking each item's `value` property. If found, it will update the component to show that item as selected. If the value is not found, it will default to the first item. WARNING: do not use this attribute on iOS if you plan to allow the user to modify the value from within the `Picker`, use `itemKey` instead.	any
`itemKey`	Will attempt to locate a matching item from the `items` array by checking each item's `key` property. If found, it will update the component to show that item as selected. If the key is not found, it will attempt to find a matching item by `value` as above.	string, number
`style`	Style overrides for most parts of the component. More details in styling	object
`darkTheme` iOS only	Use the dark theme for the Picker.	boolean
`pickerProps`	Additional props to pass to the Picker (some props are used in core functionality so use this carefully)	object
`Icon`	Custom icon component to be rendered. More details in styling	Component
`textInputProps`	Additional props to pass to the TextInput (some props are used in core functionality so use this carefully). This is iOS only unless `useNativeAndroidPickerStyle={false}`.	object
`touchableWrapperProps`	Additional props to pass to the touchable wrapping the TextInput (some props are used in core functionality so use this carefully)	object
`onOpen()`	Callback triggered right before the opening of the picker Not supported when `useNativeAndroidPickerStyle={true}`	function
`useNativeAndroidPickerStyle` Android only	The component defaults to using the native Android Picker in its un-selected state. Setting this flag to `false` will mimic the default iOS presentation where a tappable TextInput is displayed. More details in styling	boolean
`fixAndroidTouchableBug` Android only	Experimental flag to fix issue #354	boolean
`InputAccessoryView` iOS only	Replace the InputAcessoryView section (bar with tabbing arrown and Done button) of the opened picker with your own custom component. Can also return `null` here to hide completely. While this bar is typical on `select` elements on the web, the interface guidelines does not include it. View the snack to see examples on how this can be customized.	Component
`doneText` iOS only	"Done" default text on the modal. Can be overwritten here	string
`onUpArrow() / onDownArrow()` iOS only	Presence enables the corresponding arrow - Closes the picker - Calls the callback provided	function
`onDonePress()` iOS only	Callback when the 'Done' button is pressed	function
`onClose(Bool)` iOS only	Callback triggered right before the closing of the picker. It has one boolean parameter indicating if the done button was pressed or not	function
`modalProps` iOS only	Additional props to pass to the Modal (some props are used in core functionality so use this carefully)	object
`touchableDoneProps` iOS only	Additional props to pass to the Done touchable (some props are used in core functionality so use this carefully)	object

Styling

All properties mentioned below must be nested under the style prop. Examples of different styling options can be found on the example snack.

iOS-specific

The component wraps a TextInput without styling. You can target the TextInput styling with inputIOS.
Other styles that can be modified for iOS are named inputIOSContainer, placeholder, viewContainer, chevronContainer, chevron, chevronUp, chevronDown, chevronActive, done, modalViewTop, modalViewMiddle, and modalViewBottom

Android-specific

The native Picker in its inactive state acts looks similar to a TextInput, but it has limitations on custom styling. Any styling that is possible can be applied via inputAndroid.
You can add some styling customization to the active-state native Picker, but that requires modifying some xml files
If you set the prop useNativeAndroidPickerStyle to false, the component will allow a few other style objects: inputAndroidContainer, placeholder, and inputAndroid
Other styles that can be modified for Android are named headlessAndroidContainer and viewContainer

Web-specific

The component creates a select tag
The styling of this select tag can be modified using a nested object with the key inputWeb

Icon

If a component is passed in via the Icon prop - it will be rendered with { position: 'absolute', right: 0 } applied to its wrapping container. You can modify these values and add additional spacing to position the icon as needed by modifying iconContainer. You'll probably also want to add some paddingRight to your input styling to avoid any longer text appearing behind the icon.
You can pass a component of your choosing (css, image, svg, etc..) for use as the icon. For ease of use, consider a library such as react-native-shapes or react-native-vector-icons.
Examples of different icons and their usage can be found on the example snack.

Accessibility

If you need to add accessibility props to the rendered component, you may use pickerProps and touchableWrapperProps to pass these through.

pickerProps accepts an object of props that get passed directly to the native <Picker /> component. touchableWrapperProps also accepts an object of props, but this gets passed to a <TouchableOpacity /> that toggles the visibility of the picker.^{*note: touchableWrapperProps is not supported on web or when useNativeAndroidPickerStyle={true}}

Accessibility Example

In the example below, we render the picker with supplementary description text, but for screen readers, we omit this by passing just the title to the accessibilityLabel prop.

const selectedItem = {
  title: 'Selected item title',
  description: 'Secondary long descriptive text ...',
};

export const Dropdown = () => {
  return (
    <RNPickerSelect
      pickerProps={{
        accessibilityLabel: selectedItem.title,
      }}
    >
      <Text>{selectedItem.title}</Text>
      <Text>{selectedItem.description}</Text>
    </RNPickerSelect>
  );
};

Testing

Test suite included. This component has been used and tested since React Native v0.51.

License

react-native-picker-select is MIT licensed and built with :heart: in Austin, TX by the team at LawnStarter

Top Related Projects

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

Top Related Projects

Quick Overview

Pros

Cons

Code Examples

Getting Started

Competitor Comparisons

Pros of picker

Cons of picker

Code Comparison

Pros of picker

Cons of picker

Code Comparison

Pros of react-native-date-picker

Cons of react-native-date-picker

Code Comparison

Pros of react-native-modal-datetime-picker

Cons of react-native-modal-datetime-picker

Code Comparison

Pros of react-native-paper

Cons of react-native-paper

Code Comparison

Pros of react-native-ui-lib

Cons of react-native-ui-lib

Code Comparison

Convert designs to code with AI

README

react-native-picker-select

Getting Started

Installing

Basic Usage

Versioning

Props

Styling

iOS-specific

Android-specific

Web-specific

Icon

Accessibility

Accessibility Example

Testing

License

Top Related Projects

Convert designs to code with AI

NPM DownloadsLast 30 Days