Chip

El componente Chip es un elemento de la IU interactivo y compacto. Representa entidades complejas como un contacto o una etiqueta, a menudo con un ícono y una etiqueta. Se puede marcar, descartar o hacer clic.

Estos son los cuatro tipos de chips y dónde podrías usarlos:

  • Ayudar: Guía al usuario durante una tarea. A menudo aparece como un elemento temporal de la IU en respuesta a la entrada del usuario.
  • Filtrar: Permite a los usuarios definir mejor el contenido de un conjunto de opciones. Se pueden seleccionar o anular la selección, y pueden incluir un ícono de marca de verificación cuando se seleccionan.
  • Entrada: Representa la información que proporciona el usuario, como las selecciones en un menú. Pueden contener un ícono y texto, además de proporcionar una "X" que se debe quitar.
  • Sugerencia: Proporciona recomendaciones al usuario en función de su actividad o entrada recientes. Suelen aparecer debajo de un campo de entrada para solicitar acciones del usuario.
Un ejemplo de cada uno de los cuatro componentes del chip, en el que se destacan sus características únicas.
Figura 1: Los cuatro componentes del chip.

Plataforma de API

Hay cuatro elementos componibles que corresponden a los cuatro tipos de chips. En las siguientes secciones, se describen en detalle estos elementos componibles y sus diferencias. Sin embargo, comparten los siguientes parámetros:

  • label: Es la cadena que aparece en el chip.
  • icon: Es el ícono que se muestra al comienzo del chip. Algunos de los elementos componibles específicos tienen parámetros leadingIcon y trailingIcon independientes.
  • onClick: Es la expresión lambda a la que llama el chip cuando el usuario la presiona.

Chip de asistencia

El elemento AssistChip componible proporciona una forma directa de crear un chip de asistencia que dirige al usuario en una dirección en particular. Un aspecto distintivo es su parámetro leadingIcon, que te permite mostrar un ícono en el lado izquierdo del chip. En el siguiente ejemplo, se muestra cómo puedes implementarlo:

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

Esta implementación aparece de la siguiente manera:

Un chip de asistencia sencillo.
Figura 2: Chip de asistencia.

Elemento de filtro

El elemento componible FilterChip requiere que hagas un seguimiento de si el chip está seleccionado o no. En el siguiente ejemplo, se muestra cómo puedes mostrar un ícono inicial marcado solo cuando el usuario selecciona el chip:

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

    FilterChip(
        onClick = { selected = !selected },
        label = {
            Text("Filter chip")
        },
        selected = selected,
        leadingIcon = if (selected) {
            {
                Icon(
                    imageVector = Icons.Filled.Done,
                    contentDescription = "Done icon",
                    modifier = Modifier.size(FilterChipDefaults.IconSize)
                )
            }
        } else {
            null
        },
    )
}
Chip.kt

Esta implementación se muestra de la siguiente manera cuando no se selecciona:

Un chip de filtro no seleccionado, sin verificación y sin fondo del plan.
Figura 3: Se anuló la selección del chip de filtro.

Y se muestra de la siguiente manera cuando se selecciona:

Chip de filtro seleccionado, con una marca de verificación y un fondo de color.
Figura 4: Se seleccionó el chip de filtro.

Chip de entrada

Puedes usar el elemento componible InputChip para crear chips como resultado de la interacción del usuario. Por ejemplo, en un cliente de correo electrónico, cuando el usuario escribe un mensaje, un chip de entrada podría representar a una persona cuya dirección el usuario ingresó en el campo "Para:".

En la siguiente implementación, se muestra un chip de entrada que ya está en estado seleccionado. El usuario descarta el chip cuando lo presiona.

@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(
                Icons.Filled.Person,
                contentDescription = "Localized description",
                Modifier.size(InputChipDefaults.AvatarSize)
            )
        },
        trailingIcon = {
            Icon(
                Icons.Default.Close,
                contentDescription = "Localized description",
                Modifier.size(InputChipDefaults.AvatarSize)
            )
        },
    )
}
Chip.kt

Esta implementación aparece de la siguiente manera:

Un chip de entrada con un avatar y un ícono final.
Figura 5: Chip de entrada

Chip de sugerencias

El elemento SuggestionChip componible es el más básico y enumerado en esta página, tanto en la definición de la API como en sus casos de uso comunes. Los chips de sugerencias presentan sugerencias generadas de forma dinámica. Por ejemplo, en una app de chat con IA, puedes usar chips de sugerencias para presentar posibles respuestas al mensaje más reciente.

Considera esta implementación de SuggestionChip:

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

Esta implementación aparece de la siguiente manera:

Un chip de asistencia sencillo.
Figura 6: Chip de asistencia.

Chip elevado

En todos los ejemplos de este documento, se usan los elementos básicos componibles que toman una apariencia plana. Si quieres un chip con un aspecto elevado, usa uno de los siguientes elementos componibles:

Recursos adicionales