Upload

Upload files manually or automatically with preview and limits.

Upload

Default

Select a single file with the default upload area.

Code copied

Multiple

Allow several files and enforce a maximum with limit.

Code copied

Automatic

Upload immediately after selection when action is set.

Code copied

Advanced

v-model receives selected files. Use before-select-method for app rules and upload-method for a custom request adapter. Existing action upload still works.

API

Code copied

PROPS

PropertyTypeValuesDescriptiondefaultExampleMore
data / headers / file-name / file-types / limit-size / limit-countObject / Object / String / String[] / Number / Numberrequest data and upload restrictionsConfigure upload request data, accepted files and file limits.-
before-remove-method / show-list / show-preview / show-progressFunction / Booleanremove guard and display switchesGuard removal and control file list feedback.-
show-button-icon / show-button-text / show-remove-button / show-submit-button / show-upload-button / text-maxBoolean / Numbertrue | false / text limitConfigure upload control visibility and label truncation.-
textStringStringUpload area label.Upload File
file-nameStringStringForm field name for upload.file
limitNumber, StringNumberMax number of files.
multipleBooleantruefalseAllow multiple files.
single-uploadBooleantruefalseReplace file on each selection.
automaticBooleantruefalseUpload immediately after select.
auto-submitBooleantruefalseAlias of automatic upload.
model-valueFile | File[]FileTwo-way file list binding.
file-types / limit-size / limit-countArray / NumberMIME types / MB / countRestrict allowed files, file size and file count.
actionStringURLUpload endpoint URL.
acceptStringMIME typesAccepted file types.
disabledBooleantruefalseDisable upload.
No matching data

EVENTS

PropertyTypeValuesDescriptiondefaultExampleMore
changeFile list changed.
on-deleteFile removed.
on-successUpload succeeded.
on-errorUpload failed.
No matching data
Last Updated: 2026-08-17, 08:33:54