جزء اسنکبار به عنوان یک اعلان کوتاه عمل می کند که در پایین صفحه ظاهر می شود. این بازخورد در مورد یک عملیات یا اقدام بدون وقفه در تجربه کاربر ارائه می دهد. اسنک بارها پس از چند ثانیه ناپدید می شوند. کاربر همچنین می تواند با یک عمل، مانند ضربه زدن روی یک دکمه، آنها را رد کند.
این سه مورد استفاده را در نظر بگیرید که ممکن است از اسنک بار استفاده کنید:
- تأیید اقدام: پس از اینکه کاربر یک ایمیل یا پیام را حذف کرد، یک نوار اسنک برای تأیید عملکرد ظاهر می شود و گزینه «واگرد» را ارائه می دهد.
- وضعیت شبکه: هنگامی که برنامه اتصال اینترنت خود را قطع می کند، نوار اسنک ظاهر می شود تا متوجه شود که اکنون آفلاین است.
- ارسال دادهها: پس از ارسال موفقیتآمیز فرم یا بهروزرسانی تنظیمات، یک snackbar یادداشت میکند که تغییر با موفقیت ذخیره شده است.
سازگاری نسخه
این پیاده سازی مستلزم آن است که minSDK پروژه شما روی سطح API 21 یا بالاتر تنظیم شود.
وابستگی ها
یک اسنک بار اولیه ایجاد کنید
برای پیاده سازی نوار اسنک، ابتدا SnackbarHost
ایجاد می کنید که شامل یک ویژگی SnackbarHostState
است. SnackbarHostState
دسترسی به تابع showSnackbar()
را فراهم می کند که می توانید از آن برای نمایش نوار اسنک خود استفاده کنید.
این تابع تعلیق به CoroutineScope
مانند استفاده از rememberCoroutineScope
نیاز دارد - و می تواند در پاسخ به رویدادهای UI برای نشان دادن Snackbar
در Scaffold
فراخوانی شود.
با عمل یک اسنک بار بسازید
می توانید یک اقدام اختیاری ارائه دهید و مدت زمان Snackbar
را تنظیم کنید. تابع snackbarHostState.showSnackbar()
پارامترهای actionLabel
و duration
اضافی را می پذیرد و یک SnackbarResult
برمی گرداند.
می توانید یک Snackbar
سفارشی با پارامتر snackbarHost
تهیه کنید. برای اطلاعات بیشتر به اسناد مرجع SnackbarHost
API مراجعه کنید.
نتایج
مجموعه هایی که حاوی این راهنما هستند
این راهنما بخشی از مجموعههای راهنمای Quick Guide است که اهداف توسعه Android گستردهتری را پوشش میدهد:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=fa)