Partager via

Élément control

  • Article

Définit l’espace de noms du composant, sa version et ses informations d’affichage.

Disponible pour

Applications pilotées par modèle et applications canevas

Paramètres

Nom Description Type Obligatoire Disponible pour
namespace Définit le prototype d’objet du composant Uniquement des lettres ou des chiffres Oui Applications pilotées par modèle et applications canevas
constructor Méthode pour initialiser l’objet Uniquement des lettres ou des chiffres Oui Applications pilotées par modèle et applications canevas
control-type Si le contrôle est un contrôle standard ou un contrôle React. La valeur de virtual indique un contrôle React utilisant la bibliothèque React de la plate-forme. Les commandes virtuelles sont une fonctionnalité de la préversion publique. Pour plus d’informations : Contrôles React et bibliothèques de plate-forme (version préliminaire) standard|virtual Non Applications pilotées par modèle et applications canevas
description-key Définit la description du composant qui sera visible sur l’interface utilisateur. string Non Applications pilotées par modèle et applications canevas
display-name-key Définit le nom du contrôle affiché sur l’interface utilisateur. string Oui Applications pilotées par modèle et applications canevas
preview-image Image qui sera utilisée dans les écrans de personnalisation pour afficher un aperçu du composant. string Non Applications pilotées par modèle
version Définit la version du composant définie dans Version sémantique string Oui Applications pilotées par modèle et applications canevas

Éléments parents

Élément Description
manifest Manifeste est le fichier de métadonnées qui définit un composant. Il s’agit d’un fichier XML qui décrit :
  • L’espace de noms du composant.
  • Le type de données qui peut être configuré, un champ ou un jeu de données.
  • Toutes propriétés qui peuvent être configurées dans l’application lorsque le composant est ajouté.
  • Une liste des fichiers de ressources dont le composant a besoin.
    • L’un d’eux doit être une ressource web TypeScript. Ce TypeScript doit inclure une fonction qui instanciera un objet. Cela implémente une interface qui expose les méthodes requises pour que le composant fonctionne. Celle-ci est appelée la bibliothèque d’implémentation de composant.
  • Le nom d’une fonction TypeScript dans la bibliothèque d’implémentation de composant qui renvoie un objet qui s’applique à l’interface de composants requise.
Lorsque l’utilisateur configure un composant personnalisé dans une application canevas ou une application pilotée par modèle, les données du manifeste filtrent les composants disponibles afin que seuls les composants valides pour le contexte soient disponibles pour la configuration. Les propriétés définies dans le manifeste pour un composant sont affichées sous forme de champs de configuration afin que l’utilisateur configurant le composant puisse spécifier des valeurs. Ces valeurs de propriété sont ensuite disponibles pour la fonction de composant au moment de l’exécution.

Éléments enfants

Élément Description Occurrences
data-set Le nœud jeu de données dans le manifeste de composant est une représentation configurable spécifique d’un ensemble d’enregistrements de table. 0 ou plus
external-service-usage Indique si ce contrôle utilise ou non un service externe. Si c’est le cas, définissez l’indicateur d’attribut activé sur true et ajoutez le domaine de service externe à la propriété <domain>. Un contrôle qui utilise n’importe quel service externe est un contrôle premium et l’utilisateur final aura besoin d’une licence Power Apps pour ouvrir une application comportant un contrôle premium. Pour plus d‘informations, voir : Licences 0 ou 1
propriété Le nœud property définit une partie spécifique et configurable de données que le composant attend de Microsoft Dataverse. 0 ou plus
resources Le nœud resources dans le manifeste du composant fait référence aux fichiers de ressources dont a besoin le composant pour implémenter son affichage. 1
type-group Le nœud type-group définit un ensemble de types identifiés par un nom unique. Ces informations peuvent être utilisées pour identifier les types de données pris en charge par une propriété spécifique. 0 ou plus
property-dependencies Définit un groupe d’éléments property-dependencies. 0 ou plus

Exemple

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

Référence du schéma de manifeste Power Apps component framework
Référence d’API Power Apps component framework
Vue d’ensemble de Power Apps component framework

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).