共用方式為

在您的應用程式內轉譯卡片

  • 發行項

您可以輕鬆地在應用程式內轉譯調適型卡片。 我們會提供適用於所有通用平台的 SDK，並提供建立您自己的調適型卡片轉譯器的詳細規格。

  1. 安裝轉譯器 SDK - 針對您的目標平台。
  2. 建立轉譯器執行個體 - 設定您的應用程式樣式、規則和動作事件處理常式。
  3. 將卡片轉譯為原生 UI - 自動針對您的應用程式進行樣式化。

調適型卡片 SDK

平台 安裝 建置 Docs 狀態
JavaScript npm 安裝 來源 文件 組建狀態
.NET WPF Nuget 安裝 來源 文件 組建狀態
.NET HTML Nuget 安裝 來源 文件 組建狀態
Windows UWP Nuget 安裝 來源 文件 組建狀態
WinUI 3 Nuget 安裝 來源 文件 組建狀態
Android Maven Central 來源 文件 組建狀態
iOS CocoaPods 來源 文件 組建狀態

建立轉譯器的執行個體

下一個步驟是建立 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 元素新增支援。