vant/src/uploader

Uploader

Install

import Vue from 'vue';
import { Uploader } from 'vant';

Vue.use(Uploader);

Usage

Basic Usage

<van-uploader :after-read="afterRead" />

export default {
  methods: {
    afterRead(file) {
      console.log(file)
    }
  }
};

Preview File

<van-uploader v-model="fileList" multiple />

export default {
  data() {
    return {
      fileList: [
        { url: 'https://img.yzcdn.cn/vant/cat.jpeg' }
      ]
    }
  }
};

Max Count

<van-uploader
  v-model="fileList"
  multiple
  :max-count="2"
/>

export default {
  data() {
    return {
      fileList: []
    }
  }
};

Upload Style

<van-uploader>
  <van-button icon="photo" type="primary">Upload Image</van-button>
</van-uploader>

Before Read

<van-uploader :before-read="beforeRead" />

export default {
  methods: {
    beforeRead(file) {
      if (file.type !== 'image/jpeg') {
        Toast('Please upload an image in jpg format');
        return false;
      }
    
      return true;
    },

    asyncBeforeRead(file) {
      return new Promise((resolve, reject) => {
        if (file.type !== 'image/jpeg') {
          Toast('Please upload an image in jpg format');
          reject();
        } else {
          resolve();
        }
      });
    }
  }
}

API

Props

Attribute	Description	Type	Default
name	Input name	`string	number`
accept	Accepted file type	string	image/*
preview-image	Whether to show image preview	boolean	true
preview-size	Size of preview image	`string	number`
multiple	Whether to enable multiple selection pictures	boolean	false
disabled	Whether to disabled the upload	boolean	false
capture	Capture，can be set to camera	string	-
after-read	Hook after reading the file	Function	-
before-read	Hook before reading the file, return false to stop reading the file, can return Promise	Function	-
before-delete	Hook before delete the file, return false to stop reading the file, can return Promise	Function	-
max-size	Max size of file	number	-
max-count	Max count of image	number	-
result-type	Type of file read result, can be set to dataUrl text	string	dataUrl
upload-text	Upload text	string	-
image-fit	Preview image fit mode	string	cover

Events

Event	Description	Arguments
oversize	Triggered when file size over limit	Same as after-read
delete	Triggered when delete preview file	file

Slots

Name	Description
default	Custom icon

Parematers of before-read、after-read

Attribute	Description	Type
file	File object	object
detail	Detail info	object