Contrôle Card dans PowerAppsCard control in PowerApps

Fournit l’expérience d’affichage et de modification d’un champ unique d’un contrôle Display form (Afficher le formulaire) ou Edit form (Modifier le formulaire).Provides the display and editing experience for a single field of a Display form or Edit form control.

DescriptionDescription

Les contrôles Display form (Afficher le formulaire) et Edit form (Modifier le formulaire) jouent le rôle de conteneurs pour l’affichage d’enregistrements complets.Display form and Edit form controls act as containers for displaying and viewing entire records. Chaque conteneur peut inclure un ensemble de contrôles Card (Carte) qui affichent des champs individuels ou offrent un moyen de mettre à jour ces champs.Each container can hold a set of Card controls that display individual fields or provide a way to update those fields. Chaque carte présente une propriété DataField qui spécifie le champ de l’enregistrement pour lequel il fonctionne.Each card has a DataField property that specifies which field of the record it works on.

Il existe des cartes prédéfinies pour différents types de données et expériences utilisateur.Predefined cards are defined for different data types and user experiences. Par exemple, il peut y avoir une carte permettant de modifier un champ numérique à l’aide d’un contrôle Text input (Entrée de texte), ce qui est idéal pour une utilisation avec le clavier.For example, there may be a card to edit a number field with a Text input control, which is great for use with the keyboard. Une autre carte peut prendre en charge la modification d’un nombre en utilisant un contrôle Slider (Curseur) à la place.Another card might support editing a number by using a Slider control instead. Lorsque le contrôle de formulaire est sélectionné, vous pouvez facilement sélectionner une carte en fonction d’un champ dans le volet droit.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

Les cartes peuvent elles-mêmes contenir des contrôles.Cards themselves contain controls. Les contrôles d’une carte composent l’expérience d’affichage et de modification d’un champ unique.The controls of a card make up the experience for displaying and editing a single field. Par exemple, une carte numérique peut comprendre un contrôle Label pour fournir le nom d’affichage du champ et un contrôle Text input pour fournir un éditeur pour la valeur du champ.For example, a number card may consist of a Label control to provide the display name of the field and a Text input control to provide an editor for the value of the field. 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 habituel indiquant qu’un champ est obligatoire.The card may also have a Label control that shows any validation errors that occur and a Label control for the common asterisk to indicate that a field is required.

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.You can customize the controls of a predefined card by resizing it, moving it, hiding it, adding controls to it, and making other changes. Vous pouvez également commencer avec une carte complètement vide, une « carte personnalisée », à laquelle vous ajoutez des contrôles à partir de zéro.You can also start with an entirely blank card, a "custom card", to which you add controls from scratch.

Les cartes prédéfinies sont verrouillées par défaut.Predefined cards are locked by default. 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.In a locked card, you can modify only certain properties of the card or the controls within the card, and you can't delete a locked card. Vous pouvez afficher le verrou de la carte et le déverrouiller dans l’onglet View (Affichage) de la vue Advanced (Avancé).You can show the card lock and unlock it on the View tab of the Advanced view. 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.If a property is locked and can't be modified, it appears with a lock icon next to its name. 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.Unlocking a card is an advanced activity and should be done with care, because automatic formula generation will no longer occur for the card, and you can't relock a card.

Dans le conteneur du formulaire, l’enregistrement ThisItem est disponible et contient tous les champs de l’enregistrement.Within the form's container, the ThisItem record is available and contains all the fields of the record. Par exemple, la propriété Default de la carte est souvent définie sur ThisItem.FieldName.For example, the card's Default property is often set to 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.You can use the Parent reference to configure a control to reference the properties of a card. Par exemple, un contrôle doit utiliser Parent.Default pour lire l’état initial du champ dans la source de données.For example, a control should use Parent.Default to read the initial state of the field from the data source. 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.By using Parent instead of directly accessing the information that you want, the card is better encapsulated, and you can change it to a different field without breaking internal formulas.

Pour obtenir des exemples sur la personnalisation, le déverrouillage et la création de cartes, consultez Comprendre les cartes de données.See Understand data cards for examples of how to customize, unlock, and create cards.

Principales propriétésKey properties

DataField : nom du champ d’un enregistrement que cette carte affiche et modifie.DataField – The name of the field within a record that this card displays and edits.

  • Le nom doit être une chaîne statique unique placée entre guillemets (par exemple, "Name"), et non une formule.Specify the name as a single static string that's enclosed in double quotation marks (for example, "Name"), not a formula.
  • Supprimez la liaison d’une carte en définissant sa propriété DataField sur blank.Unbind a card by setting its DataField property blank. Les propriétés Valid et Update sont ignorées pour les cartes non liées.The Valid and Update properties are ignored for unbound cards.

Default : valeur initiale d’un contrôle avant sa modification par l’utilisateur.Default – The initial value of a control before it is changed by the user.

  • 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.For each control in a card, set this property to Parent.Default to refer to the default value of the field according to the data source. Par exemple, définissez la propriété Default d’un contrôle Slider (Curseur) sur Parent.Default pour vous assurer que l’utilisateur démarre avec une valeur générique pour le curseur correspondant.For example, set a slider's Default property to Parent.Default to ensure that the user starts with a generic value for that slider.

DisplayMode : les valeurs peuvent être Edit, View ou Disabled.DisplayMode – Values can be Edit, View, or 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).Configures whether the control inside the card allows user input (Edit), only displays data (View) or is disabled (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.Allows a single card to be used in both edit and view forms, by configuring this property, which is tied to the Form's behavior by default.
  • Dans le mode View (Affichage), les contrôles enfants tels que Text input, Drop down, Date Picker affichent uniquement la valeur de texte et ne restituent ni les décorations ni les éléments interactifs.In View mode, child controls such as Text input, Drop down, Date Picker will only display the text value and will not render any interactive elements or decorations.

DisplayName : nom convivial d’un champ dans une source de données.DisplayName – The user friendly name for a field in a data source.

  • La fonction DataSourceInfo fournit ces métadonnées à partir de la source de données.The DataSourceInfo function provides this metadata from the data source.
  • Les contrôles que contient la carte doivent utiliser Parent.DisplayName pour faire référence au nom du champ.Controls within the card should use Parent.DisplayName to refer to the name of the field.

Error : message d’erreur convivial à afficher pour ce champ lorsque la validation échoue.Error – The user friendly error message to display for this field when validation fails.

  • Cette propriété est définie lorsque la fonction SubmitForm est appelée.This property is set when SubmitForm is called.
  • 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.The message describes validation problems based on the data source's metadata and checking the card's Required property.

Required : indique si une carte, qui modifie le champ d’une source de données, doit contenir une valeur.Required – Whether a card, editing the field of a data source, must contain a value.

  • La fonction DataSourceInfo fournit les métadonnées requises à partir de la source de données.The DataSourceInfo function provides the required metadata from the data source.
  • Les contrôles que contient la carte doivent utiliser Parent.Required pour déterminer si ce champ de la carte est requis.Controls within the card should use Parent.Required to determine whether that card's field is required.

Update : valeur à écrire dans la source de données pour un champ.Update – The value to write back to the data source for a field.

  • 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.Use this property's formula to pull the values from the edit controls of the card in order to write back to the data source. 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.For example, set a card's Update property to Slider.Value to update the data source with a value from the slider in that card.

Width : distance entre les côtés droit et gauche d’un contrôle.Width – The distance between a control's left and right edges.

WidthFit : indique si un contrôle s’agrandit automatiquement dans le sens horizontal pour remplir l’espace vide d’un contrôle de conteneur tel qu’un contrôle Edit form.WidthFit – Whether a control automatically grows horizontally to fill any empty space in a container control such as an Edit form control. Si plusieurs cartes ont cette propriété définie sur true, l’espace est réparti entre elles.If multiple cards have this property set to true, the space is divided between them. Pour plus d’informations, voir Comprendre la mise en page du formulaire de données.For more information, see Understand data form layout.

Propriétés supplémentairesAdditional properties

BorderColor : couleur de bordure du contrôle.BorderColor – The color of a control's border.

BorderStyle : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness : épaisseur de bordure d’un contrôle.BorderThickness – The thickness of a control's border.

Fill : couleur d’arrière-plan d’un contrôle.Fill – The background color of a control.

Height : distance entre le haut et le bas d’un contrôle.Height – The distance between a control's top and bottom edges.

Valid : indique si un contrôle Card (Carte) ou Edit form (Modifier le formulaire) contient des entrées valides, prêtes à être envoyées à la source de données.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

Visible : indique si un contrôle est visible ou est masqué.Visible – Whether a control appears or is hidden.

X : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou l’écran s’il n’y a pas de conteneur parent).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container). Pour un contrôle Card dans un conteneur comprenant plusieurs colonnes, cette propriété détermine la colonne dans laquelle la carte s’affiche.For a Card control in a container that has multiple columns, this property determines the column in which the card appears.

Y : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou l’écran s’il n’y a pas de conteneur parent).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container). Pour un contrôle Card dans un conteneur comprenant plusieurs lignes, cette propriété détermine la ligne dans laquelle la carte s’affiche.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

ExemplesExamples

Pour obtenir des exemples, voir Comprendre les cartes de données et Comprendre la mise en page du formulaire de données.See Understand data cards and Understand data form layout for examples.