الفرق بين المراجعتين ل"ReactNative/datepickerandroid"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
سطر 25: سطر 25:
 
== التوابع ==
 
== التوابع ==
  
=== <code>open()</code> ===
+
=== ‪‪‎ === <code>open()</code>
 
<syntaxhighlight lang="javascript">
 
<syntaxhighlight lang="javascript">
 
static open(options)
 
static open(options)
سطر 44: سطر 44:
 
'''ملاحظة:''' هنالك بعض المشاكل في مربع حوار منتقي التّاريخ على منصّة Android في الإصدار 4 وما قبله، وذلك عند استخدام <code>minDate</code>، و<code>maxDate</code>.
 
'''ملاحظة:''' هنالك بعض المشاكل في مربع حوار منتقي التّاريخ على منصّة Android في الإصدار 4 وما قبله، وذلك عند استخدام <code>minDate</code>، و<code>maxDate</code>.
  
=== <code>dateSetAction()</code> ===
+
=== <code>dataSetAction()</code> ===
 +
 
 
<syntaxhighlight lang="javascript">
 
<syntaxhighlight lang="javascript">
 
static dateSetAction()
 
static dateSetAction()
 
</syntaxhighlight>اختير تاريخ.
 
</syntaxhighlight>اختير تاريخ.
  
===<code>dismissedAction()‎</code>===
+
=== <code>dismissedAction()‎</code> ===
 
<syntaxhighlight lang="javascript">
 
<syntaxhighlight lang="javascript">
 
static dismissedAction()
 
static dismissedAction()

مراجعة 10:55، 18 فبراير 2021

مهملة: يمكنك استخدام react-native-community/datetimepicker@ بدلًا منها.

تُستخدم 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()

رُفض مربع حوار منتقي التّاريخ.

مصادر