يقدّم النخب ملاحظات بسيطة حول عملية في نافذة منبثقة صغيرة. فهو يملأ فقط مقدار المساحة المطلوبة للرسالة ويظل النشاط الحالي مرئيًا وتفاعليًا. تختفي إشعارات الخبز المحمص تلقائيًا بعد انتهاء المهلة.
على سبيل المثال، يؤدي النقر على إرسال في إحدى الرسائل الإلكترونية إلى ظهور إشعار منبثق بعنوان "إرسال رسالة..."، كما هو موضح في لقطة الشاشة التالية:

إذا كان تطبيقك يستهدف نظام التشغيل Android 12 (المستوى 31 لواجهة برمجة التطبيقات) أو إصدارًا أحدث، سيقتصر عرض النص على سطرين من النص وسيعرض رمز التطبيق بجانب النص. انتبه إلى أن طول سطر هذا النص يختلف حسب حجم الشاشة، لذلك من الجيد جعل النص قصيرًا قدر الإمكان.
بدائل لاستخدام الخبز المحمص
إذا كان تطبيقك يعمل في المقدّمة، يمكنك استخدام snackbar بدلاً من استخدام نخب. تتضمن Snackbar خيارات قابلة للتنفيذ من قِبل المستخدم، والتي يمكن أن توفر تجربة أفضل للتطبيق.
إذا كان تطبيقك يعمل في الخلفية وكنت تريد من المستخدمين اتّخاذ إجراء، يمكنك استخدام إشعار بدلاً من ذلك.
إنشاء مثيل من كائن نخب
استخدِم الطريقة
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()
جافا
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()
جافا
Toast.makeText(context, text, duration).show();