الفرق بين المراجعتين لصفحة: «ReactNative/timepickerandroid»
رقية-بورية (نقاش | مساهمات) ط مراجعة |
رقية-بورية (نقاش | مساهمات) ط مراجعة |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:TimePickerAndroid في React Native}}</noinclude> | <noinclude>{{DISPLAYTITLE:TimePickerAndroid في React Native}}</noinclude> | ||
<blockquote>'''مهملة:''' استخدم [ | <blockquote>'''مهملة:''' استخدم [https://github.com/react-native-datetimepicker/datetimepicker datetimepicker] بدلًا منها.</blockquote>تفتح صندوق حوار مُنتقي الوقت (time picker) المعياريّ لمنصة Android. | ||
__toc__ | __toc__ | ||
== مثال == | == مثال == | ||
| سطر 23: | سطر 23: | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
static open(options) | static open(options) | ||
</syntaxhighlight>يُستخدم هذا | </syntaxhighlight>يُستخدم هذا التّابع لفتح مُنتقي الوقت المعياريّ لمنصة Android. | ||
المفاتيح المتوفرة للكائن <code>options</code> هي: | المفاتيح المتوفرة للكائن <code>options</code> هي: | ||
* <code>hour</code> | * <code>hour</code> السّاعة: 0 - 23 إظهار السّاعة، افتراضيًّا الساعة الحاليّة. | ||
* <code>minute</code> | * <code>minute</code> الدّقائق: 0 - 59 إظهار الدّقيقة، افتراضيّا الدّقيقة الحاليّة. | ||
* <code>is24Hour</code>: قيمةٌ منطقيّةٌ (boolean) تُظهر الوقت بنظام 24 ساعة، إن كانت قيمتها <code>true</code>، وبنظام 12 ساعة، | * <code>is24Hour</code>: قيمةٌ منطقيّةٌ (boolean) تُظهر الوقت بنظام 24 ساعة، إن كانت قيمتها <code>true</code>، وبنظام 12 ساعة، وإذا كانت قيمتها <code>false</code>، يظهرها المنتقي على شكل اختيار AM/PM. وإذا لم تعرّف يعتمد نظام التوقيت المحلّي. | ||
* <code>mode (enum('clock', 'spinner', 'default'))</code>: تحديد وضع منتقي الوقت: | * <code>mode (enum('clock', 'spinner', 'default'))</code>: تحديد وضع منتقي الوقت: | ||
** 'clock': إظهار مُنتقي الوقت بوضع الساعة (clock) | ** 'clock': إظهار مُنتقي الوقت بوضع الساعة (clock) | ||
| سطر 40: | سطر 40: | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
static timeSetAction() | static timeSetAction() | ||
</syntaxhighlight>وتعني | </syntaxhighlight>وتعني أنّه قد تمّ اختيار وقت. | ||
=== <code>dismissedAction()</code> === | === <code>dismissedAction()</code> === | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
static dismissedAction() | static dismissedAction() | ||
</syntaxhighlight>والمقصود منها | </syntaxhighlight>والمقصود منها انّه قد رُفضَ صندوق حوار مُنقي الوقت. | ||
== مصادر == | == مصادر == | ||
مراجعة 14:25، 22 يناير 2021
مهملة: استخدم datetimepicker بدلًا منها.
تفتح صندوق حوار مُنتقي الوقت (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()
والمقصود منها انّه قد رُفضَ صندوق حوار مُنقي الوقت.