徽章

使用徽章在另一个可组合项上显示一个小视觉元素，以表示状态或数值。以下是一些您可能使用徽章的常见场景

通知：在应用图标或通知铃铛上显示未读通知的数量。
消息：指示聊天应用中的新消息或未读消息。
状态更新：显示任务的状态，例如“已完成”、“正在进行”或“失败”。
购物车数量：显示用户购物车中的商品数量。
新内容：突出显示用户可用的新内容或功能。

图 1. 徽章示例

API 表面

使用 BadgedBox 可组合项在您的应用中实现徽章。它最终是一个容器。您可以使用这两个主要参数控制其外观

content：BadgedBox 包含的可组合内容。通常是 Icon。
badge：显示在内容上方的作为徽章的可组合项。通常是专用的 Badge 可组合项。

基本示例

此代码片段显示了 BadgedBox 的基本实现

@Composable
fun BadgeExample() {
    BadgedBox(
        badge = {
            Badge()
        }
    ) {
        Icon(
            imageVector = Icons.Filled.Mail,
            contentDescription = "Email"
        )
    }
}Badges.kt

此示例显示一个与提供的 Icon 可组合项重叠的徽章。请注意代码中的以下内容

BadgedBox 用作整体容器。
BadgedBox 的 badge 参数的参数是 Badge。由于 Badge 本身没有参数，因此应用显示默认徽章，即一个小红色圆圈。
Icon 用作 BadgedBox 的 content 参数的参数。它是徽章显示在其上的图标。在本例中，它是一个邮件图标。

它显示如下

A simple badge that contains no content. — **图 2.** 最小的徽章实现。

详细示例

以下代码段演示了如何显示响应用户操作的徽章中的值。

@Composable
fun BadgeInteractiveExample() {
    var itemCount by remember { mutableStateOf(0) }

    Column(
        verticalArrangement = Arrangement.spacedBy(16.dp)
    ) {
        BadgedBox(
            badge = {
                if (itemCount > 0) {
                    Badge(
                        containerColor = Color.Red,
                        contentColor = Color.White
                    ) {
                        Text("$itemCount")
                    }
                }
            }
        ) {
            Icon(
                imageVector = Icons.Filled.ShoppingCart,
                contentDescription = "Shopping cart",
            )
        }
        Button(onClick = { itemCount++ }) {
            Text("Add item")
        }
    }
}Badges.kt

此示例实现了一个购物车图标，该图标带有显示用户购物车中商品数量的徽章。

BadgedBox 仅在商品数量大于 0 时显示。
containerColor 和 contentColor 的参数控制徽章的外观。
Badge 的内容插槽的 Text 可组合项显示在徽章内。在本例中，它显示购物车中的商品数量。

此实现显示如下

徽章

API 表面

基本示例

详细示例

其他资源