جزء Chip
یک عنصر رابط کاربری فشرده و تعاملی است. این موجودات پیچیده مانند یک مخاطب یا برچسب، اغلب با یک نماد و برچسب را نشان می دهد. می تواند قابل بررسی، رد کردن یا کلیک کردن باشد.
پنج نوع تراشه و محل استفاده از آنها به شرح زیر است:
- Assist : کاربر را در طول یک کار راهنمایی می کند. اغلب به عنوان یک عنصر رابط کاربری موقت در پاسخ به ورودی کاربر ظاهر می شود.
- فیلتر : به کاربران امکان می دهد محتوا را از مجموعه ای از گزینه ها اصلاح کنند. آنها را می توان انتخاب کرد یا از حالت انتخاب خارج کرد، و ممکن است هنگام انتخاب یک نماد علامت چک داشته باشند.
- ورودی : اطلاعات ارائه شده توسط کاربر، مانند انتخاب های موجود در یک منو را نشان می دهد. آنها می توانند حاوی یک نماد و متن باشند و یک "X" برای حذف ارائه دهند.
- پیشنهاد : توصیه هایی را بر اساس فعالیت یا ورودی اخیر به کاربر ارائه می دهد. معمولاً در زیر یک فیلد ورودی ظاهر میشود تا اقدامات کاربر را درخواست کند.
- برافراشته : به جای صاف به نظر رسیدن ظاهری برجسته دارد.
سازگاری نسخه
این پیاده سازی مستلزم آن است که minSDK پروژه شما روی سطح API 21 یا بالاتر تنظیم شود.
وابستگی ها
یک تراشه کمکی ایجاد کنید
AssistChip
composable یک راه ساده برای ایجاد یک تراشه کمکی ارائه می دهد که کاربر را به یک جهت خاص هدایت می کند. یکی از ویژگی های متمایز، پارامتر leadingIcon
آن است که به شما امکان می دهد یک نماد را در سمت چپ تراشه نمایش دهید، همانطور که در شکل 1 نشان داده شده است. مثال زیر نشان می دهد که چگونه می توانید آن را پیاده سازی کنید:
![یک تراشه کمکی ساده](https://developer.android.com/static/develop/ui/compose/images/components/chip-assist.png?hl=fa)
یک تراشه فیلتر ایجاد کنید
قابلیت Composable FilterChip
از شما میخواهد ردیابی کنید که آیا تراشه انتخاب شده است یا خیر. مثال زیر نشان میدهد که چگونه میتوانید تنها زمانی که کاربر تراشه را انتخاب کرده باشد، یک نماد علامتدار اصلی را نشان دهید:
نتایج
![یک تراشه فیلتر انتخاب نشده، بدون چک و پسزمینه طرح.](https://developer.android.com/static/develop/ui/compose/images/components/chip-filter.png?hl=fa)
![تراشه فیلتر انتخابی، با چک و پسزمینه رنگی.](https://developer.android.com/static/develop/ui/compose/images/components/chip-filter-active.png?hl=fa)
یک تراشه ورودی ایجاد کنید
شما می توانید از InputChip
composable برای ایجاد تراشه هایی که از تعامل کاربر ایجاد می شود استفاده کنید. به عنوان مثال، در یک سرویس گیرنده ایمیل، زمانی که کاربر در حال نوشتن ایمیل است، یک تراشه ورودی ممکن است نشان دهنده شخصی باشد که کاربر آدرس او را در قسمت "to:" وارد کرده است.
پیاده سازی زیر یک تراشه ورودی را نشان می دهد که در حالت انتخابی قرار دارد. هنگامی که کاربر تراشه را فشار می دهد، آن را حذف می کند.
نتایج
![یک تراشه ورودی با یک آواتار و یک نماد انتهایی.](https://developer.android.com/static/develop/ui/compose/images/components/chip-input.png?hl=fa)
یک تراشه پیشنهاد ایجاد کنید
ترکیبپذیر SuggestionChip
اساسیترین ترکیبپذیر فهرستشده در این صفحه است، هم در تعریف API و هم در موارد استفاده رایج آن. تراشههای پیشنهاد نکاتی را ارائه میدهند که به صورت پویا تولید میشوند. به عنوان مثال، در یک برنامه چت هوش مصنوعی، ممکن است از تراشههای پیشنهاد برای ارائه پاسخهای احتمالی به جدیدترین پیام استفاده کنید.
این اجرای SuggestionChip
را در نظر بگیرید:
نتایج
![یک تراشه کمکی ساده](https://developer.android.com/static/develop/ui/compose/images/components/chip-suggestion.png?hl=fa)
یک تراشه مرتفع ایجاد کنید
همه نمونههای موجود در این سند از ترکیبهای پایه استفاده میکنند که ظاهری مسطح دارند. اگر تراشه ای می خواهید که ظاهری برجسته داشته باشد، از یکی از سه ترکیب زیر استفاده کنید:
نکات کلیدی
چهار کامپوزیشن با چهار نوع تراشه مطابقت دارند و پارامترهای زیر را به اشتراک می گذارند:
-
label
: رشته ای که روی تراشه ظاهر می شود. -
icon
: نمادی که در ابتدای تراشه نمایش داده می شود. برخی از composable ها دارای پارامترleadingIcon
وtrailingIcon
جداگانه هستند. -
onClick
: لامبدا که تراشه زمانی که کاربر روی آن کلیک میکند، آن را فراخوانی میکند.
مجموعه هایی که حاوی این راهنما هستند
این راهنما بخشی از مجموعههای راهنمای Quick Guide است که اهداف توسعه Android گستردهتری را پوشش میدهد:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=fa)