Jetpack Compose Glimmer 中的列表项

适用的 XR 设备
本指南可帮助您为以下类型的 XR 设备打造优质体验。
展示眼镜

在 Jetpack Compose Glimmer 中,ListItem 是用于显示单行内容的标准组件。列表项专为显示眼镜的基于焦点的互动而设计,因此在获得焦点时会提供内置的视觉响应。

该组件具有两个重载:一个带有 onClick 参数,用于触发操作的项;另一个仅可聚焦,用于不需要点击操作的信息性内容。

图 1. Jetpack Compose Glimmer 中具有不同样式列表项的两个列表的示例。

列表中的使用情况

列表项是列表中行的主要选择,不过列表也可以托管其他组件,例如 CardTitleChip,以提供不同的视觉效果。

列表项使用 headlineContent slot 作为其主要文本,以便与用于其他项的 CardTitleChip 组件保持一致。

示例:带有辅助标签和图标的列表项

以下代码创建了一个带有辅助标签以及前导和后导图标的列表项:

@Composable
private fun ListItemWithSupportingLabelAndIcons() {
    ListItem(
        supportingLabel = { Text("Supporting Label") },
        leadingIcon = { Icon(FavoriteIcon, "Localized description") },
        trailingIcon = { Icon(FavoriteIcon, "Localized description") },
    ) {
        Text("Primary Label")
    }
}