Vykreslování karet v aplikaci

Adaptivní karty můžete v aplikaci snadno vykreslit. Poskytujeme sady SDK pro všechny společné platformy a také poskytujeme podrobnou specifikaci pro vytvoření vlastního rendereru adaptivní karty.

1. Nainstalujte sadu SDK rendereru – pro cílovou platformu.
2. Vytvořte instanci rendereru - nakonfigurujte ji pomocí stylu, pravidel a obslužných rutin událostí akcí vaší aplikace.
3. Vykreslete kartu do nativního uživatelského rozhraní – automaticky stylovanou podle vaší aplikace.

Sady SDK pro adaptivní karty

Platforma	Instalujte	Stavět	Dokumenty	Stav
JavaScript		Zdroj	Dokumenty
.NET WPF		Zdroj	Dokumenty
.NET HTML		Zdroj	Dokumenty
Windows UWP		Zdroj	Dokumenty
WinUI 3		Zdroj	Dokumenty
Android		Zdroj	Dokumenty
iOS		Zdroj	Dokumenty

Vytvoření instance rendereru

Dalším krokem je vytvoření instance objektu AdaptiveCardRenderer.

Připojte akční události

Ve výchozím nastavení se akce vykreslují jako tlačítka na kartě, ale záleží na tom, aby se vaše aplikace chovala podle očekávání. Každá sada SDK má ekvivalent OnAction události, kterou musíte zpracovat.

• Action.OpenUrl – otevření zadaného urlsouboru .
• Action.Submit – vezměte výsledek odeslání a odešlete ho zpět do zdroje. Jak ho pošlete zdroji karty, je zcela na vás.
• Action.ShowCard – vyvolá dialogové okno a vykreslí dílčí kartu do daného dialogového okna. Mějte na paměti, že je nutné toto zpracovat pouze, pokud je ShowCardActionMode nastavena na popup.

Vykreslení karty

Po získání datové části karty jednoduše zavolejte renderer a předejte kartu. Vrátíte objekt nativního uživatelského rozhraní složený z obsahu karty. Teď někam do aplikace umístěte toto uživatelské rozhraní.

Přizpůsobení

Existuje několik způsobů, jak přizpůsobit, co se vykresluje.

Konfigurace hostu

HostConfig je sdílený objekt konfigurace pro různé platformy, který řídí základní styl a chování karet v aplikaci. Definuje například velikosti písma, mezery mezi prvky, barvy, počet podporovaných akcí atd.

Styly nativní platformy

Většina frameworků uživatelského rozhraní umožňuje utvářet styl vykreslené karty pomocí nativního stylování uživatelských rozhraní. Například v HTML můžete zadat třídy CSS v rámci HTML, nebo v XAML můžete předat vlastní ResourceDictionary pro detailní ovládání výstupu.

Přizpůsobení vykreslování jednotlivých prvků

Každá sada SDK umožňuje přepsat vykreslování libovolného prvku nebo dokonce přidat podporu pro zcela nové prvky, které definujete. Renderer můžete například změnit Input.Date tak, aby generoval váš vlastní ovládací prvek a přitom zachoval zbytek výstupu rendereru. Nebo můžete přidat podporu vlastního Rating prvku, který definujete.