1.0.0 • Published 6 years ago
@nois/react-native-picker v1.0.0
@react-native-community/picker
Getting started
$ npm install @react-native-community/picker --save
Mostly automatic installation
$ react-native link @react-native-community/picker
Manual installation
iOS
- In XCode, in the project navigator, right click
Libraries➜Add Files to [your project's name] - Go to
node_modules➜@react-native-community/pickerand addRNCPicker.xcodeproj - In XCode, in the project navigator, select your project. Add
libRNCPicker.ato your project'sBuild Phases➜Link Binary With Libraries - Run your project (
Cmd+R)<
Android
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.reactnativecommunity.picker.RNCPickerPackage;to the imports at the top of the file - Add
new RNCPickerPackage()to the list returned by thegetPackages()method
- Append the following lines to
android/settings.gradle:include ': @react-native-community/picker' project(': @react-native-community/picker').projectDir = new File(rootProject.projectDir, '../node_modules/ @react-native-community/picker/android') - Insert the following lines inside the dependencies block in
android/app/build.gradle:compile project(': @react-native-community/picker')
Usage
Picker
Renders the native picker component on iOS and Android. Example:
<Picker
selectedValue={this.state.language}
style={{height: 50, width: 100}}
onValueChange={(itemValue, itemIndex) =>
this.setState({language: itemValue})
}>
<Picker.Item label="Java" value="java" />
<Picker.Item label="JavaScript" value="js" />
</Picker>Props
Reference
Props
onValueChange
Callback for when an item is selected. This is called with the following parameters:
itemValue: thevalueprop of the item that was selecteditemPosition: 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 |
style
| Type | Required |
|---|---|
| pickerStyleType | No |
testID
Used to locate this view in end-to-end tests.
| Type | Required |
|---|---|
| string | 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 |
itemStyle
Style to apply to each of the item labels.
| Type | Required | Platform |
|---|---|---|
| text styles | No | iOS |
PickerIOS
Props
Reference
Props
itemStyle
| Type | Required |
|---|---|
| text styles | No |
onValueChange
| Type | Required |
|---|---|
| function | No |
selectedValue
| Type | Required |
|---|---|
| any | No |
1.0.0
6 years ago