UploadWorkflow
Le pattern UploadWorkflow est utilisé pour permettre à l’utilisateur de sélectionner une liste de fichiers.
Utilisation
Nous avons mis à jour l’API du composant pour permettre une sélection libre, mais il est toujours possible d’utiliser l’ancienne API.
Exemples
Événements
Vous pouvez réagir lorsque la liste des fichiers est mise à jour en utilisant l’événement change, et réagir aux erreurs de validation en utilisant l’événement error.
Un seul fichier
Lorsque que la liste ne contient qu’un seul fichier, la boîte de dialogue demandant à l’utilisateur de choisir quel fichier il a sélectionné ne sera pas affichée.
Fichiers optionnels
Vous pouvez spécifier des fichiers optionnels en utilisant la propriété optional.
Bouton Afficher le fichier
Vous pouvez afficher un bouton permettant de visualiser un fichier sélectionné en utilisant la prop show-view-btn.
Il est toujours possible d’utiliser l’option showViewBtn du composant FileList pour afficher le bouton et personnaliser son comportement, mais ce fonctionnement est déprécié depuis la version 2.16.0 et sera supprimé dans la prochaine version majeure.
Mode sélection libre
Vous pouvez laisser l’utilisateur sélectionner le nombre de fichiers qu’il souhaite en ne spécifiant pas de liste de fichiers à sélectionner.
Prévisualisation des fichiers
Vous pouvez permettre à l’utilisateur de prévisualiser le fichier qu’il vient de sélectionner avant de valider en utilisant la prop show-file-preview.
Mode rétrocompatible
Vous pouvez toujours spécifier la liste des fichiers à sélectionner en utilisant le v-model.
Ce mode de fonctionnement est déprécié depuis la version 2.5.0 et sera supprimé dans la prochaine version majeure.
API
Personnalisation
Composants Vuetify
Vous pouvez personnaliser les composants Vuetify contenus dans le pattern UploadWorkflow en utilisant la prop vuetify-options.
Slots
Vous pouvez utiliser les slots title et modal-title pour remplacer le titre de la section et le titre de la modale de sélection du fichier, ainsi que le slot modal-description pour ajouter un texte supplémentaire dans la modale de sélection du fichier.