تراشه

مؤلفه Chip یک عنصر میانای کاربر فشرده و تعاملی است. این عنصر نشان‌دهنده نهادهای پیچیده مانند مخاطب یا برچسب است که اغلب با نماد و برچسب همراه است. می‌تواند قابل‌علامت‌گذاری، قابل‌بستن، یا قابل‌کلیک باشد.

چهار نوع تراشه و جاهایی که ممکن است از آن‌ها استفاده کنید به شرح زیر است:

  • کمک: کاربر را درطول تکلیف راهنمایی می‌کند. اغلب به‌عنوان عنصر میانای کاربر موقت در پاسخ به ورودی کاربر ظاهر می‌شود.
  • فیلتر: به کاربران امکان می‌دهد محتوا را از مجموعه‌ای از گزینه‌ها پالایش کنند. می‌توانند انتخاب یا لغو انتخاب شوند و ممکن است هنگام انتخاب شدن، نماد تیک داشته باشند.
  • ورودی: نشان‌دهنده اطلاعات ارائه‌شده توسط کاربر است، مانند انتخاب‌ها در یک منو. این اعلان‌ها می‌توانند حاوی نماد و نوشتار باشند و X برای برداشتن ارائه دهند.
  • پیشنهاد: براساس فعالیت یا ورودی اخیر کاربر، توصیه‌هایی به او ارائه می‌دهد. معمولاً زیر فیلد ورودی ظاهر می‌شود تا کنش‌های کاربر را درخواست کند.
نمونه‌ای از هریک از چهار مؤلفه تراشه، با ویژگی‌های منحصربه‌فرد آن‌ها برجسته شده است.
شکل ۱. چهار مؤلفه تراشه.

سطح میانای برنامه‌سازی کاربردی

چهار ترکیب‌پذیر وجود دارد که با چهار نوع تراشه مطابقت دارد. بخش‌های زیر این composableها و تفاوت‌های آن‌ها را به‌طور دقیق شرح می‌دهند. بااین‌حال، پارامترهای زیر را هم‌رسانی می‌کنند:

  • label: رشته‌ای که روی تراشه ظاهر می‌شود.
  • icon: نمادی که در ابتدای تراشه نمایش داده می‌شود. برخی‌از ترکیب‌پذیرهای خاص پارامتر leadingIcon و trailingIcon جداگانه‌ای دارند.
  • ‫onClick: لامبدایی که تراشه هنگام فشار دادن آن توسط کاربر فراخوانی می‌کند.

تراشه دستیار

AssistChip ترکیب‌پذیر راهی ساده برای ایجاد تراشه کمکی ارائه می‌دهد که کاربر را به سمت خاصی هدایت می‌کند. یکی از ویژگی‌های متمایزکننده آن پارامتر leadingIcon است که به شما امکان می‌دهد نمادی را در سمت چپ تراشه نمایش دهید. مثال زیر نشان می‌دهد که چگونه می‌توانید آن را پیاده‌سازی کنید:

@Composable
fun AssistChipExample() {
    AssistChip(
        onClick = { Log.d("Assist chip", "hello world") },
        label = { Text("Assist chip") },
        leadingIcon = {
            Icon(
                painter = rememberVectorPainter(AppIcons.Settings),
                contentDescription = "Localized description",
                Modifier.size(AssistChipDefaults.IconSize)
            )
        }
    )
}

این پیاده‌سازی به‌صورت زیر نشان داده می‌شود.

شکل ۲. تراشه کمکی.

تراشه فیلتر

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

@Composable
fun FilterChipExample() {
    var selected by remember { mutableStateOf(false) }

    FilterChip(
        onClick = { selected = !selected },
        label = {
            Text("Filter chip")
        },
        selected = selected,
        leadingIcon = if (selected) {
            {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Done),
                    contentDescription = "Done icon",
                    modifier = Modifier.size(FilterChipDefaults.IconSize)
                )
            }
        } else {
            null
        },
    )
}

این پیاده‌سازی هنگام انتخاب به‌صورت زیر نمایش داده می‌شود:

شکل ۳. تراشه فیلتر انتخاب‌شده.

تراشه ورودی

می‌توانید از ترکیب‌پذیر InputChip برای ایجاد تراشه‌هایی که از تعامل کاربر حاصل می‌شوند استفاده کنید. برای مثال، در کارخواه ایمیل، وقتی کاربر درحال نوشتن ایمیل است، تراشه ورودی ممکن است نشان‌دهنده مخاطبی باشد که کاربر به فیلد «به:» اضافه کرده است.

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

@Composable
fun InputChipExample(
    text: String,
    onDismiss: () -> Unit,
) {
    var enabled by remember { mutableStateOf(true) }
    if (!enabled) return

    InputChip(
        onClick = {
            onDismiss()
            enabled = !enabled
        },
        label = { Text(text) },
        selected = enabled,
        avatar = {
            Icon(
                painter = rememberVectorPainter(AppIcons.Person),
                contentDescription = "Localized description",
                Modifier.size(InputChipDefaults.AvatarSize)
            )
        },
        trailingIcon = {
            Icon(
                painter = rememberVectorPainter(AppIcons.Close),
                contentDescription = "Localized description",
                Modifier.size(InputChipDefaults.AvatarSize)
            )
        },
    )
}

این پیاده‌سازی به‌صورت زیر نشان داده می‌شود.

شکل ۴. تراشه ورودی.

تراشه پیشنهاد

SuggestionChip composable ابتدایی‌ترین composable فهرست‌شده در این صفحه است، هم ازنظر تعریف API و هم ازنظر موارد استفاده رایج آن. تراشه‌های پیشنهاد، نکته‌های تولیدشده به‌صورت پویا را ارائه می‌دهند. برای مثال، در برنامه گپ هوش مصنوعی، می‌توانید از تراشه‌های پیشنهادی برای ارائه پاسخ‌های احتمالی به جدیدترین پیام استفاده کنید.

این پیاده‌سازی SuggestionChip را درنظر بگیرید:

@Composable
fun SuggestionChipExample() {
    SuggestionChip(
        onClick = { Log.d("Suggestion chip", "hello world") },
        label = { Text("Suggestion chip") }
    )
}

این پیاده‌سازی به‌صورت زیر نشان داده می‌شود:

شکل ۵. تراشه پیشنهاد.

تراشه برجسته

همه مثال‌های این سند از ترکیب‌پذیرهای پایه‌ای استفاده می‌کنند که ظاهر تخت دارند. اگر می‌خواهید تراشه‌ای با ظاهر برجسته داشته باشید، از یکی از سه ترکیب‌پذیر زیر استفاده کنید:

به‌روزرسانی M3 Expressive

تراشه‌های فیلتر و ورودی دارای به‌روزرسانی‌های سبکی هستند، ازجمله افزایش شعاع گوشه و حرکت فنری. تراشه‌های «دستیار» و پیشنهاد در دکمه‌های گویا ادغام شده‌اند.

برای اطلاعات بیشتر درباره به‌روزرسانی‌های M3 Expressive برای تراشه‌ها، به رهنمودهای تراشه‌های Material Design 3 مراجعه کنید.

تغییر تدریجی گوشه

تراشه‌های فیلتر و ورودی از دگرگونی گوشه پشتیبانی می‌کنند و شعاع گوشه محفظه را از ۱۲dp در حالت لغو انتخاب‌شده به کاملاً گرد در حالت انتخاب‌شده پویانمایی می‌کنند.

فیلتر کردن

قطعه کد زیر نحوه پیاده‌سازی تراشه فیلتر با دگرگونی گوشه را نشان می‌دهد:

@Composable
fun FilterChipWithCornerMorphingSample() {
    var selected by remember { mutableStateOf(false) }
    FilterChip(
        selected = selected,
        onClick = { selected = !selected },
        label = { Text("Filter chip") },
        shapes = FilterChipDefaults.shapes(),
        leadingIcon = if (selected) {
            {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Done),
                    contentDescription = null,
                    modifier = Modifier.size(FilterChipDefaults.IconSize),
                )
            }
        } else {
            null
        },
    )
}

فیلتر بالاآمده

تراشه‌های فیلتر برجسته از پس‌زمینه برجسته بصری جدا می‌شوند و از تغییر شکل گوشه پشتیبانی می‌کنند. قطعه کد زیر نشان می‌دهد چگونه یک تراشه فیلتر برجسته با تغییر شکل گوشه پیاده‌سازی کنید:

@Composable
fun ElevatedFilterChipWithCornerMorphingSample() {
    var selected by remember { mutableStateOf(false) }
    ElevatedFilterChip(
        selected = selected,
        onClick = { selected = !selected },
        label = { Text("Filter chip") },
        shapes = FilterChipDefaults.shapes(),
        leadingIcon = if (selected) {
            {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Done),
                    contentDescription = null,
                    modifier = Modifier.size(FilterChipDefaults.IconSize),
                )
            }
        } else {
            {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Home),
                    contentDescription = null,
                    modifier = Modifier.size(FilterChipDefaults.IconSize),
                )
            }
        },
        trailingIcon = {
            Icon(
                painter = rememberVectorPainter(AppIcons.ArrowDropDown),
                contentDescription = null,
                modifier = Modifier.size(FilterChipDefaults.IconSize),
            )
        },
    )
}

ورودی

تراشه‌های ورودی نشان‌دهنده بخش‌های مجزایی از اطلاعات واردشده توسط کاربر هستند و از دگرگونی گوشه نیز پشتیبانی می‌کنند. قطعه کد زیر نحوه پیاده‌سازی تراشه ورودی با تغییر شکل گوشه را نشان می‌دهد:

@Composable
fun InputChipWithCornerMorphingSample() {
    var selected by remember { mutableStateOf(false) }
    InputChip(
        selected = selected,
        onClick = { selected = !selected },
        label = { Text("Input Chip") },
        shapes = InputChipDefaults.shapes(),
        avatar = {
            Icon(
                painter = rememberVectorPainter(AppIcons.Person),
                contentDescription = null,
                modifier = Modifier.size(InputChipDefaults.AvatarSize),
            )
        },
    )
}

تراشه‌های دستیار و پیشنهاد

تراشه‌های کمکی و پیشنهادی در Material 3 در دکمه‌های گویا ادغام شده‌اند گویا هستند چون ازنظر عملکردی رفتارهای دکمه تک‌کنشی را منعکس می‌کنند. وقتی به کمک بیانی یا رفتار تراشه پیشنهاد نیاز دارید، از دکمه‌های بیانی استفاده کنید؛ برای جزئیات پیاده‌سازی، به سند Buttons مراجعه کنید.

منابع بیشتر