يمكنك استخدام
من Snackbar
إلى
عرض رسالة قصيرة للمستخدم. إلغاء الإعجاب
الإشعارات
ستختفي تلقائيًا بعد فترة قصيرة. Snackbar
هو
وهي مثالية للرسائل الموجزة التي لا يحتاج المستخدم إلى اتخاذ إجراء بشأنها. على سبيل المثال،
يمكن أن يستخدم تطبيق البريد الإلكتروني Snackbar
لإعلام المستخدم بأنّ التطبيق
تم إرسال رسالة إلكترونية بنجاح.
استخدام CoordinatorLayout
يتم إرفاق Snackbar
بأحد العرض. Snackbar
الوظائف الأساسية إذا كانت مرتبطة بأي كائن مشتق من
صف واحد (View
)، مثل
لأي من كائنات التخطيط الشائعة. ومع ذلك، إذا كانت Snackbar
مرفق بـ
CoordinatorLayout
,
يكتسب Snackbar
ميزات إضافية:
- يمكن للمستخدم إغلاق "
Snackbar
" من خلال تمريره جانبًا بسرعة. - ينقل التنسيق عناصر واجهة المستخدم الأخرى عند ظهور
Snackbar
. على سبيل المثال، إذا كان التخطيط يحتوي علىFloatingActionButton
, ينقل التنسيق الزرّ للأعلى عندما يعرضSnackbar
، بدلاً من ذلك من رسمSnackbar
أعلى الزر. يمكنك الاطّلاع على كيفية هذا يبدو في الشكل 1.
توفّر الفئة CoordinatorLayout
مجموعة رئيسية من
وظيفة
FrameLayout
إذا كان تطبيقك يستخدم FrameLayout
، يمكنك استبدال هذا التنسيق.
باستخدام CoordinatorLayout
لتفعيل واجهة Snackbar
الكاملة
الأخرى. إذا كان تطبيقك يستخدم عناصر تنسيق أخرى، يمكنك التفاف التنسيق الحالي.
من العناصر في CoordinatorLayout
، كما هو موضح في ما يلي
مثال:
<android.support.design.widget.CoordinatorLayout android:id="@+id/myCoordinatorLayout" xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <!-- Here are the existing layout elements, now wrapped in a CoordinatorLayout. --> <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"> <!-- ...Toolbar, other layouts, other elements... --> </LinearLayout> </android.support.design.widget.CoordinatorLayout>
اضبط علامة android:id
لـ CoordinatorLayout
.
تحتاج إلى معرّف التنسيق عند عرض الرسالة.
الشكل 1. يعمل CoordinatorLayout
على تحريك
FloatingActionButton
لأعلى عند ظهور Snackbar
.
عرض رسالة
هناك خطوتان لعرض الرسالة. أولاً، تقوم بإنشاء
الكائن Snackbar
الذي يحتوي على نص الرسالة. ثم تقوم باستدعاء دالة الرسم
show()
لعرض الرسالة للمستخدم.
إنشاء كائن Snackbar
يمكنك إنشاء كائن Snackbar
من خلال استدعاء الدالة الثابتة
Snackbar.make()
. عند إنشاء "Snackbar
"، حدِّد الرسالة التي تريد استخدامها
المدة التي يتم خلالها عرض الرسالة ومدة عرضها:
Kotlin
val mySnackbar = Snackbar.make(view, stringId, duration)
Java
Snackbar mySnackbar = Snackbar.make(view, stringId, duration);
- عرض
-
العرض المطلوب إرفاق
Snackbar
به. تبحث الطريقة عن العرض الهرمي من طريقة العرض التي تم تمريرها إلى أن يتم الوصول إلىCoordinatorLayout
أو طريقة عرض محتوى ديكور النافذة. في العادة، من الأسهل تجاوزCoordinatorLayout
. لتضمين المحتوى الخاص بك. - رقم تعريف السلسلة
- رقم تعريف المصدر للرسالة التي تريد عرضها. يمكن تنسيق هذا أو أو نص غير منسق.
- المدة
-
المدة الزمنية لعرض الرسالة. يمكن أن تظهر فائدة هذا بوضوح أكبر
LENGTH_SHORT
أوLENGTH_LONG
عرض الرسالة للمستخدم
بعد إنشاء Snackbar
، يمكنك طلب show()
.
طريقة لعرض Snackbar
للمستخدم:
Kotlin
mySnackbar.show()
Java
mySnackbar.show();
لا يعرض النظام عدة عناصر Snackbar
في الوقت نفسه.
الوقت، لذا إذا كانت طريقة العرض تعرض حاليًا Snackbar
آخر، سيتم
يضع النظام Snackbar
في قائمة الانتظار ويعرضه بعد
تنتهي صلاحية "Snackbar
" أو يتم إغلاقها.
إذا كنت تريد عرض رسالة للمستخدم ولا تحتاج إلى الاتصال بأي من
Snackbar
، فليس عليك الاحتفاظ بـ
الإشارة إلى Snackbar
بعد طلب show()
. بالنسبة
ولهذا السبب، من الشائع استخدام تسلسل الطرق لإنشاء
Snackbar
في عبارة واحدة:
Kotlin
Snackbar.make( findViewById(R.id.myCoordinatorLayout), R.string.email_sent, Snackbar.LENGTH_SHORT ).show()
Java
Snackbar.make(findViewById(R.id.myCoordinatorLayout), R.string.email_sent, Snackbar.LENGTH_SHORT) .show();