Rendu de cartes à l’intérieur de votre application
Il est facile d’afficher des cartes adaptatives à l’intérieur de votre application. Nous fournissons des SDK pour toutes les plateformes courantes, ainsi qu’une spécification détaillée pour créer votre propre renderer de carte adaptative.
- Installez un SDK de renderer pour votre plateforme cible.
- Créez une instance de renderer configurée avec le style, les règles et les gestionnaires d’événements d’actions de votre application.
- Affichez une carte dans l’interface utilisateur native, affectée automatiquement du style de votre application.
SDK de cartes adaptatives
Plateforme | Installer | Build | Docs | État |
---|---|---|---|---|
JavaScript | Source | Docs | ||
.NET WPF | Source | Docs | ||
.NET HTML | Source | Docs | ||
Windows UWP | Source | Docs | ||
WinUI 3 | Source | Docs | ||
Téléphone | Source | Docs | ||
iOS | Source | Docs |
Créer une instance du renderer
L’étape suivante consiste à créer une instance de AdaptiveCardRenderer
.
Raccorder des événements d’actions
Par défaut, les actions s’affichent sous la forme de boutons sur la carte, mais c’est à votre application de faire en sorte qu’elles se comportent comme prévu. Chaque SDK a l’équivalent d’un événement OnAction
que vous devez gérer.
- Action.OpenUrl : ouvrir le
url
spécifié. - Action.Submit : prendre le résultat de l’envoi et l’envoyer à la source. La façon dont vous l’envoyez à la source de la carte dépend entièrement de vous.
- Action.ShowCard : appelle une boîte de dialogue et affiche la sous-carte dans cette boîte de dialogue. Notez que vous devez uniquement gérer cela si
ShowCardActionMode
a la valeurpopup
.
Effectuer le rendu d’une carte
Une fois que vous avez acquis une charge utile de carte, il vous suffit d’appeler le renderer et de transmettre la carte. Vous récupérerez un objet d’interface utilisateur natif composé du contenu de la carte. Maintenant, il vous suffit de placer cette interface utilisateur quelque part dans votre application.
Personnalisation
Il existe plusieurs façons de personnaliser ce qui est rendu.
HostConfig
Un HostConfig est un objet de configuration multiplateforme et partagé qui contrôle le style et le comportement de base des cartes à l’intérieur de votre application. Il définit des éléments tels que les tailles de police, l’espacement entre les éléments, les couleurs, le nombre d’actions prises en charge, et ainsi de suite.
Style de plateforme native
La plupart des frameworks d’interface utilisateur vous permettent d’appliquer un style à la carte rendue à l’aide du style de framework d’interface utilisateur natif. Par exemple, en HTML vous pouvez spécifier des classes CSS pour le code HTML, et en XAML vous pouvez passer un ResourceDictionary personnalisé pour obtenir un contrôle affiné de la sortie.
Personnaliser le rendu par élément
Chaque SDK vous permet de remplacer le rendu d’un élément, ou même d’ajouter la prise en charge d’éléments entièrement nouveaux que vous définissez. Par exemple, vous pouvez modifier le renderer Input.Date
pour émettre votre propre contrôle personnalisé tout en conservant le reste de la sortie du renderer. Vous pouvez aussi ajouter la prise en charge d’un élément Rating
personnalisé que vous définissez.