يوفر النموذج المنبثق ملاحظات بسيطة حول عملية ما في نافذة منبثقة صغيرة. فقط يملأ مقدار المساحة المطلوبة للرسالة والنشاط الحالي يظل مرئيًا وتفاعليًا. تختفي رسائل التنبيه التلقائي بعد انتهاء المهلة.
على سبيل المثال، يؤدي النقر على إرسال في رسالة إلكترونية إلى ظهور الرسالة "جارٍ إرسال رسالة...". على الشاشة، كما هو موضح في لقطة الشاشة التالية:
![صورة لجهاز Android تعرض قراءة لنافذة منبثقة نطاق وصول
"جارٍ إرسال الرسالة" بجانب رمز التطبيق](https://developer.android.com/static/images/toast.png?authuser=19&hl=ar)
إذا كان تطبيقك يستهدف Android 12 (المستوى 31 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث، يقتصر نطاق عمله على سطرين من النص وتعرض رمز التطبيق بجانب النص. انتبه إلى أن يختلف طول سطر هذا النص حسب حجم الشاشة، لذا من الجيد عمل النص قصير قدر الإمكان.
بدائل لاستخدام الخبز المحمص
إذا كان تطبيقك يعمل في المقدّمة، ننصحك باستخدام snackbar بدلاً من استخدام الخبز المحمّص. تتضمن أشرطة الإعلام السريعة خيارات قابلة للتنفيذ من قبل المستخدم، والتي يمكن أن توفر تطبيقًا أفضل المستخدم.
إذا كان التطبيق يعمل في الخلفية وأردت من المستخدمين اتخاذ بعض الإجراءات، استخدِم إشعار بدلاً من ذلك.
إنشاء مثيل كائن Toast
يمكنك استخدام
makeText()
على أن يأخذ المعاملين التاليين:
- النشاط
Context
- النص الذي يجب أن يظهر للمستخدم.
- المدة التي يجب أن يظل فيها الإشعار المنبثق على الشاشة.
تعرض الطريقة makeText()
كائن Toast
تم إعداده بشكل صحيح.
عرض الخبز المحمّص
لعرض الإشعار المنبثق، اطلب
show()
، كما هو موضح في
في المثال التالي:
Kotlin
val text = "Hello toast!" val duration = Toast.LENGTH_SHORT val toast = Toast.makeText(this, text, duration) // in Activity toast.show()
Java
CharSequence text = "Hello toast!"; int duration = Toast.LENGTH_SHORT; Toast toast = Toast.makeText(this /* MyActivity */, text, duration); toast.show();
تنفيذ سلسلة من استدعاءات طريقة الخبز المحمص
يمكنك ربط الطرق لتجنّب التمسك بكائن Toast
، كما هو موضّح
في مقتطف الرمز التالي:
Kotlin
Toast.makeText(context, text, duration).show()
Java
Toast.makeText(context, text, duration).show();