Kártyák renderelése az alkalmazásban

Az adaptív kártyák egyszerűen megjeleníthetőek az alkalmazásban. SDK-kat biztosítunk az összes gyakori platformhoz, valamint részletes specifikációt biztosítunk saját adaptív kártya renderelőjének létrehozásához.

1. Telepítsen egy renderelő SDK-t a célplatformhoz.
2. Renderelőpéldány létrehozása – az alkalmazás stílusával, szabályaival és műveletesemény-kezelőivel konfigurálva.
3. Kártya renderelése natív felhasználói felületre – automatikusan az alkalmazásnak megfelelően.

SDK az adaptív kártyákhoz

Plattform	Felszerel	Épít	Doksi	Státusz
JavaScript		Forrás	Dokumentáció
.NET WPF		Forrás	Dokumentumok
.NET HTML		Forrás	Dokumentumok
Windows UWP		Forrás	Dokumentumok
WinUI 3		Forrás	Dokumentumok
Android		Forrás	Dokumentáció
iOS		Forrás	Dokumentáció

A renderelő példányának létrehozása

A következő lépés egy AdaptiveCardRenderer példányának létrehozása.

Események csatlakoztatása

Alapértelmezés szerint a műveletek gombként jelennek meg a kártyán, de az alkalmazáson múlik, hogy a várt módon viselkedjenek. Minden SDK rendelkezik egy OnAction olyan eseménysel, amelyet kezelnie kell.

• Action.OpenUrl – nyissa meg a megadottt url.
• Action.Submit – a küldés eredményét vegye figyelembe, és küldje el a forrásnak. Az, hogyan küldi el az adatokat a kártyához tartozó forrásnak, teljes mértékben Önön múlik.
• Action.ShowCard – meghív egy párbeszédpanelt, és megjeleníti az alkártyát ebbe a párbeszédpanelbe. Vegye figyelembe, hogy ezt csak akkor kell kezelnie, ha ShowCardActionMode be van állítva popup.

Kártya megjelenítése

Miután megszerezte a kártya payload-ját, egyszerűen hívja meg a renderelőt, és adja át a kártyát. A kártya tartalmából álló natív felhasználói felületi objektumot kap vissza. Most egyszerűen helyezze el ezt a felhasználói felületet valahol az alkalmazásban.

Testreszabás

A renderelt szöveg többféleképpen is testre szabható.

HostKonfiguráció

A HostConfig egy megosztott, platformfüggetlen konfigurációs objektum, amely szabályozza a kártyák alapvető stílusát és viselkedését az alkalmazásban. Meghatározza a betűméreteket, az elemek közötti térközt, a színeket, a támogatott műveletek számát stb.

Natív platformformázás

A legtöbb felhasználói felületi keretrendszer lehetővé teszi a renderelt kártya stílusának használatát a natív felhasználói felületi keretrendszer-stílus használatával. A HTML-ben megadhat például CSS-osztályokat a HTML-hez, vagy XAML-ben egy egyéni ResourceDictionary-t adhat át a kimenet részletes vezérléséhez.

Elemenkénti renderelés testreszabása

Minden SDK lehetővé teszi bármely elem megjelenítésének felülbírálását, vagy akár teljesen új, Ön által definiált elemek támogatását is. Módosíthatja például a Input.Date renderelőt úgy, hogy saját egyéni vezérlőt bocsátson ki, miközben továbbra is megtartja a renderelő kimenetének többi részét. Vagy hozzáadhat támogatást egy ön által definiált egyéni Rating elemhez.