Téléverseur de fichiers
<gcds-file-uploader>

Autres noms : fichiers téléversés, saisie de fichier, zone de dépôt

Un téléverseur de fichier est un espace où il est possible de sélectionner et d'ajouter des documents à l'appui.

• GitHub
• Figma

Création d'un téléverseur de fichiers

Utilisez le téléverseur de fichiers pour permettre à une personne de sélectionner et de valider les fichiers qu'elle souhaiterait inclure dans sa soumission.

Codage et accessibilité du téléverseur de fichiers

Appliquez les attributs requis

Pour que le téléverseur de fichiers fonctionne correctement, utilisez toujours les attributs suivants avec <gcds-file-uploader>:

• name
• label
• uploader-id

Traiter les messages d'erreur et la validation

• Utilisez l'attribut required pour activer le valideur de champ obligatoire. La validation s'effectuera par défaut pendant l'évènement onBlur. Une réponse manquante ou non valide affichera un message d'erreur intercalé prédéfini.

• Si vous devez modifier l'évènement de validation, utilisez l'attribut validate-on. La validation peut se produire pendant l'évènement onBlur, lorsque l'élément perd son état ciblé, ou de façon manuelle avec la méthode validate().

• Utilisez l'attribut required pour les champs qui doivent obligatoirement être remplis. La mention « obligatoire » sera alors ajoutée à la fin de l'étiquette.

• Utilisez l'attribut error-message pour inclure un message d'erreur pour tous les champs de saisie obligatoires. Évitez d'utiliser des messages d'erreur pour les champs de saisie facultatifs.

• Pour les champs facultatifs, évitez d'ajouter l'attribut error-message.

• Pour un champ facultatif nécessitant une validation qui dépend de ce que l'utilisateur a saisi (par exemple pour valider un format d'adresse courriel), ajoutez plutôt une validation et un message d'erreur personnalisés.

Téléchargez plusieurs fichiers

Utilisez l'attribut multiple pour permettre la sélection de plus d'un fichier.

Validez les types de fichiers à téléverser

Utilisez l'attribut accept pour définir les types de fichiers acceptés par le téléverseur de fichiers.

Obtenez votre code

Générez une version du composant dont vous avez besoin en sélectionnant les propriétés de code correspondantes ou explorez les possibilités en choisissant différentes valeurs de code.

1. Choisissez des valeurs de code pour obtenir l'élément que vous voulez.

2. Obtenez le code et intégrez-le dans votre environnement.

3. Ajoutez tout contenu nécessaire au composant (comme le texte du libellé).

Remarque : Conformément à la pratique courante, le générateur de code utilise l'anglais pour tous les éléments de code.