Contrôle de carte dans Power Apps

Fournit l’expérience d’affichage et de modification d’un champ unique d’un formulaire d’affichage ou d’un contrôle de formulaire Modifier .

Descriptif

Les contrôles de formulaire d’affichage et de modification de formulaire agissent en tant que conteneurs pour l’affichage et l’affichage des enregistrements entiers. Chaque conteneur peut contenir un ensemble de contrôles de carte qui affichent des champs individuels ou permettent de mettre à jour ces champs. Chaque carte a une propriété DataField qui spécifie le champ de l’enregistrement sur lequel elle fonctionne.

Les cartes prédéfinies sont définies pour différents types de données et expériences utilisateur. Par exemple, il peut y avoir une carte pour modifier un champ numérique avec un contrôle d’entrée de texte , qui est idéal pour une utilisation avec le clavier. Une autre carte peut prendre en charge la modification d’un nombre à l’aide d’un contrôle Slider à la place. Une fois le contrôle de formulaire sélectionné, vous pouvez, dans le volet de droite, sélectionner facilement une carte en fonction d’un champ.

Les cartes elles-mêmes contiennent des contrôles. Les contrôles d’une carte constituent l’expérience d’affichage et de modification d’un seul champ. Par exemple, une carte numérique peut se composer d’un contrôle Label pour fournir le nom complet du champ et un contrôle d’entrée de texte pour fournir un éditeur pour la valeur du champ. La carte peut également avoir un contrôle Label qui affiche les erreurs de validation qui se produisent et un contrôle Label pour l’astérisque commun pour indiquer qu’un champ est requis.

Vous pouvez personnaliser les contrôles d’une carte prédéfinie en le redimensionnant, en le déplaçant, en le masquant, en y ajoutant des contrôles et en apportant d’autres modifications. Vous pouvez également commencer par une carte entièrement vide, une « carte personnalisée », à laquelle vous ajoutez des contrôles à partir de zéro.

Les cartes prédéfinies sont verrouillées par défaut. Dans une carte verrouillée, vous ne pouvez modifier que certaines propriétés de la carte ou des contrôles de la carte, et vous ne pouvez pas supprimer une carte verrouillée. Vous pouvez afficher le verrou de carte et le déverrouiller sous l’onglet Affichage de l’affichage avancé . Si une propriété est verrouillée et ne peut pas être modifiée, elle apparaît avec une icône de verrou en regard de son nom. Le déverrouillage d’une carte est une activité avancée et doit être effectué avec soin, car la génération automatique de formule ne se produit plus pour la carte, et vous ne pouvez pas verrouiller une carte.

Dans le conteneur du formulaire, l’enregistrement ThisItem est disponible et contient tous les champs de l’enregistrement. Par exemple, la propriété Default de la carte est souvent définie sur ThisItem. FieldName.

Vous pouvez utiliser la référence Parent pour configurer un contrôle pour référencer les propriétés d’une carte. Par exemple, un contrôle doit utiliser Parent.Default pour lire l’état initial du champ à partir de la source de données. En utilisant Parent au lieu d’accéder directement aux informations souhaitées, la carte est mieux encapsulée et vous pouvez la modifier en un autre champ sans interrompre les formules internes.

Consultez Comprendre les cartes de données pour obtenir des exemples de personnalisation, de déverrouillage et de création de cartes.

Propriétés principales

DataField : nom du champ dans un enregistrement que cette carte affiche et modifie.

• Spécifiez le nom sous la forme d’une chaîne statique unique placée entre guillemets doubles (par exemple, « Nom »), et non une formule.
• Annulez la liaison d’une carte en définissant sa propriété DataFieldvide. Les propriétés Valide et Mise à jour sont ignorées pour les cartes non liées.

Valeur par défaut : valeur initiale d’un contrôle avant sa modification par l’utilisateur.

• Pour chaque contrôle d’une carte, définissez cette propriété sur Parent.Default pour faire référence à la valeur par défaut du champ en fonction de la source de données. Par exemple, définissez la propriété Default d’un curseur sur Parent.Default pour vous assurer que l’utilisateur commence par une valeur générique pour ce curseur.

DisplayMode : les valeurs peuvent être modifiées, affichées ou désactivées. Configure si le contrôle à l’intérieur de la carte autorise l’entrée utilisateur (Modifier), affiche uniquement les données (Affichage) ou désactivées (Désactivé).

• Permet à une carte unique d’être utilisée dans les formulaires d’édition et d’affichage, en configurant cette propriété, qui est liée au comportement du formulaire par défaut.
• En mode Affichage , les contrôles enfants tels que l’entrée de texte, la liste déroulante, le sélecteur de dates affichent uniquement la valeur du texte et n’affichent pas d’éléments interactifs ou de décorations.

DisplayName : nom convivial d’un champ dans une source de données.

• La fonction DataSourceInfo fournit ces métadonnées à partir de la source de données.
• Les contrôles de la carte doivent utiliser Parent.DisplayName pour faire référence au nom du champ.

Erreur : message d’erreur convivial à afficher pour ce champ en cas d’échec de la validation.

• Cette propriété est définie lorsque SubmitForm est appelé.
• Le message décrit les problèmes de validation en fonction des métadonnées de la source de données et de la vérification de la propriété Required de la carte.

Obligatoire : indique si une carte, en modifiant le champ d’une source de données, doit contenir une valeur.

• La fonction DataSourceInfo fournit les métadonnées requises à partir de la source de données.
• Les contrôles de la carte doivent utiliser Parent.Required pour déterminer si le champ de cette carte est requis.

Mise à jour : valeur à réécrire dans la source de données d’un champ.

• Utilisez la formule de cette propriété pour extraire les valeurs des contrôles d’édition de la carte afin de réécrire dans la source de données. Par exemple, définissez la propriété Update d’une carte sur Slider.Value pour mettre à jour la source de données avec une valeur du curseur dans cette carte.

Largeur : distance entre les bords gauche et droit d’un contrôle.

WidthFit : indique si un contrôle augmente automatiquement horizontalement pour remplir un espace vide dans un contrôle conteneur tel qu’un contrôle de formulaire Modifier . Si plusieurs cartes ont cette propriété définie sur true, l’espace est divisé entre eux. Pour plus d’informations, consultez Présentation de la disposition du formulaire de données.

Propriétés supplémentaires

BorderColor : couleur de la bordure d’un contrôle.

BorderStyle : indique si la bordure d’un contrôle est Solid, Dashed, Dotted ou None.

BorderThickness : épaisseur de la bordure d’un contrôle.

Remplissage : couleur d’arrière-plan d’un contrôle.

Hauteur : distance entre les bords supérieurs et inférieurs d’un contrôle.

Valide : indique si un contrôle de formulaire Carte ou Modifier contient des entrées valides, prêtes à être soumises à la source de données.

Visible : indique si un contrôle apparaît ou est masqué.

X : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou de l’écran à défaut de conteneur parent). Pour un contrôle Carte dans un conteneur qui a plusieurs colonnes, cette propriété détermine la colonne dans laquelle la carte s’affiche.

Y : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou de l’écran à défaut de conteneur parent). Pour un contrôle Carte dans un conteneur qui a plusieurs lignes, cette propriété détermine la ligne dans laquelle la carte apparaît.

Examples

Consultez Comprendre les cartes de données et comprendre la disposition du formulaire de données pour obtenir des exemples.

Conseils sur l’accessibilité

Contraste des couleurs

Il doit y avoir un contraste de couleur adéquat entre :

• Remplissez et n’importe quel contrôle enfant. Par exemple, si une carte contient une étiquette et que l’étiquette a un remplissage transparent, le remplissage de la carte devient effectivement la couleur d’arrière-plan de l’étiquette. Par conséquent, il doit y avoir un contraste adéquat entre le remplissage de la carte et la couleur de l’étiquette.

Prise en charge du lecteur d’écran

• DisplayName doit être présent.