نمای کلی پیام‌های زودگذر

اعلان موقت بازخورد ساده‌ای درباره عملیات در بالاپر کوچکی ارائه می‌دهد. این اعلان فقط به‌اندازه فضای موردنیاز برای پیام باز می‌شود و فعالیت فعلی همچنان قابل‌مشاهده و تعاملی باقی می‌ماند. اعلان‌های زودگذر پس‌از اتمام مهلت به‌طور خودکار ناپدید می‌شوند.

برای مثال، کلیک کردن روی ارسال در ایمیل، اعلان گذرا «درحال ارسال پیام…» را راه‌اندازی می‌کند، همان‌طور که در نماگرفت زیر نشان داده شده است:

تصویر دستگاه Android که بالاپر موقتی را نشان می‌دهد که در آن نوشته شده است
            «درحال ارسال پیام» در کنار نماد برنامه

اگر برنامه شما Android 12 (سطح میانای برنامه‌سازی کاربردی ۳۱) یا بالاتر را هدف قرار می‌دهد، پیام موقت آن به دو خط نوشتار محدود می‌شود و نماد برنامه را در کنار نوشتار نشان می‌دهد. توجه داشته باشید که طول خط این نوشتار بسته به اندازه صفحه‌نمایش متفاوت است، بنابراین بهتر است نوشتار را تا حد امکان کوتاه کنید.

جایگزین‌های استفاده از نان برشته

اگر برنامه‌تان در پیش‌زمینه است، به‌جای استفاده از اعلان موقت، از نوار میان‌وعده استفاده کنید. نوار توضیحات شامل گزینه‌هایی است که کاربر می‌تواند روی آن‌ها کنش انجام دهد و این گزینه‌ها می‌توانند تجربه برنامه بهتری ارائه دهند.

اگر برنامه‌تان در پس‌زمینه است و می‌خواهید کاربران اقدامی انجام دهند، به‌جای آن از اعلان استفاده کنید.

نمونه‌سازی شیء Toast

از روش makeText() استفاده کنید که پارامترهای زیر را می‌گیرد:

  1. فعالیت Context.
  2. نوشتاری که باید به کاربر نشان داده شود.
  3. مدت زمانی که اعلان موقت باید روی صفحه باقی بماند.

روش makeText() یک شیء Toast را که به‌درستی مقداردهی اولیه شده است برمی‌گرداند.

نمایش اعلان زودگذر

برای نمایش اعلان موقت، متد show() را فراخوانی کنید، همان‌طور که در مثال زیر نشان داده شده است:

کاتلین

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 جلوگیری کنید، همان‌طور که در تکه‌کد زیر نشان داده شده است:

کاتلین

Toast.makeText(context, text, duration).show()

جاوا

Toast.makeText(context, text, duration).show();