Some documentation on this page is available in Chinese only. Component built-in messages follow English; untranslated example text remains in its original language.

Upload

Upload manages file selection, validation, preview and request lifecycle. The built-in request is standards-only XMLHttpRequest with FormData; use custom-request when the application owns the network client.

Examples

Basic

Picture card

Picture list and default files

Desktop selection

Validation and limits

Custom trigger, item and preview

Custom request

Manual upload

API

The component uses v-model with UploadFileItem[]. A file uses url for its final resource and optional thumbnailUrl for its display image. Status is one of ready, reading, uploading, success, error, canceled, or removed; progress is always 0-100.

Core props are action, method, headers, data, name, custom-request, auto-upload, max-files, max-file-size, max-total-size, list-type, image-fit, before-add, before-read, before-upload, and before-remove.