الفرق بين المراجعتين لصفحة: «ReactNative/alert»

مراجعة 20:53، 13 ديسمبر 2019

يعرِض مربع حوارِ تنبيهٍ (alert dialog) بالعنوان والرسالة المحددين.

يُمكن اختياريًّا توفير قائمةٍ من الأزرار. يؤدي النقر فوق أي زر إلى إطلاق دالّةِ ردّ نداءِ ‎‎onPress‎‎ الخاصّة بالزر وإبعاد رسالة التنبيه. افتراضيًّا، سيكون زرُّ "OK" الزرَّ الوحيد.

هذه واجهة برمجة تطبيقاتٍ تعمل على كل من Android و iOS ويمكنُ لها إظهار تنبيهات ثابتة. لإظهار تنبيه يطالب المستخدم بإدخال معلومات، انظر ‎‎AlertIOS‎‎؛ إدخال النص في التنبيه أمر شائع على نظام iOS فقط.

مثال

iOS

على نظام iOS يمكنك تحديد أي عددٍ من الأزرار. يمكن لكل زر تحديد نمطٍ اختياريًا من القيم: ‎‎'default'‎‎، أو ‎‎'cancel'‎‎، أو ‎‎'destructive'‎‎.

Android

على Android، يمكن تحديد ثلاثة أزرار على الأكثر. في Android هناك مفهوم الزر المحايد (neutral) والسالب (neutral) والإيجابي (positive):

إذا حددت زرًا واحدًا، فسيكون الزر "الإيجابي" ("موافق" مثلًا).
تحديد زرّين يعني "سلبي"، و"إيجابي" ("إلغاء" و"موافق" مثلًا).
ثلاثة أزرار تعني "محايد"، و"سلبي"، و"إيجابي" ("لاحقًا"، و"إلغاء"، و"موافق" مثلًا).

افتراضيًّا، يمكن إبعاد التنبيهات على Android من خلال النقر خارج مربع التنبيه. يمكن معالجة هذا الحدث من خلال توفير مُعامل ‎‎options‎‎ اختياريّ، مع خاصية ردّ نداءٍ باسم ‎‎onDismiss‎‎ على الشكل ‎‎{ onDismiss: ( ) => {} }‎‎.

وكبديل، يمكن تعطيل سلوك إبعاد التنبيهات تمامًا من خلال توفير مُعامل ‎‎options‎‎ اختياريّ مع تعيين القيمة ‎‎false‎‎ للخاصية ‎‎cancelable‎‎‎‎، على الشكل ‎‎{ cancelable: false }‎‎.

مثال للاستخدام:

// يعمل على كل من
// Android و iOS
Alert.alert(
  'Alert Title',
  'My Alert Msg',
  [
    {text: 'Ask me later', onPress: () => console.log('Ask me later pressed')},
    {
      text: 'Cancel',
      onPress: () => console.log('Cancel Pressed'),
      style: 'cancel',
    },
    {text: 'OK', onPress: () => console.log('OK Pressed')},
  ],
  {cancelable: false},
);

التوابع

‎‎`alert()`‎‎

static alert(title, message?, buttons?, options? type?)

مصادر

صفحة Alert في توثيق React Native الرسمي.

@@ سطر 6: / سطر 6: @@
 هذه واجهة برمجة تطبيقاتٍ تعمل على كل من Android و iOS ويمكنُ لها إظهار تنبيهات ثابتة. لإظهار تنبيه يطالب المستخدم بإدخال معلومات، انظر ‎‎<code>AlertIOS</code>‎‎؛ إدخال النص في التنبيه أمر شائع على نظام iOS فقط.
 ==مثال==
-===iOS===
+==='''iOS'''===
-[exampleios.gif]
+[[ملف:exampleios.gif|مركز|لاإطار]]
 على نظام iOS يمكنك تحديد أي عددٍ من الأزرار. يمكن لكل زر تحديد نمطٍ اختياريًا من القيم: ‎‎<code>'default'</code>‎‎، أو ‎‎<code>'cancel'</code>‎‎، أو ‎‎<code>'destructive'</code>‎‎.
-===Android===
+==='''Android'''===
-[exampleandroid.gif]
+[[ملف:exampleandroid.gif|مركز|لاإطار]]
 على Android، يمكن تحديد ثلاثة أزرار على الأكثر. في Android هناك مفهوم الزر المحايد (neutral) والسالب (neutral) والإيجابي (positive):
 * إذا حددت زرًا واحدًا، فسيكون الزر "الإيجابي" ("موافق" مثلًا).
 * تحديد زرّين يعني "سلبي"، و"إيجابي" ("إلغاء" و"موافق" مثلًا).
 * ثلاثة أزرار تعني "محايد"، و"سلبي"، و"إيجابي" ("لاحقًا"، و"إلغاء"، و"موافق" مثلًا).
-افتراضيًّا، يمكن إبعاد التنبيهات على Android من خلال النقر خارج مربع التنبيه. يمكن معالجة هذا الحدث من خلال توفير مُعامل ‎‎<code>options</code>‎‎ اختياريّ، مع خاصية ردّ نداءٍ باسم ‎‎<code>onDismiss</code>‎‎ على الشكل ‎‎<code>{ onDismiss: () => {} }</code>‎‎.
+افتراضيًّا، يمكن إبعاد التنبيهات على Android من خلال النقر خارج مربع التنبيه. يمكن معالجة هذا الحدث من خلال توفير مُعامل ‎‎<code>options</code>‎‎ اختياريّ، مع خاصية ردّ نداءٍ باسم ‎‎<code>onDismiss</code>‎‎ على الشكل ‎‎<code>{ onDismiss: (</code>
+[[تصنيف:ReactNative]]
+<code>) => {} }</code>‎‎.
 وكبديل، يمكن تعطيل سلوك إبعاد التنبيهات تمامًا من خلال توفير مُعامل ‎‎<code>options</code>‎‎ اختياريّ مع تعيين القيمة ‎‎<code>false</code>‎‎ للخاصية ‎‎<code>cancelable</code>‎‎‎‎، على الشكل ‎‎<code>{ cancelable: false }</code>‎‎.
@@ سطر 49: / سطر 48: @@
 == مصادر ==
 * [https://facebook.github.io/react-native/docs/alert صفحة Alert في توثيق React Native الرسمي.]
-[[تصنيف:ReactNative]]