创建一个芯片来表示复杂实体

Chip 组件是一种紧凑的交互式 UI 元素。它代表复杂的实体，如联系人或标签，通常带有图标和标签。它可以是可勾选、可关闭或可点击的。

芯片的五种类型及其用例如下

• Assist：在任务期间引导用户。通常作为临时 UI 元素出现，响应用户输入。
• Filter：让用户从一组选项中筛选内容。它们可以被选中或取消选中，选中时可能包含一个复选标记图标。
• Input：表示用户提供的信息，例如菜单中的选择项。它们可以包含图标和文本，并提供一个“X”用于移除。
• Suggestion：根据用户最近的活动或输入向用户提供建议。通常出现在输入字段下方，以提示用户操作。
• Elevated：具有突出外观，而不是平面外观。

版本兼容性

此实现要求您的项目 minSDK 设置为 API level 21 或更高版本。

依赖项

创建 Assist 芯片

AssistChip 可组合项提供了一种直接的方式来创建 Assist 芯片，以引导用户朝着特定方向前进。一个显著的特点是其 leadingIcon 参数，该参数允许您在芯片的左侧显示一个图标，如图 1 所示。以下示例展示了如何实现：

创建 Filter 芯片

FilterChip 可组合项要求您跟踪芯片是否被选中。以下示例演示了如何仅在用户选中芯片时显示前置复选标记图标：

结果

创建 Input 芯片

您可以使用 InputChip 可组合项创建由用户互动产生的芯片。例如，在电子邮件客户端中，当用户正在撰写电子邮件时，Input 芯片可能代表用户已输入到“收件人:”字段中的某人。

以下实现展示了一个处于选中状态的 Input 芯片。用户按下芯片时，芯片将被关闭。

结果

创建 Suggestion 芯片

SuggestionChip 可组合项是本页列出的可组合项中最基本的，无论是在其 API 定义还是其常见用例方面。Suggestion 芯片提供动态生成的提示。例如，在 AI 聊天应用中，您可以使用 Suggestion 芯片来呈现对最新消息的可能回复。

考虑 SuggestionChip 的此实现方式：

结果

创建 Elevated 芯片

本文档中的所有示例都使用了具有平面外观的基础可组合项。如果您想要一个具有突出外观的芯片，请使用以下三种可组合项之一：

• ElevatedAssistChip
• ElevatedFilterChip
• ElevatedSuggestionChip

要点

四个可组合项对应四种类型的芯片，它们共享以下参数：

• label：显示在芯片上的字符串。
• icon：显示在芯片开头的图标。某些可组合项具有单独的 leadingIcon 和 trailingIcon 参数。
• onClick：用户点击芯片时调用的 lambda 表达式。

包含本指南的集合

本指南是精心策划的快速指南集合的一部分，这些集合涵盖更广泛的 Android 开发目标：

有疑问或反馈？

前往我们的常见问题页面了解快速指南，或联系我们告知您的想法。

前往常见问题 提供反馈