@react-native-picker/picker| Androïde | ios | Pickerios |
|---|---|---|
![]() | ![]() | ![]() |
| Fenêtre | Macos |
|---|---|
![]() | ![]() |
| @ réactif-natif-picker / cueilleur | réactif natif | réagir-natifs |
|---|---|---|
| > = 2.0.0 | 0,61+ | 0,64+ |
| > = 1.16.0 | 0,61+ | 0,61+ |
| > = 1.2.0 | 0,60+ ou 0,59+ avec Jetificier | N / A |
| > = 1.0.0 | 0,57 | N / A |
$ npm install @react-native-picker/picker --save
ou
$ yarn add @react-native-picker/picker
Comme [email protected] et supérieur à la prise en charge de la mise à pied, il n'est pas nécessaire d'exécuter le processus de liaison. En savoir plus sur la mise à pied ici. Ceci est pris en charge par [email protected] et au-dessus.
Cocoapods sur iOS a besoin de cette étape supplémentaire:
npx pod-install
Aucune étape supplémentaire n'est requise.
L'utilisation dans les fenêtres sans automatiquement nécessite les étapes supplémentaires suivantes:
ReactNativePicker à votre solution.D:devRNTestnode_modules@react-native-pickerpickerwindowsReactNativePickerReactNativePicker.vcxproj Ajoutez une référence à ReactNativePicker à votre projet d'application principal. De Visual Studio 2019:
Cliquez avec le bouton droit sur le projet d'application principale> Ajouter> Référence ... Vérifiez ReactNativePicker à partir des projets de solution.
Ajoutez #include "winrt/ReactNativePicker.h" aux en-têtes inclus en haut du fichier.
Ajouter PackageProviders().Append(winrt::ReactNativePicker::ReactPackageProvider()); avant InitializeComponent(); .
Cocoapods sur macOS a besoin de cette étape supplémentaire (appelée à partir du répertoire macOS)
pod install
Les étapes suivantes ne sont nécessaires que si vous travaillez avec une version de React Native inférieure à 0,60
$ react-native link @react-native-picker/picker
Libraries de clic droit ➜ Add Files to [your project's name]node_modules ➜ @react-native-picker/picker et ajoutez RNCPicker.xcodeprojlibRNCPicker.a aux Build Phases de votre projet ➜ Link Binary With LibrariesCmd+R ) < android/app/src/main/java/[...]/MainApplication.java ...import com.reactnativecommunity.picker.RNCPickerPackage; aux importations en haut du fichiernew RNCPickerPackage() à la liste renvoyée par la méthode getPackages()android/settings.gradle : include ':@react-native-picker_picker'
project(':@react-native-picker_picker').projectDir = new File(rootProject.projectDir, '../node_modules/@react-native-picker/picker/android')
android/app/build.gradle : implementation project(path: ':@react-native-picker_picker')
Libraries de clic droit ➜ Add Files to [your project's name]node_modules ➜ @react-native-picker/picker et ajoutez RNCPicker.xcodeprojlibRNCPicker.a aux Build Phases de votre projet ➜ Link Binary With LibrariesCmd+R ) < Vous devez ajouter android:supportsRtl="true" à AndroidManifest.xml
< application
...
android : supportsRtl = " true " > Picker d'importation à partir de @react-native-picker/picker :
import { Picker } from '@react-native-picker/picker' ; Créer un état qui sera utilisé par le Picker :
const [ selectedLanguage , setSelectedLanguage ] = useState ( ) ; Ajoutez Picker comme ceci:
< Picker
selectedValue = { selectedLanguage }
onValueChange = { ( itemValue , itemIndex ) =>
setSelectedLanguage ( itemValue )
} >
< Picker . Item label = "Java" value = "java" />
< Picker . Item label = "JavaScript" value = "js" />
</ Picker > Si vous souhaitez ouvrir / fermer le sélecteur par programme sur Android (disponible à partir de la version 1.16.0+), passez Ref au Picker :
const pickerRef = useRef ( ) ;
function open ( ) {
pickerRef . current . focus ( ) ;
}
function close ( ) {
pickerRef . current . blur ( ) ;
}
return < Picker
ref = { pickerRef }
selectedValue = { selectedLanguage }
onValueChange = { ( itemValue , itemIndex ) =>
setSelectedLanguage ( itemValue )
} >
< Picker . Item label = "Java" value = "java" />
< Picker . Item label = "JavaScript" value = "js" />
</ Picker >View héréditaire ...onValueChangeselectedValuestyletestIDenabledmodepromptitemStyleselectionColoronValueChangeRappel pour quand un élément est sélectionné. Ceci s'appelle avec les paramètres suivants:
itemValue : L'accessoire value de l'élément sélectionnéitemPosition : l'indice de l'élément sélectionné dans ce sélecteur| Taper | Requis |
|---|---|
| fonction | Non |
selectedValueValeur de correspondance de valeur de l'un des éléments. Peut être une chaîne ou un entier.
| Taper | Requis |
|---|---|
| n'importe lequel | Non |
style| Taper | Requis |
|---|---|
| PickersTyletype | Non |
testIDUtilisé pour localiser cette vue dans les tests de bout en bout.
| Taper | Requis |
|---|---|
| chaîne | Non |
enabledS'il est réglé sur False, le sélecteur sera désactivé, c'est-à-dire que l'utilisateur ne pourra pas faire de sélection.
| Taper | Requis | Plate-forme |
|---|---|---|
| bool | Non | Android, Web, Windows |
modeSur Android, spécifie comment afficher les éléments de sélection lorsque l'utilisateur tape sur le sélecteur:
| Taper | Requis | Plate-forme |
|---|---|---|
| enum ('dialogue', 'dropdown') | Non | Androïde |
dropdownIconColor Sur Android, spécifie la couleur du triangle déroulant. La valeur d'entrée doit être la valeur acceptée par la fonction React-Native processColor .
| Taper | Requis | Plate-forme |
|---|---|---|
| Colorimer | Non | Androïde |
dropdownIconRippleColor Sur Android, spécifie la couleur Ripple du triangle déroulant. La valeur d'entrée doit être la valeur acceptée par la fonction React-Native processColor .
| Taper | Requis | Plate-forme |
|---|---|---|
| Colorimer | Non | Androïde |
promptInvite String pour ce sélecteur, utilisé sur Android en mode de dialogue comme titre de la boîte de dialogue.
| Taper | Requis | Plate-forme |
|---|---|---|
| chaîne | Non | Androïde |
itemStyleStyle à appliquer à chacune des étiquettes des articles.
| Taper | Requis | Plate-forme |
|---|---|---|
| styles de texte | Non | iOS, fenêtres |
numberOfLinesSur Android & iOS, utilisé pour tronquer le texte avec une ellipsis après avoir calculé la disposition du texte, y compris l'enveloppement de lignes, de sorte que le nombre total de lignes ne dépasse pas ce nombre. La valeur par défaut est '1'
| Taper | Requis | Plate-forme |
|---|---|---|
| nombre | Non | Android, iOS |
onBlur| Taper | Requis | Plate-forme |
|---|---|---|
| fonction | Non | Androïde |
onFocus| Taper | Requis | Plate-forme |
|---|---|---|
| fonction | Non | Androïde |
selectionColor| Taper | Requis | Plate-forme |
|---|---|---|
| Colorimer | Non | ios |
blur (Android uniquement, lib version 1.16.0+)Ferme le sélectionneur par programme
focus (Android uniquement, Lib version 1.16.0+)Ouvre un cueilleur programmatique
Accessoires qui peuvent être appliqués au Picker.Item individuel.
labelValeur affichée sur l'élément de sélecteur
| Taper | Requis |
|---|---|
| chaîne | Oui |
valueValeur réelle sur l'élément de sélecteur
| Taper | Requis |
|---|---|
| numéro, chaîne | Oui |
colorCouleur affichée sur l'élément de sélecteur
| Taper | Requis |
|---|---|
| Colorimer | Non |
fontFamilyFontfamily affichée sur l'élément de sélecteur
| Taper | Requis |
|---|---|
| chaîne | Non |
styleStyle à appliquer aux étiquettes d'articles individuelles.
| Taper | Requis | Plate-forme |
|---|---|---|
| Viewstyleprop | Non | Androïde |
enabledSi réglé sur False, l'élément spécifique sera désactivé, c'est-à-dire que l'utilisateur ne pourra pas faire de sélection
@default: vrai
| Taper | Requis | Plate-forme |
|---|---|---|
| booléen | Non | Androïde |
contentDescriptionDéfinit la description du contenu sur l'élément Picker
| Taper | Requis | Plate-forme |
|---|---|---|
| chaîne | Non | Androïde |
View héréditaire ...itemStyleonValueChangeselectedValueselectionColorthemeVariantitemStyle| Taper | Requis |
|---|---|
| styles de texte | Non |
onValueChange| Taper | Requis |
|---|---|
| fonction | Non |
selectedValue| Taper | Requis |
|---|---|
| n'importe lequel | Non |
selectionColor| Taper | Requis | Plate-forme |
|---|---|---|
| Colorimer | Non | ios |
themeVariant| Taper | Requis |
|---|---|
| enum («clair», «sombre») | Non |