---
id: picker
title: Picker
layout: docs
category: components
permalink: docs/picker.html
next: picker-item
previous: navigatorios
---

Renders the native picker component on iOS and Android. Example:

    <Picker
      selectedValue={this.state.language}
      onValueChange={(itemValue, itemIndex) => this.setState({language: itemValue})}>
      <Picker.Item label="Java" value="java" />
      <Picker.Item label="JavaScript" value="js" />
    </Picker>

### Props

- [View props...](docs/view.html#props)
- [`onValueChange`](docs/picker.html#onvaluechange)
- [`selectedValue`](docs/picker.html#selectedvalue)
- [`enabled`](docs/picker.html#enabled)
- [`mode`](docs/picker.html#mode)
- [`prompt`](docs/picker.html#prompt)
- [`style`](docs/picker.html#style)
- [`itemStyle`](docs/picker.html#itemstyle)
- [`testID`](docs/picker.html#testid)






---

# Reference

## Props

### `onValueChange`

Callback for when an item is selected. This is called with the following parameters:

  - `itemValue`: the `value` prop of the item that was selected
  - `itemPosition`: the index of the selected item in this picker

| Type | Required |
| - | - |
| function | No |




---

### `selectedValue`

Value matching value of one of the items. Can be a string or an integer.

| Type | Required |
| - | - |
| any | No |




---

### `enabled`

If set to false, the picker will be disabled, i.e. the user will not be able to make a
selection.


| Type | Required | Platform |
| - | - | - |
| bool | No | Android  |




---

### `mode`

On Android, specifies how to display the selection items when the user taps on the picker:

  - 'dialog': Show a modal dialog. This is the default.
  - 'dropdown': Shows a dropdown anchored to the picker view



| Type | Required | Platform |
| - | - | - |
| enum('dialog', 'dropdown') | No | Android  |




---

### `prompt`

Prompt string for this picker, used on Android in dialog mode as the title of the dialog.


| Type | Required | Platform |
| - | - | - |
| string | No | Android  |



---

### `style`



| Type | Required |
| - | - |
| [style](docs/picker-style-props.html) | No |


---

### `itemStyle`

Style to apply to each of the item labels.


| Type | Required | Platform |
| - | - | - |
| [style](docs/textstyleproptypes.html) | No | iOS  |


---

### `testID`

Used to locate this view in end-to-end tests.

| Type | Required |
| - | - |
| string | No |