@react-native-picker/picker| Android | iOS | بيكريوس |
|---|---|---|
![]() | ![]() | ![]() |
| النوافذ | ماكوس |
|---|---|
![]() | ![]() |
| @React-native-picker/picker | رد الفعل | React-Native-Windows |
|---|---|---|
| > = 2.0.0 | 0.61+ | 0.64+ |
| > = 1.16.0 | 0.61+ | 0.61+ |
| > = 1.2.0 | 0.60+ أو 0.59+ مع Jetifier | ن/أ |
| > = 1.0.0 | 0.57 | ن/أ |
$ npm install @react-native-picker/picker --save
أو
$ yarn add @react-native-picker/picker
كما [email protected] وما فوق يدعم الأوتوماب التلقائي ، فلا توجد حاجة لتشغيل عملية الارتباط. اقرأ المزيد عن التفكير التلقائي هنا. ويدعم هذا بواسطة [email protected] وما فوق.
يحتاج Cocoapods على iOS إلى هذه الخطوة الإضافية:
npx pod-install
لا يلزم خطوة إضافية.
يتطلب الاستخدام في النوافذ بدون توليد تلقائي الخطوات الإضافية التالية:
ReactNativePicker إلى الحل الخاص بك.D:devRNTestnode_modules@react-native-pickerpickerwindowsReactNativePickerReactNativePicker.vcxproj أضف إشارة إلى ReactNativePicker إلى مشروع التطبيق الرئيسي الخاص بك. من Visual Studio 2019:
انقر بزر الماوس الأيمن فوق مشروع التطبيق الرئيسي> إضافة> مرجع ... تحقق من ReactNativePicker من مشاريع الحلول.
أضف #include "winrt/ReactNativePicker.h" إلى الرؤوس المدرجة في الجزء العلوي من الملف.
إضافة PackageProviders().Append(winrt::ReactNativePicker::ReactPackageProvider()); قبل InitializeComponent(); .
يحتاج Cocoapods على MacOS إلى هذه الخطوة الإضافية (تسمى من دليل MacOS)
pod install
الخطوات التالية ضرورية فقط إذا كنت تعمل مع إصدار من React Native أقل من 0.60
$ react-native link @react-native-picker/picker
Libraries ➜ Add Files to [your project's name]node_modules ➜ @react-native-picker/picker وأضف RNCPicker.xcodeprojlibRNCPicker.a إلى Build Phases مشروعك ➜ Link Binary With LibrariesCmd+R ) < android/app/src/main/java/[...]/MainApplication.java )import com.reactnativecommunity.picker.RNCPickerPackage; إلى الواردات في الجزء العلوي من الملفnew RNCPickerPackage() إلى القائمة التي تم إرجاعها بواسطة طريقة 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 ➜ Add Files to [your project's name]node_modules ➜ @react-native-picker/picker وأضف RNCPicker.xcodeprojlibRNCPicker.a إلى Build Phases مشروعك ➜ Link Binary With LibrariesCmd+R ) < تحتاج إلى إضافة android:supportsRtl="true" إلى AndroidManifest.xml
< application
...
android : supportsRtl = " true " > استيراد منتقي من @react-native-picker/picker :
import { Picker } from '@react-native-picker/picker' ; إنشاء حالة سيتم استخدامها من قبل Picker :
const [ selectedLanguage , setSelectedLanguage ] = useState ( ) ; أضف Picker مثل هذا:
< Picker
selectedValue = { selectedLanguage }
onValueChange = { ( itemValue , itemIndex ) =>
setSelectedLanguage ( itemValue )
} >
< Picker . Item label = "Java" value = "java" />
< Picker . Item label = "JavaScript" value = "js" />
</ Picker > إذا كنت ترغب في فتح/إغلاق منتقي بشكل برمجي على Android (متوفر من الإصدار 1.16.0+) ، فالمرجع إلى 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 الموروثة الدعائم ...onValueChangeselectedValuestyletestIDenabledmodepromptitemStyleselectionColoronValueChangeرد الاتصال عند تحديد عنصر. وهذا ما يسمى مع المعلمات التالية:
itemValue : دعم value العنصر الذي تم تحديدهitemPosition : فهرس العنصر المحدد في هذا المنتقي| يكتب | مطلوب |
|---|---|
| وظيفة | لا |
selectedValueقيمة مطابقة القيمة لأحد العناصر. يمكن أن تكون سلسلة أو عدد صحيح.
| يكتب | مطلوب |
|---|---|
| أي | لا |
style| يكتب | مطلوب |
|---|---|
| Pickerstyletype | لا |
testIDتستخدم لتحديد هذا العرض في الاختبارات الشاملة.
| يكتب | مطلوب |
|---|---|
| خيط | لا |
enabledإذا تم تعيينها على FALSE ، فسيتم تعطيل المنتقي ، أي لن يتمكن المستخدم من تحديد.
| يكتب | مطلوب | منصة |
|---|---|---|
| بول | لا | Android ، الويب ، Windows |
modeعلى Android ، يحدد كيفية عرض عناصر التحديد عندما ينقر المستخدم على المنتقي:
| يكتب | مطلوب | منصة |
|---|---|---|
| التعداد ("مربع الحوار" ، "المنسدلة") | لا | Android |
dropdownIconColor على Android ، يحدد لونث المثلث المنسدلة. يجب أن تكون قيمة الإدخال قيمة مقبولة بواسطة دالة Rection-Native processColor .
| يكتب | مطلوب | منصة |
|---|---|---|
| ColorValue | لا | Android |
dropdownIconRippleColor على Android ، يحدد لون تموج المثلث المنسدلة. يجب أن تكون قيمة الإدخال قيمة مقبولة بواسطة دالة Rection-Native processColor .
| يكتب | مطلوب | منصة |
|---|---|---|
| ColorValue | لا | Android |
promptالسلسلة المطالبة لهذا المنتقي ، المستخدمة على Android في وضع الحوار كعنوان الحوار.
| يكتب | مطلوب | منصة |
|---|---|---|
| خيط | لا | Android |
itemStyleنمط لتطبيق على كل من ملصقات العناصر.
| يكتب | مطلوب | منصة |
|---|---|---|
| أنماط النص | لا | iOS ، Windows |
numberOfLinesعلى Android & iOS ، تستخدم لاقتطاع النص باستخدام القطع الناقص بعد حساب تخطيط النص ، بما في ذلك تغليف الخط ، بحيث لا يتجاوز العدد الإجمالي للخطوط هذا الرقم. الافتراضي هو "1"
| يكتب | مطلوب | منصة |
|---|---|---|
| رقم | لا | Android ، iOS |
onBlur| يكتب | مطلوب | منصة |
|---|---|---|
| وظيفة | لا | Android |
onFocus| يكتب | مطلوب | منصة |
|---|---|---|
| وظيفة | لا | Android |
selectionColor| يكتب | مطلوب | منصة |
|---|---|---|
| ColorValue | لا | iOS |
blur (Android فقط ، إصدار LIB 1.16.0+)يغلق برمجيا منتقي
focus (Android فقط ، LIB الإصدار 1.16.0+)يفتح برمجيا منتقي
الدعائم التي يمكن تطبيقها على Picker.Item
labelالقيمة المعروضة على عنصر منتقي
| يكتب | مطلوب |
|---|---|
| خيط | نعم |
valueالقيمة الفعلية على عنصر منتقي
| يكتب | مطلوب |
|---|---|
| رقم ، سلسلة | نعم |
colorاللون المعروض على عنصر منتقي
| يكتب | مطلوب |
|---|---|
| ColorValue | لا |
fontFamilyعرض Fontfamily على عنصر منتقي
| يكتب | مطلوب |
|---|---|
| خيط | لا |
styleنمط لتطبيق على ملصقات العناصر الفردية.
| يكتب | مطلوب | منصة |
|---|---|---|
| ViewStyleProp | لا | Android |
enabledإذا تم تعيينه على خطأ ، فسيتم تعطيل العنصر المحدد ، أي لن يتمكن المستخدم من تحديد الاختيار
default: صحيح
| يكتب | مطلوب | منصة |
|---|---|---|
| منطقية | لا | Android |
contentDescriptionيعين وصف المحتوى على عنصر منتقي
| يكتب | مطلوب | منصة |
|---|---|---|
| خيط | لا | Android |
View الموروثة الدعائم ...itemStyleonValueChangeselectedValueselectionColorthemeVariantitemStyle| يكتب | مطلوب |
|---|---|
| أنماط النص | لا |
onValueChange| يكتب | مطلوب |
|---|---|
| وظيفة | لا |
selectedValue| يكتب | مطلوب |
|---|---|
| أي | لا |
selectionColor| يكتب | مطلوب | منصة |
|---|---|---|
| ColorValue | لا | iOS |
themeVariant| يكتب | مطلوب |
|---|---|
| التعداد ("الضوء" ، "الظلام") | لا |