Chips help people enter information, make selections, filter content, or trigger actions. Chips can show multiple interactive elements together in the same area, such as a list of selectable movie times, or a series of email contacts
Android
@ExperimentalTvMaterial3Api
@Composable
fun InputChip(
selected: Boolean,
onClick: () -> Unit,
modifier: Modifier = Modifier,
enabled: Boolean = true,
onLongClick: (() -> Unit)? = null,
leadingIcon: @Composable (() -> Unit)? = null,
avatar: @Composable (() -> Unit)? = null,
trailingIcon: @Composable (() -> Unit)? = null,
shape: SelectableChipShape = InputChipDefaults.shape(hasAvatar = avatar != null),
colors: SelectableChipColors = InputChipDefaults.colors(),
scale: SelectableChipScale = InputChipDefaults.scale(),
border: SelectableChipBorder = InputChipDefaults.border(hasAvatar = avatar != null),
glow: SelectableChipGlow = InputChipDefaults.glow(),
interactionSource: MutableInteractionSource? = null,
content: @Composable () -> Unit,
)Parameters
| selected | whether this chip is selected or not |
| onClick | called when this chip is clicked |
| modifier | the Modifier to be applied to this chip |
| enabled | controls the enabled state of this chip. When false, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services |
| onLongClick | callback to be called when the surface is long clicked (long-pressed) |
| leadingIcon | optional icon at the start of the chip, preceding the content text |
| avatar | optional avatar at the start of the chip, preceding the content text |
| trailingIcon | optional icon at the end of the chip |
| shape | Defines the Chip's shape |
| colors | Color to be used on background and content of the chip |
| scale | Defines size of the chip relative to its original size |
| border | Defines a border around the chip |
| glow | Shadow to be shown behind the chip |
| interactionSource | an optional hoisted MutableInteractionSource for observing and emitting Interactions for this chip. You can use this to change the chip's appearance or preview the chip in different states. Note that if null is provided, interactions will still happen internally. |
| content | for this chip, ideally a Text composable |
