الواجهة 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()
والمقصود منها انّه قد رُفضَ صندوق حوار مُنقي الوقت.