通过

卡片

  • 项目

卡片是装载简短信息或相关信息的用户界面 (UI) 容器。 卡片可以有多个属性和附件，可以包含按钮，可触发 卡片操作。 使用卡片，可以将信息组织到组中，让用户有机会与信息的特定部分进行交互。

Microsoft Teams 机器人支持以下类型的卡片：

  • 自适应卡片
  • 主图卡片
  • 列表卡
  • 用于Microsoft 365 组的连接器卡
  • 收据卡
  • 登录卡
  • 缩略图卡片
  • 卡片集合
  • 自适应卡片上的“溢出”菜单

可以使用 Markdown 或 HTML 向卡片添加格式文本格式，具体取决于卡片类型。 机器人和 Teams 中的消息扩展使用的卡片，添加和响应这些卡操作openUrl、、messageBack、imBackinvoke、 和 signin。

Teams 在三个不同的位置使用卡片：

  • 连接器
  • 机器人
  • 消息扩展

连接器中的卡

卡片最初定义为 Outlook 和 Microsoft 365 的一部分，现在用作Microsoft 365 组连接器的一部分。 与许多Microsoft 365 应用程序一样，Teams 支持连接器。 有关详细信息，请参阅为Microsoft 365 组创建连接器。 可以在 可操作邮件卡参考 中找到连接器中的卡片规范。

机器人中的卡片

Microsoft Bot Framework 通过添加一组预定义卡来扩展卡规范，机器人可以将其用作机器人消息的一部分。 Teams 支持使用 Bot Framework 的机器人，但它支持一组不同的卡片。 有关Bot Framework 中卡的常规信息，请参阅 将富卡附件添加到邮件。 这些卡在 Teams 中称为简单卡片。

Teams 中的机器人可以使用简单卡片、连接器卡或自适应卡片。 类型卡 提供有关卡的信息，由 Teams 中的机器人支持。

消息扩展中的卡片

消息扩展 还可以返回卡片。 消息扩展可以使用简单卡片、连接器卡或自适应卡片。 这些卡片位于 类型卡中。

卡片类型

Teams 使用的所有卡都列在类型卡中。 本参考还介绍了 Teams 中Bot Framework卡和卡片之间的差异。

自适应卡

自适应卡片是一种跨产品的规范，可应用于包括机器人、Cortana、Outlook 和 Windows 在内的各种 Microsoft 产品。 它是新 Teams 开发推荐使用的卡片类型。 有关自适应卡片团队的常规信息，请参阅 自适应卡片概述。 可以在使用现有英雄卡、Microsoft 365 卡和缩略图卡的任何位置使用自适应卡片。

除了自适应卡片，Teams 支持两种其他类型的卡片：

  • 连接器卡：用作Microsoft 365 组连接器的一部分。
  • 简单卡片：从 Bot Framework 使用，例如缩略图和主图卡片。

自适应卡片中的人员选取器

人员选取器 添加为自适应卡片中的输入控件，可以搜索和选择人员。 可以在聊天、频道、对话 (TeamsJS v1.x) 和选项卡中使用任务模块。 移动和桌面客户端支持人员选取器，提供了内联键入体验。

自适应卡片中的人员图标

自适应卡片中的人员图标可帮助用户查看 Teams 自适应卡片中的用户图像。 可以查看单个用户或多个用户的图像。 Teams 移动和桌面客户端支持人员图标。

在自适应卡片中键入提前搜索

在自适应卡片中添加为输入控件的“类型头搜索”支持动态加载数据集中的动态 搜索 体验。 它还允许用户在具有有限选择数的列表中执行类型化静态搜索。 移动和桌面客户端支持键入动态搜索体验。

自适应卡片中的依赖输入

可以在 Teams 中设计自适应卡片，其中输入的值取决于另一个输入的值。 例如，考虑具有两 Input.ChoiceSet 个下拉列表的自适应卡片：一个用于选择国家/地区，另一个用于选择该国家/地区的特定城市。 第一个下拉列表必须筛选第二个下拉列表中显示的城市。 这可以通过创建一个Input.ChoiceSet包含动态类型头搜索的下拉列表来实现，该搜索依赖于卡中的一个或多个其他输入。 有关详细信息，请参阅 依赖输入。

自适应卡片中的媒体元素

自适应卡片中的媒体元素提供增强的媒体体验，并增加对自适应卡片的参与度。 可以将音频或视频剪辑、YouTube、Vimeo 或 Dailymotion 视频等媒体文件添加到自适应卡片。 有关详细信息，请参阅 自适应卡片中的媒体元素。

自适应卡片和传入 Webhook

注意

借助传入 Webhook 自适应卡片，可以使用自适应卡片的丰富灵活功能。 它使用 Teams 中的传入 Webhook 从其 Web 服务发送数据。

自适应卡片中的 CodeBlock

使用 CodeBlock 元素在 Teams 聊天、频道和会议中将代码片段共享为格式丰富的自适应卡片。 具有 元素的 CodeBlock 自适应卡片使代码片段易于阅读，因为缩进、编号和语法突出显示与编程语言匹配。 有关详细信息，请参阅 自适应卡中的 CodeBlock。

自适应卡片响应布局

必须将自适应卡片设计为在任何设备上外观极佳，以便跨聊天、频道和会议聊天提供增强的用户体验。 自适应卡片响应布局有助于设计具有不同布局的卡片，以不同的卡宽度为目标。 有关详细信息，请参阅 自适应卡片响应布局。

边框和圆角

可以向自适应卡片中的 Container、ColumnSet、 Column和 Table 元素添加边框，以描述卡的不同部分。 可以向自适应卡片中的 Container、、TableColumnSetColumn、 和 Image 元素添加圆角，使卡设计看起来现代且具有视觉吸引力。 有关详细信息，请参阅 自适应卡片中的边框和圆角。

可滚动容器

包含许多元素的容器可能会导致长时间无法读取卡。 maxHeight使用 属性定义容器的最大高度。 当容器具有最大高度且其内容超过该高度时，将显示垂直滚动条。 有关详细信息，请参阅 自适应卡片中的可滚动容器。

复合按钮

复合按钮是一种特殊类型的按钮，具有图标、标题和说明。 可以使用 元素添加“复合”按钮 CompoundButton 。 此元素使你能够复制自适应卡片中 提示初学者 的外观。 有关详细信息，请参阅 自适应卡片中的复合按钮。

Fluent 图标

自适应卡片支持使用 Icon 元素从 Fluent 图标库中添加图标。 有关详细信息，请参阅 自适应卡片中的图标。

星级

可以使用 元素将star分级输入添加到自适应卡片Input.Rating。 还可以使用 Rating 元素包括只读star分级。 有关详细信息，请参阅 自适应卡片中的分级。

操作按钮的条件启用

可以使用 conditionallyEnabled 属性禁用操作按钮，直到用户更改至少一个所需输入的值。 此属性只能与 和 Action.Execute 操作一起使用Action.Submit。 有关详细信息，请参阅 操作按钮的条件启用。

自适应卡片上的“溢出”菜单

Teams 中的自适应卡片支持溢出菜单。 可以为自适应卡片中的所有辅助操作填充溢出菜单。

支持在用户提及中Microsoft Entra对象 ID 和 UPN

具有自适应卡的机器人支持用户提及 ID，例如Microsoft Entra对象 ID 和用户主体名称 (UPN) ，以及现有 ID。 传入 Webhook 开始使用 Microsoft Entra 对象 ID 和 UPN 支持自适应卡片中的用户提及。

自适应卡片中的图表

除了现有 ID 之外，机器人还支持用户提及 ID，例如Microsoft Entra对象 ID 和用户主体名称 (UPN) 。 传入 Webhook 开始使用 Microsoft Entra 对象 ID 和 UPN 支持自适应卡片中的用户提及。

自适应卡片中的容器布局

可以使用 、 Layout.Flow和 Layout.AreaGrid 布局为不同的自适应卡片宽度Layout.Stack设计响应容器。 有关详细信息，请参阅 容器布局。

后续步骤

卡片类型

另请参阅