Jetpack Compose Glimmer 中的列表项

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

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

该组件有两个重载：一个带有 onClick 参数，用于触发操作的项；另一个是仅可聚焦的版本，用于不需要点击操作的信息内容。

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

在列表中的用法

列表项是 列表中的行的主要选择，但列表也可以托管其他组件，例如 Card 或 TitleChip，以提供不同的视觉强调。

列表项使用 headlineContent 插槽作为其主要文本，以便与用于其他项的 Card 和 TitleChip 组件保持一致。

示例：基本列表项

以下代码用于创建基本列表项：

@Composable
fun ListItemSample() {
    ListItem { Text("This is a list item") }
}

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

以下代码用于创建带有辅助标签以及前导和尾随图标的列表项：

@Composable
fun ListItemWithIconsSample() {
    ListItem(
        leadingIcon = { Icon(FavoriteIcon, contentDescription = "Favorite") },
        trailingIcon = { Icon(FavoriteIcon, contentDescription = "Favorite") }
    ) {
        Text("This is a list item with icons")
    }
}