在应用程序中呈现卡片

  • 项目

在应用程序中呈现自适应卡片很轻松。 我们提供适用于所有常用平台的 SDK，并提供详细规范来指导你创建自己的自适应卡片呈现器。

  1. 安装呈现器 SDK - 适用于目标平台。
  2. 创建呈现器实例 - 配置了应用的样式、规则和操作事件处理程序。
  3. 根据本机 UI 呈现卡片 - 自动根据你的应用进行样式设置

自适应卡片 SDK

平台 安装 生成 Docs 状态
JavaScript npm install Source 文档 生成状态
.NET WPF Nuget 安装 Source 文档 生成状态
.NET HTML Nuget 安装 Source 文档 生成状态
Windows UWP Nuget 安装 Source 文档 生成状态
WinUI 3 Nuget 安装 Source 文档 生成状态
Android Maven Central Source 文档 生成状态
iOS CocoaPods Source 文档 生成状态

创建呈现器的实例

下一步是创建 AdaptiveCardRenderer 的实例。

挂接操作事件

默认情况下，操作在卡上会呈现为按钮，但应用可以根据你的需要来定义操作的行为。 每个 SDK 都有 OnAction 事件的等效项，必须对其进行处理。

  • Action.OpenUrl - 打开指定的 url。
  • Action.Submit - 获取提交的结果并将其发送到源。 如何将其发送到卡片的源完全取决于你自己。
  • Action.ShowCard - 调用某个对话并将子卡呈现到该对话中。 请注意，只有在 ShowCardActionMode 设置为 popup 的情况下，才需要对此进行处理。

呈现卡片

获取卡片有效负载以后，请直接调用呈现器并传入卡片。 系统会返回一个由卡片内容组成的本机 UI 对象。 现在，只需将该 UI 置于应用中的某个位置即可。

自定义

可以通过多种方式自定义呈现的内容。

HostConfig

HostConfig 是一个共享的跨平台配置对象，用于控制应用中的卡片的基本样式设置和行为。 它定义的内容包括：字体大小、元素之间的间距、颜色、支持的操作的数目，等等。

本机平台样式设置

大多数 UI 框架允许你根据本机 UI 框架样式设置来设置呈现的卡片的样式。 例如，在 HTML 中，可以指定 HTML 的 CSS 类；在 XAML 中，可以传入自定义 ResourceDictionary，以便对输出进行精细的控制。

自定义按元素呈现功能

每个 SDK 都允许你重写任何元素的呈现，甚至允许你为自己定义的全新元素添加支持。 例如，可以更改 Input.Date 呈现器，以便在仍然保留呈现器的其余输出的情况下，发出你自己的自定义控制。 也可添加对你定义的自定义 Rating 元素的支持。