الفرق بين المراجعتين ل"ReactNative/timepickerandroid"
اذهب إلى التنقل
اذهب إلى البحث
رقية-بورية (نقاش | مساهمات) (أنشأ الصفحة ب'= TimePickerAndroid = <blockquote>'''مهملة:''' استخدم [https://github.com/react-native-community/react-native-datetimepicker @react-native-community/datetimep...') |
رقية-بورية (نقاش | مساهمات) ط (مراجعة) |
||
| سطر 1: | سطر 1: | ||
| − | + | <noinclude>{{DISPLAYTITLE:TimePickerAndroid في React Native}}</noinclude> | |
| − | <blockquote>'''مهملة:''' استخدم [ | + | <blockquote>'''مهملة:''' استخدم [[react native/datetimepicker|datetimepicker]] بدلًا منها.</blockquote>تفتح صندوق حوار مُنتقي الوقت (time picker) المعياريّ لمنصة Android. |
| − | + | __toc__ | |
== مثال == | == مثال == | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| سطر 23: | سطر 23: | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
static open(options) | static open(options) | ||
| − | </syntaxhighlight>يُستخدم لفتح مُنتقي الوقت المعياريّ لمنصة Android. | + | </syntaxhighlight>يُستخدم هذا التابع لفتح مُنتقي الوقت المعياريّ لمنصة Android. |
المفاتيح المتوفرة للكائن <code>options</code> هي: | المفاتيح المتوفرة للكائن <code>options</code> هي: | ||
| − | * <code>hour</code> الساعة : 0 - 23 إظهار الساعة، افتراضيّا الساعة الحاليّة. | + | * <code>hour</code> الساعة: 0 - 23 إظهار الساعة، افتراضيّا الساعة الحاليّة. |
* <code>minute</code> الدقائق: 0 - 59 إظهار الدقيقة، افتراضيّا الدّقيقة الحاليّة. | * <code>minute</code> الدقائق: 0 - 59 إظهار الدقيقة، افتراضيّا الدّقيقة الحاليّة. | ||
| − | * <code>is24Hour</code>: قيمةٌ منطقيّةٌ (boolean) تُظهر الوقت بنظام 24 | + | * <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) | ||
| سطر 35: | سطر 35: | ||
** 'default': إظهار مُنتقي الوقت الافتراضي اعتمادًا على إصدار Android | ** 'default': إظهار مُنتقي الوقت الافتراضي اعتمادًا على إصدار Android | ||
| − | يُعيد هذا التابع وعدًا (Promise) والذي سيقبل إلى كائن يحوي المفاتيح <code>action</code> و <code>hour</code> و<code>minute</code> إذا اختار المستخدم الوقت. أما إذا رفض المستخدم (dismiss) مربع الحوار فسيجعل الوعد قيمة المفتاح <code>action</code> مساوية <code>TimePickerAndroid.dismissedAction</code> | + | يُعيد هذا التابع وعدًا (Promise)، والذي سيقبل إلى كائن يحوي المفاتيح <code>action</code>، و<code>hour</code>، و<code>minute</code>، إذا اختار المستخدم الوقت. أما إذا رفض المستخدم (dismiss) مربع الحوار فسيجعل الوعد قيمة المفتاح <code>action</code> مساوية <code>TimePickerAndroid.dismissedAction</code>؛ أما باقي المفاتيح، فلن تعرَّف، وسيتم دائما تفحص <code>action</code> قبل قراءة القيم. |
=== <code>timeSetAction()</code> === | === <code>timeSetAction()</code> === | ||
<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>والمقصود منها انه قد رُفضَ صندوق حوار مُنقي الوقت. |
== مصادر == | == مصادر == | ||
* [https://facebook.github.io/react-native/docs/timepickerandroid صفحة timePickerAndroid في توثيق React Native الرسميّ] | * [https://facebook.github.io/react-native/docs/timepickerandroid صفحة timePickerAndroid في توثيق React Native الرسميّ] | ||
| + | [[تصنيف:ReactNative]] | ||
مراجعة 07:04، 7 يناير 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()
والمقصود منها انه قد رُفضَ صندوق حوار مُنقي الوقت.