Partager via

Rendre des cartes à l’intérieur de votre application

Il est facile d’afficher des cartes adaptatives à l’intérieur de votre application. Nous fournissons des kits SDK pour toutes les plateformes communes, ainsi qu’une spécification détaillée pour la création de votre propre renderer de carte adaptative.

  1. Installez un Kit de développement logiciel (SDK) de renderer pour votre plateforme cible.
  2. Créez une instance de renderer , configurée avec le style, les règles et les gestionnaires d’événements d’action de votre application.
  3. Affichez une carte en interface utilisateur native , automatiquement mise en forme dans votre application.

Kits SDK de cartes adaptatives

Plate-forme Installez Construire Docs Statut
JavaScript npm install Source Docs État de la build
.NET WPF Installation de Nuget Source Docs état de build
.NET HTML Installation de Nuget Source Docs état de build
Windows UWP Installation de Nuget Source Docs État de la build
WinUI 3 Installation de Nuget Source Docs État de la build
Android Maven Central Source Docs état de build
Ios CocoaPods Source Docs état de build

Créer une instance du renderer

L’étape suivante consiste à créer une instance d’un AdaptiveCardRenderer.

Événements d’action de raccordement

Par défaut, les actions s'affichent sous forme de boutons sur la carte, mais c'est à votre application d'assurer leur comportement conforme à vos attentes. Chaque Kit de développement logiciel (SDK) a l’équivalent d’un OnAction événement que vous devez gérer.

  • Action.OpenUrl : ouvrez le fichier spécifié url.
  • Action.Submit : prenez le résultat de l’envoi et envoyez-le à la source. Comment vous l’envoyez à la source de la carte est entièrement à vous.
  • Action.ShowCard : appelle un dialogue et affiche la sous-carte dans ce dialogue. Notez que vous n’avez besoin de gérer cela que si ShowCardActionMode est défini sur popup.

Afficher une carte

Une fois que vous avez acquis une charge utile de carte, appelez simplement le renderer et transmettez la carte. Vous récupérerez un objet d’interface utilisateur natif composé du contenu de la carte. Maintenant, placez 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 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, etc.

Style de plateforme native

La plupart des frameworks d’interface utilisateur vous permettent de mettre en forme la carte rendue à l’aide du style d’infrastructure d’interface utilisateur natif. Par exemple, en HTML, vous pouvez spécifier des classes CSS pour le code HTML, ou en XAML, vous pouvez transmettre un ResourceDictionary personnalisé pour un contrôle précis de la sortie.

Personnaliser le rendu par élément

Chaque Kit de développement logiciel (SDK) vous permet de remplacer le rendu de n’importe quel élément, ou même d’ajouter la prise en charge des éléments entièrement nouveaux que vous définissez. Par exemple, vous pouvez modifier le Input.Date renderer pour émettre votre propre contrôle personnalisé tout en conservant le reste de la sortie du renderer. Vous pouvez également ajouter la prise en charge d’un élément personnalisé Rating que vous définissez.