Чип

Компонент Chip – это компактный интерактивный элемент интерфейса. Он представляет сложные объекты, такие как контакт или тег, часто со значком и меткой. Его можно отметить, закрыть или нажать.

Ниже описаны четыре типа чипов и способы их использования.

  • Помощь. Помогает пользователю выполнить задачу. Часто появляется как временный элемент интерфейса в ответ на действия пользователя.
  • Фильтр. Позволяет пользователям уточнять контент, выбирая из набора вариантов. Их можно выбрать или отменить выбор, и они могут включать значок галочки при выборе.
  • Ввод. Представляет информацию, предоставленную пользователем, например выбранные пункты меню. Они могут содержать значок и текст, а также X для удаления.
  • Подсказка. Предоставляет пользователю рекомендации на основе его недавних действий или введенных данных. Обычно они появляются под полем ввода, чтобы побудить пользователя к действию.
Пример каждого из четырех компонентов чипа с выделенными уникальными характеристиками.
Рисунок 1. Четыре компонента чипа.

API surface

Существует четыре composable-функции, которые соответствуют четырем типам фишек. В следующих разделах подробно описаны эти составные элементы и их различия. Однако у них есть следующие общие параметры:

  • label – строка, которая появляется на чипе.
  • icon – значок, который показывается в начале чипа. Некоторые составные элементы имеют отдельные параметры leadingIcon и trailingIcon.
  • onClick – лямбда-выражение, которое вызывается при нажатии на чип.

Чип Assist

Composable-функция 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)
            )
        }
    )
}

Вот как это выглядит:

Рисунок 2. чип Assist.

Примененный фильтр

Для composable-функции 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
        },
    )
}

При выборе этого варианта реализация выглядит следующим образом:

Рисунок 3. Выбранный фильтр.

Чип ввода

Для создания чипов, которые появляются в результате действий пользователя, можно использовать composable-функцию 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)
            )
        },
    )
}

Вот как это выглядит:

Рисунок 4. чип ввода.

Вариант запроса

SuggestionChip – самая простая composable-функция из перечисленных на этой странице, как по определению API, так и по распространенным вариантам использования. Чипы подсказок представляют собой динамически генерируемые подсказки. Например, в приложении для ИИ-чата можно использовать чипы-подсказки, чтобы предлагать возможные ответы на последнее сообщение.

Рассмотрим пример реализации SuggestionChip:

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

Вот как это выглядит:

Рисунок 5. вариант запроса.

Приподнятый чип

Все примеры в этом документе используют базовые составные элементы, которые имеют плоский вид. Если вам нужен чип с приподнятым внешним видом, используйте один из трех следующих составных элементов:

Обновление M3 Expressive

Обновлен стиль чипов фильтров и ввода, в том числе увеличен радиус скругления углов и добавлена анимация. Подсказки и варианты запросов объединены в кнопки.

Дополнительную информацию об обновлениях M3 Expressive для чипов можно найти в руководстве по чипам Material Design 3.

Морфинг углов

Фильтры и чипы ввода поддерживают морфинг углов, анимируя радиус угла контейнера от 12dp в невыбранном состоянии до полностью закругленного в выбранном.

Фильтр

В следующем фрагменте кода показано, как реализовать фильтр-чип с изменением формы углов:

@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 кнопки помощи и варианты запросов объединены в экспрессивные кнопки, поскольку они функционально отражают поведение кнопок с одним действием. Используйте выразительные кнопки, когда вам нужно выразительное поведение чипа помощи или варианта запроса. Подробности реализации см. в документации по кнопкам.

Дополнительные ресурсы