الفرق بين المراجعتين لصفحة: «ReactNative/timepickerandroid»
رقية-بورية (نقاش | مساهمات) ط مراجعة |
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:TimePickerAndroid في React Native}}</noinclude> | <noinclude>{{DISPLAYTITLE:الواجهة TimePickerAndroid في React Native}}</noinclude> | ||
<blockquote>'''مهملة:''' استخدم [ | <blockquote>'''مهملة:''' استخدم إحدى [https://reactnative.directory/?search=timepicker الحزم من المجتمع] بدلًا منها.</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) | ** <code>'clock'</code>: إظهار مُنتقي الوقت بوضع الساعة (clock) | ||
** 'spinner': إظهار مُنتقي الوقت بالوضع الدوار (spinner) | ** <code>'spinner'</code>: إظهار مُنتقي الوقت بالوضع الدوار (spinner) | ||
** 'default': إظهار مُنتقي الوقت الافتراضي اعتمادًا على إصدار Android | ** <code>'default'</code>: إظهار مُنتقي الوقت الافتراضي اعتمادًا على إصدار Android | ||
يُعيد هذا التابع وعدًا (Promise)، والذي سيقبل إلى كائن يحوي المفاتيح <code>action</code>، و<code>hour</code>، و<code>minute</code>، إذا اختار المستخدم الوقت. أما إذا رفض المستخدم (dismiss) مربع الحوار فسيجعل الوعد قيمة المفتاح <code>action</code> مساوية <code>TimePickerAndroid.dismissedAction</code>؛ أما باقي المفاتيح، فلن تعرَّف، وسيتم دائما تفحص <code>action</code> قبل قراءة القيم. | يُعيد هذا التابع وعدًا (Promise)، والذي سيقبل إلى كائن يحوي المفاتيح <code>action</code>، و<code>hour</code>، و<code>minute</code>، إذا اختار المستخدم الوقت. أما إذا رفض المستخدم (dismiss) مربع الحوار فسيجعل الوعد قيمة المفتاح <code>action</code> مساوية <code>TimePickerAndroid.dismissedAction</code>؛ أما باقي المفاتيح، فلن تعرَّف، وسيتم دائما تفحص <code>action</code> قبل قراءة القيم. | ||
| سطر 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>والمقصود منها انّه قد رُفضَ صندوق حوار مُنقي الوقت. | ||
== مصادر == | == مصادر == | ||
| سطر 51: | سطر 51: | ||
* [https://facebook.github.io/react-native/docs/timepickerandroid صفحة timePickerAndroid في توثيق React Native الرسميّ] | * [https://facebook.github.io/react-native/docs/timepickerandroid صفحة timePickerAndroid في توثيق React Native الرسميّ] | ||
[[تصنيف:ReactNative]] | [[تصنيف:ReactNative]] | ||
[[تصنيف:React Native API]] | |||
المراجعة الحالية بتاريخ 15:18، 9 أكتوبر 2021
مهملة: استخدم إحدى الحزم من المجتمع بدلًا منها.
تفتح صندوق حوار مُنتقي الوقت (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()
والمقصود منها انّه قد رُفضَ صندوق حوار مُنقي الوقت.