在 Jetpack Compose Glimmer 中,ListItem 是用于显示单行内容的标准组件。列表项专为显示眼镜的基于焦点的互动而设计,因此在获得焦点时会提供内置的视觉响应。
该组件具有两个重载:一个带有 onClick 参数,用于触发操作的项;另一个仅可聚焦,用于不需要点击操作的信息性内容。
列表中的使用情况
列表项是列表中行的主要选择,不过列表也可以托管其他组件,例如 Card 或 TitleChip,以提供不同的视觉效果。
列表项使用 headlineContent slot 作为其主要文本,以便与用于其他项的 Card 和 TitleChip 组件保持一致。
示例:带有辅助标签和图标的列表项
以下代码创建了一个带有辅助标签以及前导和后导图标的列表项:
@Composable private fun ListItemWithSupportingLabelAndIcons() { ListItem( supportingLabel = { Text("Supporting Label") }, leadingIcon = { Icon(FavoriteIcon, "Localized description") }, trailingIcon = { Icon(FavoriteIcon, "Localized description") }, ) { Text("Primary Label") } }