Chip

Il componente Chip è un elemento UI compatto e interattivo. Rappresenta entità complesse come un contatto o un tag, spesso con un'icona e un'etichetta. Può essere selezionabile, ignorabile o cliccabile.

I quattro tipi di chip e i relativi casi d'uso sono i seguenti:

  • Assistenza: guida l'utente durante un'attività. Spesso viene visualizzato come elemento UI temporaneo in risposta all'input dell'utente.
  • Filtro: consente agli utenti di perfezionare i contenuti da un insieme di opzioni. Possono essere selezionati o deselezionati e, se selezionati, possono includere l'icona di un segno di spunta.
  • Input: rappresenta le informazioni fornite dall'utente, ad esempio le selezioni in un menu. Possono contenere un'icona e un testo e fornire una X per la rimozione.
  • Suggerimento: fornisce consigli all'utente in base alla sua attività o al suo input recenti. In genere vengono visualizzati sotto un campo di immissione per richiedere azioni dell'utente.
Un esempio di ciascuno dei quattro componenti chip, con le relative caratteristiche uniche evidenziate.
Figura 1. I quattro componenti del chip.

Piattaforma API

Esistono quattro elementi componibili che corrispondono ai quattro tipi di chip. Le sezioni seguenti descrivono in dettaglio questi componibili e le loro differenze. Tuttavia, condividono i seguenti parametri:

  • label: la stringa visualizzata nel chip.
  • icon: l'icona visualizzata all'inizio del chip. Alcuni dei componibili specifici hanno un parametro leadingIcon e trailingIcon separato.
  • onClick: la funzione lambda che il chip chiama quando l'utente lo preme.

Chip di assistenza

Il composable AssistChip offre un modo semplice per creare un chip di assistenza che indirizza l'utente in una determinata direzione. Una caratteristica distintiva è il parametro leadingIcon, che consente di visualizzare un'icona sul lato sinistro del chip. Il seguente esempio mostra come implementarlo:

@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)
            )
        }
    )
}

Ecco come appare l'implementazione:

Figura 2. Chip di assistenza.

Icona filtro

Il componibile FilterChip richiede di monitorare se il chip è selezionato o meno. L'esempio seguente mostra come visualizzare un'icona di controllo iniziale solo quando l'utente ha selezionato il chip:

@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
        },
    )
}

Ecco come appare l'implementazione quando viene selezionata:

Figura 3. Chip del filtro selezionato.

Chip di input

Puoi utilizzare l'elemento componibile InputChip per creare chip che derivano dall'interazione dell'utente. Ad esempio, in un client di posta, quando l'utente scrive un'email, un chip di input potrebbe rappresentare un contatto aggiunto dall'utente nel campo "A:".

La seguente implementazione mostra un chip di input già in uno stato selezionato. L'utente chiude il chip quando lo preme.

@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)
            )
        },
    )
}

Ecco come appare l'implementazione:

Figura 4. Chip di input.

Chip di suggerimento

Il componibile SuggestionChip è il più semplice tra quelli elencati in questa pagina, sia nella definizione dell'API sia nei casi d'uso comuni. I chip di suggerimento presentano suggerimenti generati dinamicamente. Ad esempio, in un'app di chat AI, potresti utilizzare i chip di suggerimento per presentare possibili risposte al messaggio più recente.

Considera questa implementazione di SuggestionChip:

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

Ecco come appare la barra:

Figura 5. Chip di suggerimento.

Chip in rilievo

Tutti gli esempi in questo documento utilizzano gli elementi componibili di base che assumono un aspetto piatto. Se vuoi un chip con un aspetto in rilievo, utilizza uno dei tre seguenti elementi componibili:

Aggiornamento espressivo M3

I chip di filtro e di input presentano aggiornamenti stilistici, tra cui un raggio degli angoli maggiore e un movimento a molla. I chip di assistenza e di suggerimento sono stati uniti in pulsanti espressivi.

Per saperne di più sugli aggiornamenti di M3 Expressive per i chip, consulta le linee guida per i chip di Material Design 3.

Morphing degli angoli

I chip di filtro e di input supportano la trasformazione degli angoli, animando il raggio dell'angolo del container da 12 dp quando non è selezionato a completamente arrotondato quando è selezionato.

Filtro

Il seguente snippet mostra come implementare un chip di filtro con la trasformazione degli angoli:

@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
        },
    )
}

Filtro elevato

I chip di filtro in rilievo si distinguono da uno sfondo visivamente prominente e supportano la trasformazione degli angoli. Il seguente snippet mostra come implementare un chip di filtro in rilievo con trasformazione degli angoli:

@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),
            )
        },
    )
}

Input

I chip di immissione rappresentano informazioni distinte inserite da un utente e supportano anche la trasformazione degli angoli. Il seguente snippet mostra come implementare un chip di input con trasformazione degli angoli:

@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),
            )
        },
    )
}

Chip di assistenza e suggerimento

I chip di assistenza e i chip di suggerimento sono uniti in pulsanti espressivi in Material 3 Expressive perché rispecchiano dal punto di vista funzionale i comportamenti dei pulsanti ad azione singola. Utilizza i pulsanti espressivi quando hai bisogno di un comportamento di assistenza espressiva o di chip di suggerimento; consulta la documentazione sui pulsanti per i dettagli sull'implementazione.

Risorse aggiuntive