الواجهة TimePickerAndroid في React Native

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

مهملة: استخدم إحدى الحزم من المجتمع بدلًا منها.

تفتح صندوق حوار مُنتقي الوقت (time picker) المعياريّ لمنصة Android.

مثال

try {
  const { action, hour, minute } = await TimePickerAndroid.open({
    hour: 14,
    minute: 0,
    is24Hour: false // Will display '2 PM'
  });
  if (action !== TimePickerAndroid.dismissedAction) {
    // Selected hour (0-23), minute (0-59)
  }
} catch ({ code, message }) {
  console.warn('Cannot open time picker', message);
}

التوابع

open()‎

static open(options)

يُستخدم هذا التّابع لفتح مُنتقي الوقت المعياريّ لمنصة Android.

المفاتيح المتوفرة للكائن options هي:

  • hour السّاعة: 0 - 23 إظهار السّاعة، افتراضيًّا الساعة الحاليّة.
  • minute الدّقائق: 0 - 59 إظهار الدّقيقة، افتراضيّا الدّقيقة الحاليّة.
  • is24Hour: قيمةٌ منطقيّةٌ (boolean) تُظهر الوقت بنظام 24 ساعة، إن كانت قيمتها true، وبنظام 12 ساعة، وإذا كانت قيمتها false، يظهرها المنتقي على شكل اختيار AM/PM. وإذا لم تعرّف يعتمد نظام التوقيت المحلّي.
  • mode (enum('clock', 'spinner', 'default'))‎: تحديد وضع منتقي الوقت:
    • 'clock': إظهار مُنتقي الوقت بوضع الساعة (clock)
    • 'spinner': إظهار مُنتقي الوقت بالوضع الدوار (spinner)
    • 'default': إظهار مُنتقي الوقت الافتراضي اعتمادًا على إصدار Android

يُعيد هذا التابع وعدًا (Promise)، والذي سيقبل إلى كائن يحوي المفاتيح action، وhour، وminute، إذا اختار المستخدم الوقت. أما إذا رفض المستخدم (dismiss) مربع الحوار فسيجعل الوعد قيمة المفتاح action مساوية TimePickerAndroid.dismissedAction؛ أما باقي المفاتيح، فلن تعرَّف، وسيتم دائما تفحص action قبل قراءة القيم.

timeSetAction()‎

static timeSetAction()

وتعني أنّه قد تمّ اختيار وقت.

dismissedAction()‎

static dismissedAction()

والمقصود منها انّه قد رُفضَ صندوق حوار مُنقي الوقت.

مصادر