Propriétés du composant de canevas

Les composants de canevas permettent aux créateurs de créer différents types de propriétés pour transmettre des valeurs ou une logique entre le composant et l’application qui héberge le composant. Les propriétés sont essentielles pour construire des composants interactifs et réutilisables.

Prérequis

Cette fonctionnalité est activée par défaut pour les nouvelles applications. Pour les applications existantes, vous devez l’activer dans les paramètres de votre application.

1. Ouvrez votre application canevas pour l’édition dans Power Apps Studio. Sur la barre de commandes, sélectionnez Paramètres>Mises à jour.

2. Dans l’onglet Nouveau, recherchez et activez le paramètre Propriétés de composant améliorées.

Types de propriétés

Quatre types de propriétés sont disponibles pour les créateurs.

1. Propriétés des données : les propriétés des données se rapportent aux données, comme une valeur de couleur ou de texte. Une propriété Données peut être définie sur Entrantes ou Sortantes, qui indique si le composant fournit des données à l’application (Sortantes) ou si l’application fournit des données au composant (Entrantes). Les propriétés de données sont les seules propriétés qui participent au flux de données de l’application.
2. Propriétés de fonction : les propriétés de fonction sont liées à la logique, comme effectuer un calcul basé sur des paramètres spécifiques ou modifier du texte. Une propriété Fonction peut être définie sur Entrantes ou Sortantes, qui indique si le composant fournit une fonction que l’application peut appeler (Sortantes) ou l’application fournit une fonction que le composant peut appeler (Entrantes). Les propriétés Fonction ne participent pas au flux de données d’une application et ne peuvent pas utiliser de variables de composant ou d’application.
3. Propriétés d’action : les propriétés d’action sont un type de propriété qui traite de la logique et se comporte comme une Fonction de Sortie. Ainsi, le composant a la logique définie, et cette logique peut utiliser des expressions chaînées et manipuler des collections ou des variables (« comportement »). Par exemple, une propriété ActionClear()peut fournir une fonctionnalité que l’application peut appeler pour effacer certaines valeurs dans le composant, ou une propriété ActionSave() qui met à jour une source de données.
4. Propriétés d’événement : les propriétés d’événement sont une catégorie de propriété qui implique une logique et fonctionne comme une Fonction d’Entrée. Ainsi, l’application définit la logique définie, que le composant peut appeler et cette logique peut utiliser des expressions chaînées et manipuler des collections ou des variables (« comportement »). Généralement, les noms de ces propriétés reflètent un événement tel que OnSelect ou OnChanged.

Propriété de données

L’utilisation d’une propriété de données est facile à imaginer. Les contrôles standard dans les applications ont généralement plusieurs propriétés de données, pour définir les valeurs par défaut, la couleur du texte, la taille, etc. Examinons un exemple simple où vous souhaitez mettre les propriétés d’un contrôle au sein du composant à la disposition de l’application hôte. Dans cet exemple, le composant est nommé Component1. Placez un contrôle de curseur à l’intérieur du composant. Ajoutez une propriété Input pour spécifier la couleur de l’application de consommation et une propriété Output pour que le composant puisse indiquer à l’application la valeur actuelle du curseur. Cet exemple suppose que le composant dispose d’un contrôle Curseur nommé Slider

1. Dans le volet de propriété du composant, sélectionnez Nouvelle propriété personnalisée.
2. Dans le volet Nouvelle propriété personnalisée , saisissez le nom complet Slider Color.
3. Sélectionnez Type de propriété de Données et sélectionnez la valeur Définition de propriétéentrante.
4. Dans la liste déroulante Type de données, sélectionnez Couleur.
5. Sélectionnez Créer.

Ensuite, sélectionnez le contrôle CurseurSlider1. Recherchez sa propriété ValueFill et dans la barre de formule, saisissez Component1.SliderColor. Component1 est le nom du composant et SliderColor est le nom de la propriété que vous avez ajoutée.

À présent, le composant dispose d’une propriété SliderColor qui peut être définie dans l’application de consommation pour transmettre une couleur au composant et définir la propriété ValueFill du curseur.

Vous pouvez également fournir la valeur du curseur à l’application consommatrice. Pour ce faire, ajoutez une propriété Output.

1. Dans le volet de propriété du composant, sélectionnez Nouvelle propriété personnalisée.
2. Dans le volet Nouvelle propriété personnalisée , saisissez le nom complet Slider Value.
3. Sélectionnez Type de propriété de Données et sélectionnez la valeur Définition de propriétésortante.
4. Dans la liste déroulante Type de données, sélectionnez Numéro.
5. Sélectionnez Créer.

Lorsqu’une propriété Données est sortante, le composant fournit la valeur à l’application consommatrice. Pour définir la formule, définissez la nouvelle propriété SliderValue du composant sur la propriété Value du curseur.

1. Dans le volet de propriété du composant, cliquez sur la propriété Slider Value.
2. Dans la barre de formule à droite, remplacez la valeur par défaut de 100avec la formule suivante : Slider1.Value.

À présent, la propriété SliderValue du composant reflète la valeur du curseur au sein du composant, que l’application de consommation peut lire.

Propriété Fonction

Une propriété de fonction contient une expression qui renvoie une valeur. En règle générale, la fonction accepte les arguments qu’elle utilise pour calculer la valeur à renvoyer.

Nonte

Les propriétés de fonction ne peuvent actuellement pas accéder aux variables ou aux valeurs et propriétés des composants, et ne peuvent pas déclencher de flux de données. Toutes les valeurs requises doivent être transmises en tant qu’arguments.

Une fonction sortante est un moyen simple de créer une fonction personnalisée pour Power Apps. Le composant définit une fonction sortante avec une expression qui prend des arguments et renvoie une valeur. Cette fonction peut ensuite être utilisée dans une application en utilisant le nom du composant (par exemple Component1) en appelant Component1.MyFunction(arg1, arg2).

Une fonction Input permet à une application de consommation de fournir une logique à un composant, similaire à un pointeur de fonction ou à une fonction de rappel. Par exemple, si le composant fonctionne avec des noms de personnes, il peut avoir une fonction d’entrée avec des arguments firstname et lastname et attend une chaîne en retour. L’application peut définir l’expression de fonction pour renvoyer $"{firstname} {lastname}" ou $"{lastname}, {firstname}". Le composant appelle la fonction fournie par le créateur de l’application et utilise la chaîne renvoyée.

Propriété Action

Les propriétés d’action sont similaires aux propriétés de fonction de type Output, mais elles autorisent les formules d’effets secondaires et le chaînage d’expressions. Un composant peut avoir une propriété d’action nommée AddRecord qui permet à l’application d’ajouter un enregistrement à une collection dans le composant, ou une action Reset qui efface des variables ou des collections dans le composant.

Dans l’exemple de curseur précédent pour la propriété Data, vous pouvez ajouter une propriété d’action appelée ResetValue pour rétablir le curseur sur sa valeur par défaut. Utilisez la formule Reset( Slider1 ) à cet effet. À présent, les instances du composant dans l’application peuvent appeler Component1.ResetValue() pour rétablir la valeur par défaut du curseur.

Propriété Event

De nombreux contrôles standard ont des propriétés communes de type Event, qui sont des propriétés de fonction de comportement d’entrée. OnSelect sur le contrôle de bouton est un exemple courant. Un composant peut définir des propriétés d’événement et appeler ces événements comme une fonction. Par exemple, un composant avec un contrôle de bouton peut avoir une propriété d’événement nommée OnButtonClicked. Dans la propriété OnSelect du contrôle de bouton, le composant peut appeler sa propriété Component1.OnButtonClicked(). Une application consommatrice peut définir sa propre logique pour que cette propriété agisse lorsque le bouton à l’intérieur du composant est enfoncé.

Valeurs par défaut des propriétés ou des arguments

Les valeurs par défaut donnent une valeur à un argument ou à une propriété si aucune n’est définie. Cela n’a pas de sens pour certains types de propriétés. Dans certains cas, vous pouvez utiliser les valeurs par défaut pour afficher le schéma attendu pour un enregistrement. En fournissant un enregistrement par défaut, vous définissez le type d’enregistrement comme schéma attendu.

Par exemple, une propriété Action nommée AddRecord utilise un enregistrement pour l’ajouter à une collection locale. Pour afficher le schéma de l’enregistrement attendu, ajoutez une valeur par défaut pour l’argument de la propriété AddRecord.