Contrôle Documents joints dans Power Apps

Article
09/29/2023

Un contrôle qui permet aux utilisateurs de télécharger des fichiers sur leur appareil, ainsi que d’importer et de supprimer des fichiers d’une liste créée à l’aide de Microsoft Listes, ou d’une table Microsoft Dataverse.

Description

Un contrôle Documents joints vous permet d’ouvrir, d’ajouter et de supprimer des fichiers depuis une liste ou une table Dataverse.

Limitations

Le contrôle Attachment a les limitations suivantes :

Le contrôle Attachment ne prend en charge que les listes et les tables Dataverse comme sources de données. Les expressions qui transforment ces sources de données en tableaux, par exemple avec la fonction ForAll, ne sont pas prises en charge.
Les fonctionnalités de chargement et de suppression ne fonctionnent qu’à l’intérieur d’un formulaire. Le contrôle Attachment semble désactivé quand il est en mode Édition, mais pas à l’intérieur d’un formulaire. Pour enregistrer les ajouts et suppressions de fichiers, l’utilisateur de l’application doit enregistrer le formulaire. En raison de cette limitation, le contrôle Attachment n’est pas disponible à partir de l’onglet Insérer, mais apparaît dans le formulaire lorsque le champ Formulaire de pièce jointe est activé dans un formulaire SharePoint ou Dataverse.
Le contrôle Documents joints sur un navigateur web vous permet de sélectionner plusieurs fichiers et d’utiliser la fonctionnalité de glisser-déposer. Cependant, lorsque vous utilisez le contrôle Documents joints sur Power Apps Mobile, vous ne pouvez ajouter qu’un seul fichier à la fois.

Propriétés clés

Items – La colonne Pièce jointe de la liste ou de la table Dataverse. Les Collections et les Tables ne sont pas prises en charge.

MaxDocuments joints : nombre maximal de fichiers que le contrôle peut accepter.

MaxDocuments jointsize : taille maximale en Mo autorisée pour chaque nouvelle pièce jointe. 1 Mo ici correspond à 1 000 000 octets (10⁶ B) ou 1 000 Ko.

OnAddFile – Actions à effectuer quand l’utilisateur ajoute un fichier en pièce jointe.

OnRemoveFile – Actions à effectuer quand l’utilisateur supprime une pièce jointe.

OnUndoRemoveFile – Actions à effectuer quand l’utilisateur restaure une pièce jointe supprimée.

Propriétés supplémentaires

AccessibleLabel : Étiquette pour les lecteurs d’écran. Doit décrire l’objectif des pièces jointes.

AddAttachmentText : texte d’étiquette du lien utilisé pour ajouter une nouvelle pièce jointe.

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.

Color : couleur du texte dans un contrôle.

DisabledBorderColor : indique la couleur de bordure d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledColor : couleur du texte d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledFill : indique la couleur d’arrière-plan d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisplayMode : indique si le contrôle autorise l’ajout et la suppression de fichiers (Edit), affiche uniquement des données (View) ou est désactivé (Disabled).

[DropTargetBackgroundColor] : indique la couleur de l’arrière-plan de la cible de dépôt du contrôle.

[DropTargetBorderColor] : indique la couleur de la bordure cible de dépôt du contrôle.

[DropTargetBorderStyle] : indique si la bordure cible de dépôt du contrôle est Uni, Discontinu, Pointillé ou Aucun.

[DropTargetBorderThickness] : indique l’épaisseur de la bordure cible de dépôt du contrôle.

[DropTargetTextColor] : indique la couleur du texte cible de dépôt du contrôle.

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

FocusedBorderColor : indique la couleur de bordure d’un contrôle lorsque le contrôle est actif.

FocusedBorderThickness : épaisseur de bordure d’un contrôle lorsque le contrôle est actif.

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

Font : nom de la famille de polices dans laquelle le texte s’affiche.

FontWeight : indique l’épaisseur du texte dans un contrôle : Gras, Semibold, Normal, ou Plus claire.

HoverBorderColor : couleur de bordure d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

HoverColor : couleur du texte d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

HoverFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

Italic : indique si le texte d’un contrôle est en italique.

MaxDocuments jointsText : indique le texte qui remplace le lien « Joindre un fichier » lorsque le contrôle contient le nombre maximal de fichiers autorisés.

NoDocuments jointsText : indique le texte d’information présenté à l’utilisateur quand il n’y a aucun fichier joint.

Padding : distance entre le texte sur un bouton d’importation ou d’exportation et les bords de ce bouton.

PressedBorderColor : couleur de bordure d’un contrôle lorsque l’utilisateur le sélectionne.

PressedColor : couleur de texte d’un contrôle lorsque l’utilisateur le sélectionne.

PressedFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur le sélectionne.

Reset : rétablit toutes les modifications apportées au contrôle Documents joints en revenant à l’état précédemment enregistré.

Size : taille de police du texte qui apparaît sur un contrôle.

Barré : indique si une ligne s’affiche sur le texte qui apparaît sur un contrôle.

TabIndex : ordre de navigation à l’aide du clavier par rapport à d’autres contrôles.

Info-bulle : texte explicatif qui s’affiche lorsque l’utilisateur pointe sur un contrôle.

Underline : indique si une ligne s’affiche sous le texte qui apparaît sur un contrôle.

Visible : indique si un contrôle est visible ou masqué.

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

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).

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).

Exemple

Ajoutez un formulaire à votre application et définissez une liste en tant que source de données.
Dans l’arborescence du côté gauche, sélectionnez le contrôle Formulaire d’affichage. Vous pouvez aussi utiliser Modifier le formulaire en lieu et place.
Sélectionnez Data Source dans l’onglet Propriétés du panneau d’options à droite, puis sélectionnez la liste à laquelle vous vous êtes connecté.
Sélectionnez Modifier les champs dans la section Champs et sélectionnez Ajouter le champ.
Sélectionnez le champ Pièces jointes, puis Ajouter.

Le champ Pièces jointes associé à la liste s’affiche dans le formulaire.

Découvrez comment ajouter et configurer un contrôle

Instructions d’accessibilité

Contraste des couleurs

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

ItemColor et ItemFill
ItemHoverColor et ItemHoverFill
ItemPressedColor et ItemPressedFill
AddedItemColor et AddedItemFill
RemovedItemColor et RemovedItemFill
ItemErrorColor et ItemErrorFill
AddAttachmentColor et Fill
MaxDocuments jointsColor et Fill
NoDocuments jointsColor et Fill

Cette condition s’ajoute à la configuration requise du contraste des couleurs.

Prise en charge du lecteur d’écran

Les propriétés suivantes doivent être présentes :

AccessibleLabel
AddDocuments jointsText
MaxDocuments jointsText
NoDocuments jointsText

Prise en charge du clavier

TabIndex doit être égal ou supérieur à zéro afin que les utilisateurs du clavier puissent y accéder.
Les indicateurs de focus doivent être clairement visibles. Pour ce faire, utilisez FocusedBorderColor et FocusedBorderThickness pour plus de clarté.

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é).