vue-file-upload-library

Vue JS 3 single/multiple file uploader. We Just need to pass configuration as an input all the work handle by uploader component based on passed configuration

Usage no npm install needed!

<script type="module">
  import vueFileUploadLibrary from 'https://cdn.skypack.dev/vue-file-upload-library';
</script>

README

Vue JS single/multipe file uploader

Vue JS 3 single/multiple file uploader. We Just need to pass configuration as an input all the work handle by uploader component based on passed configuration

Features

  • Multiple File Uploads
  • Max File Size, Accepted file types validation
  • differentiate valid/invalid files as per passed cofiguration
  • We can passed files type what we want to upload
  • Upload files on the basis of passed configuration
  • File input with drag and drop with support for folders
  • Provide lot of other methods so that we can handle files as per our requirements
  • Default uploader with progress
  • Externally controllable via Vue bindings and methods

How we use Vue js file uploader in our application

Basic Usage

  <FileUploader
      ref="fileUploader"
      :multiple="true"
      :config="config"
      @fileUploadEmitter="fileUploadHandler($event)"
      @filesEmitter="handleFiles($event)"
    /></FileUploader>

config should be in below format

config: {
        maxSize: 10,
        uploadConfig: {
          url: "test url",
          method: "POST",
          userRef: "test user",
        },
        formatsAllowed: ".jpg, .png, .mp4"
      }
we can pass uploadConfig in case we want to upload files from uploader. fileUploadEmitter event will trigger in case success/failure with the service response. Max Size will used user to restrict files upload within provide files size. Our uploader will consider maxSize in MB. formatsAllowed will be use in case we want user to restrict file types to upload
Input Type Purpose
multiple:required boolean true in case we want to upload multiple files otherwise false
config: required object File Configurations

Events

Output Purpose
fileUploadEmitter Trigger in case we are trying to upload files using file uploader, we can upload files using component own handler as well
filesEmitter Trigger every time when user select files, reset files, remove particular file with provide information number of valid/invalid files
fileUploadEmitter always return data in this format
this.$emit("fileUploadEmitter", { success: true, response: result });
this will work in case we are handling file upload from uploader by passing upload url in configuration.
success true means files are uploaded, false means some errors from service
filesEmitter always return data in this format
this.$emit("filesEmitter", {
        validFiles: this.allowedFiles,
        invalidFiles: this.notAllowedFiles,
      });
<script>
  export default {
    data() {
      return {
        // ...
        fileRecords: [],
        config: {
        maxSize: 10,
        uploadConfig: {
          url: "test url",
          method: "POST",
          userRef: "test user, this is user token we will use as a bearer",
        },
        formatsAllowed: ".jpg, .png, .mp4",
      }
        // ...
      };
    },
    // ...
  };
</script>

Installation

npm install vue-file-upload-library --save
import Vue from 'vue';
import FileUploader from 'vue-file-upload-library';

Vue.use(VueFileAgent);

how we use uploader component methods

As we can see we are creating file uploader component object above which is 'fileUploader'. We will use this object to access file uploader methods
1. Suppose we have selected 10 files and want to remove one of them. we will use removeValidFiles() method like this.
this.$refs.fileUploader.removeValidFiles(fileIndex)
2. Suppose we have selected some files to be upload and one of them are invalid like size exceed and we want to remove these files. we will use removeInvalidFiles() method like this.
this.$refs.fileUploader.removeInvalidFiles(fileIndex)
Both of the above methods will return emitter with the updated count of files like this:
this.$emit("filesEmitter", {
        validFiles: this.allowedFiles,
        invalidFiles: this.notAllowedFiles,
      });
3. We want to remove all the files we have selected, we will use
this.$refs.fileUploader.resetFiles(fileIndex). This method will return emitter with updated files like this:
this.$emit("filesEmitter", {
        validFiles: this.allowedFiles,
        invalidFiles: this.notAllowedFiles,
      });
4. Suppose we want to upload files using file uploader component, we just need to use that particular method:
this.$refs.fileUploader.fileUpload()
to execute this method properly we need to pass apiUrl, method and logged in user token in the configuration. Refer to config format in the starting of our read me file

License

The MIT License