عرض مصدر ReactNative/picker

<noinclude>{{DISPLAYTITLE: Picker في React Native}}</noinclude>

يُصيّر مكون الانتقاء الأصيل على iOS وAndroid. مثال:
<syntaxhighlight lang="javascript">
<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>
</syntaxhighlight>
== الخاصيات ==
يرث خاصيّات المكوّن <code>[[ReactNative/view|View]]</code>.
===‎‎<code>onValueChange</code>‎‎===
دالة رد نداء تُستدعى بالمعاملات التالية عند تحديد عنصر ما:

* <code>itemValue</code>: الخاصية <code>value</code> الخاصة بالعنصر المُحدَّد.
* <code>itemPosition</code>: فهرس العنصر المُحدَّد في مكوّن الانتقاء هذا.

{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
|لا
|}

===‎‎<code>selectedValue</code>‎‎===
قيمة مطابقة لقيمة أحد العناصر. يمكن أن تكون سلسلة نصيّةً أو عددًا صحيحًا.
{| class="wikitable"
!النوع
!مطلوب
|-
|أي نوع
|لا
|}

===‎‎<code>style</code>‎‎===
{| class="wikitable"
!النوع
!مطلوب
|-
|pickerStyleType
|لا
|}

===‎‎<code>testID</code>‎‎===
يُستخدَم لتحديد موقع العرض هذا في الاختبارات الشاملة (end-to-end tests).
{| class="wikitable"
!النوع
!مطلوب
|-
|سلسلة نصية
|لا
|}

===‎‎<code>enabled</code>‎‎===
إذا كانت قيمتُها القيمةَ ‎‎<code>false</code>‎‎، فسيُعطَّل الانتقاء، أي أنّ المستخدم لن يستطيع التحديد.
{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|قيمة منطقيّة
|لا
|Android
|}

===‎‎<code>mode</code>‎‎===
على Android، تُحدِّد كيفيّة عرض عناصر التحديد عند نقر المستخدم على المنتقي:

* ‎‎<code>'dialog'</code>‎‎: إظهار مربّع حوار (modal dialog). هذه هي القيمة الافتراضيّة.
* ‎‎<code>'dropdown'</code>‎‎: عرض قائمة منسدلة مرتبطة بعرض المنتقي.

{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|‎‎<code>enum('dialog', 'dropdown')</code>‎‎
|لا
|Android
|}

===‎‎<code>prompt</code>‎‎===
سلسلة نصيّة تُمثِّل مَحثَّ (prompt) المنتقي، تُستخدَم على Android في وضع الحوار (dialog mode) كعنوان لمربّع الحوار.
{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|سلسلة نصية
|لا
|Android
|}

===‎‎<code>itemStyle</code>‎‎===
نمط لتطبيقه على كل تسميّة (label) من تسميات العناصر.
{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|أنماط النص (text styles)
|لا
|iOS
|}

== مصادر ==
* [https://facebook.github.io/react-native/docs/picker صفحة Picker في توثيق React Native الرسمي.]
[[تصنيف:ReactNative]]