Contrôle Carte dans Power Apps

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

Description

Les contrôles Afficher le formulaire et Modifier le formulaire jouent le rôle de conteneurs pour l’affichage d’enregistrements complets. Chaque conteneur peut inclure un ensemble de contrôles Carte qui affichent des champs individuels ou offrent un moyen de mettre à jour ces champs. Chaque carte présente une propriété DataField qui spécifie le champ de l’enregistrement pour lequel il fonctionne.

Il existe des cartes prédéfinies pour différents types de données et expériences utilisateur. Par exemple, il peut y avoir une carte permettant de modifier un champ numérique à l’aide d’un contrôle Saisie de texte, ce qui est idéal pour une utilisation avec le clavier. Une autre carte peut prendre en charge la modification d’un nombre en utilisant un contrôle Curseur à la place. Lorsque le contrôle Form est sélectionné, vous pouvez facilement sélectionner une carte en fonction d’un champ dans le volet droit.

Les cartes peuvent elles-mêmes contenir des contrôles. Les contrôles d’une carte composent l’expérience d’affichage et de modification d’un champ unique. Par exemple, une carte numérique peut comprendre un contrôle Étiquette pour fournir le nom d’affichage du champ et un contrôle Saisie de texte pour fournir un éditeur pour la valeur du champ. La carte peut également avoir un contrôle Étiquette qui affiche les erreurs de validation qui se produisent et un contrôle Étiquette pour l’astérisque habituel indiquant qu’un champ est obligatoire.

Vous pouvez personnaliser les contrôles d’une carte prédéfinie en la redimensionnant, en la déplaçant, en la masquant, en y ajoutant des contrôles et en apportant d’autres modifications. Vous pouvez également commencer avec une carte complètement 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 pouvez modifier uniquement certaines propriétés du contrôle ou les contrôles qu’elle contient. Vous ne pouvez pas la supprimer. Vous pouvez afficher le verrou de la carte et le déverrouiller dans l’onglet Affichage de la vue Avancé. Si une propriété est verrouillée et ne peut pas être modifiée, elle s’affiche avec une icône de verrou en regard de son nom. Le déverrouillage d’une carte est une opération avancée qui doit être effectuée avec précaution, car la génération de formule automatique ne se fera plus pour la carte, et il n’est pas possible de verrouiller à nouveau 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 de manière à faire référence aux propriétés d’une carte. Par exemple, un contrôle doit utiliser Parent.Default pour lire l’état initial du champ dans la source de données. Lorsque vous utilisez Parent au lieu d’accéder directement aux informations souhaitées, la carte est mieux encapsulée et vous pouvez changer le champ sans rompre les formules internes.

Pour obtenir des exemples sur la personnalisation, le déverrouillage et la création de cartes, consultez Comprendre les cartes de données.

Propriétés clés

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

• Le nom doit être une chaîne statique unique placée entre guillemets (par exemple, "Name"), et non une formule.
• Supprimez la liaison d’une carte en définissant sa propriété DataField sur blank. Les propriétés Valid et Update sont ignorées pour les cartes non liées.

Default  : 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 contrôle Curseur sur Parent.Default pour vous assurer que l’utilisateur démarre avec une valeur générique pour le curseur correspondant.

DisplayMode : les valeurs peuvent être Edit, View ou Disabled. Détermine si le contrôle à l’intérieur de la carte autorise l’entrée utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).

• Permet d’utiliser une même carte dans les formulaires de modification et d’affichage, en configurant cette propriété, qui est liée au comportement du formulaire par défaut.
• Dans le mode Affichage, les contrôles enfants tels que Saisie de texte, Liste déroulante, Sélecteur de dates affichent uniquement la valeur de texte et ne restituent ni les décorations ni les éléments interactifs.

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 que contient la carte doivent utiliser Parent.DisplayName pour faire référence au nom du champ.

Error : message d’erreur convivial à afficher pour ce champ lorsque la validation échoue.

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

Required : indique si une carte, qui modifie 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 que contient la carte doivent utiliser Parent.Required pour déterminer si ce champ de la carte est requis.

Update : valeur à écrire dans la source de données pour un champ.

• Utilisez la formule de cette propriété pour extraire les valeurs des contrôles de modification de la carte afin de les é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 issue du curseur de cette carte.

Width  : distance entre les côtés droit et gauche d’un contrôle.

WidthFit  : indique si un contrôle s’agrandit automatiquement dans le sens horizontal pour remplir l’espace vide d’un contrôle Conteneur tel qu’un contrôle Modifier le formulaire. Si plusieurs cartes ont cette propriété définie sur true, l’espace est réparti entre elles. Pour plus d’informations, voir Comprendre la mise en page du formulaire de données.

Propriétés supplémentaires

BorderColor  : couleur de bordure du contrôle.

BorderStyle  : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.

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

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

Height  : distance entre le haut et le bas d’un contrôle.

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

Visible  : indique si un contrôle est visible 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 comprenant 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 comprenant plusieurs lignes, cette propriété détermine la ligne dans laquelle la carte s’affiche.

Exemples

Pour obtenir des exemples, voir Comprendre les cartes de données et Comprendre la mise en page du formulaire de données.

Instructions d’accessibilité

Contraste des couleurs

Il doit exister un contraste des couleurs adéquat entre :

• Fill et ses contrôles enfants. Par exemple, si une carte contient un champ Étiquette et que l’étiquette a un remplissage transparent, alors le contrôle Fill de la carte devient la couleur d’arrière-plan de l’étiquette. Par conséquent, il doit exister un contraste adéquat entre le contrôle Fill de la carte et le contrôle Color de l’étiquette.

Prise en charge du lecteur d’écran

• DisplayName doit être présent.