الفرق بين المراجعتين لصفحة: «ReactNative/datepickerandroid»
رقية-بورية (نقاش | مساهمات) |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:DatePickerAndroid في React Native}}</noinclude> | <noinclude>{{DISPLAYTITLE:المكون DatePickerAndroid في React Native}}</noinclude> | ||
<blockquote>'''مهملة | <blockquote>'''مهملة''': استعمل إحدى [https://reactnative.directory/?search=datepicker الحزم من المجتمع] بدلًا عنها.</blockquote>تُستخدم <code>DatePickerAndroid</code> لإظهار مُنتقي التّاريخ (date picker) المعياريّ على منصّة Android. | ||
__toc__ | __toc__ | ||
== مثال == | == مثال == | ||
| سطر 40: | سطر 40: | ||
** <code>'default'</code> : إظهار مُنتقي التّاريخ بالوضع الافتراضيّ الموافق لإصدار Android. | ** <code>'default'</code> : إظهار مُنتقي التّاريخ بالوضع الافتراضيّ الموافق لإصدار Android. | ||
يُعيد هذه التّابع وعدًا (Promise) يُقبل ككائنٍ يحوي المفاتيح <code>action</code>، و<code>year</code>، و<code>month</code> (0-11)، و<code>day</code> إذا اختار المستخدم تاريخًا، أو يُقبل بجعل قيمة المفتاح action مساوية لـ <code>DateePickerAndroid. | يُعيد هذه التّابع وعدًا (Promise) يُقبل ككائنٍ يحوي المفاتيح <code>action</code>، و<code>year</code>، و<code>month</code> (0-11)، و<code>day</code> إذا اختار المستخدم تاريخًا، أو يُقبل بجعل قيمة المفتاح action مساوية لـ <code>DateePickerAndroid.dismissedAction</code>، وبعدم تعريف باقي المفاتيح إذا رُفض (dismiss) مربّع الحوار، ويتفحّص هذا التّابع '''دائمًا'''، أن <code>action</code> يساوي <code>DatePickerAndroid.dateSetAction</code> قبل قراءة القيم. | ||
'''ملاحظة:''' هنالك بعض المشاكل في مربع حوار منتقي التّاريخ على منصّة Android في الإصدار 4 وما قبله، وذلك عند استخدام <code>minDate</code>، و<code>maxDate</code>. | '''ملاحظة:''' هنالك بعض المشاكل في مربع حوار منتقي التّاريخ على منصّة Android في الإصدار 4 وما قبله، وذلك عند استخدام <code>minDate</code>، و<code>maxDate</code>. | ||
=== <code>() | === <code>dataSetAction()</code> === | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
static dateSetAction() | static dateSetAction() | ||
| سطر 59: | سطر 58: | ||
* [https://facebook.github.io/react-native/docs/datepickerandroid صفحة DatePickerAndroid في توثيق React Native الرسميّ] | * [https://facebook.github.io/react-native/docs/datepickerandroid صفحة DatePickerAndroid في توثيق React Native الرسميّ] | ||
[[تصنيف:ReactNative]] | [[تصنيف:ReactNative]] | ||
[[تصنيف:React Native Component]] | |||
المراجعة الحالية بتاريخ 15:14، 9 أكتوبر 2021
مهملة: استعمل إحدى الحزم من المجتمع بدلًا عنها.
تُستخدم DatePickerAndroid لإظهار مُنتقي التّاريخ (date picker) المعياريّ على منصّة Android.
مثال
try {
const {
action,
year,
month,
day
} = await DatePickerAndroid.open({
// Use `new Date()` for current date.
// May 25 2020. Month 0 is January.
date: new Date(2020, 4, 25)
});
if (action !== DatePickerAndroid.dismissedAction) {
// Selected year, month (0-11), day
}
} catch ({ code, message }) {
console.warn('Cannot open date picker', message);
}
التوابع
open()
static open(options)
يفتح مربع حوار منتقي التّاريخ المعياري لمنصّة Android.
المفاتيح المتاحة للكائن options:
date(كائنDate، أو طابع زمنيّ (timestamp) بالميلي ثانية): التّاريخ الذي سيظهر افتراضيًّا.minDate(كائنDate،أو طابع زمني بالميلي ثانية): أدنى تاريخ يمكن اختياره.maxDate(كائنDate، أو طابع زمني بالميلي ثانية): أعلى تاريخ يمكن اختياره.mode(قيمة متعدّدةenum('calendar', 'spinner', 'default')): لتحديد وضع منتقي التّاريخ من الأوضاع التّالية:'calendar': إظهار مُنتقي التّاريخ بوضع التّقويم (calendar).'spinner': إظهار مُنتقي التّاريخ بالوضع الدوّار (spinner).'default': إظهار مُنتقي التّاريخ بالوضع الافتراضيّ الموافق لإصدار Android.
يُعيد هذه التّابع وعدًا (Promise) يُقبل ككائنٍ يحوي المفاتيح action، وyear، وmonth (0-11)، وday إذا اختار المستخدم تاريخًا، أو يُقبل بجعل قيمة المفتاح action مساوية لـ DateePickerAndroid.dismissedAction، وبعدم تعريف باقي المفاتيح إذا رُفض (dismiss) مربّع الحوار، ويتفحّص هذا التّابع دائمًا، أن action يساوي DatePickerAndroid.dateSetAction قبل قراءة القيم.
ملاحظة: هنالك بعض المشاكل في مربع حوار منتقي التّاريخ على منصّة Android في الإصدار 4 وما قبله، وذلك عند استخدام minDate، وmaxDate.
dataSetAction()
static dateSetAction()
اختير تاريخ.
dismissedAction()
static dismissedAction()
رُفض مربع حوار منتقي التّاريخ.