Introduction
Getting Started
Vue 2 End of Support
Vue Wrappers End of Life
Native Components
Wrapper Components
- Introduction
- Barcodes
- Buttons
- Charts
- Chat
- DataSource
- Date Inputs
- Diagram
- Dialog
- Dropdowns
- DropDownTree
- Editor
- Gantt
- Gauges
- Grid (wrapper)
- Inputs
- Layout
- List Views
- ListBox
- Map
- MediaPlayer
- PivotGrid
- Popups
- Scheduler
- ScrollView
- Spreadsheet
- TreeList
- TreeMap
- TreeView
- Upload
- - Overview
  - Initial Files
  - Validation
  - Templates
  - Chunk Upload
  - Directory Upload
  - Custom Drop Zone
  - RTL Support
  - API
- Validator
- Window
- Framework & Features
- Globalization
- Troubleshooting
- Using Wrapper Components in Vite
Sample Applications
Styling & Themes
Common Features
Project Setup
Knowledge Base
Changelog
FAQ
Troubleshooting

Components / Upload / API / Upload API /

New to Kendo UI for Vue? Start a free 30-day trial

Upload

Props

async `Object`

Configures the asynchronous upload of files (async in Kendo UI for jQuery). The supported composite props are available in AsyncProps.

Enables the selection of folders instead of files (directory in Kendo UI for jQuery). When the user selects a directory, its entire content hierarchy of files is included in the set of selected items. The directory setting is available only in browsers which support webkitdirectory.

directory-drop `Boolean`

Enables the dropping of folders to the Upload and its drop zone (directoryDrop in Kendo UI for jQuery). When the user drops a directory, its entire content hierarchy of files is included in the set of selected items. The directoryDrop setting is available only in browsers which support DataTransferItem and webkitGetAsEntry.

drop-zone `String`

Based on a specific selector, initializes a drop-zone element which provides for the drag-and-drop file upload (dropZone in Kendo UI for jQuery).

enabled `Boolean`

If enabled id set to true, the Upload is enabled (enabled in Kendo UI for jQuery). To re-enable a disabled Upload, use enable().

files `Array`

The list of files that will be initially rendered in the file list of the Upload (files in Kendo UI for jQuery). The supported composite props are available in FilesProps.

Each file object in the array has to contain the following properties:

name
size
extension

localization `Object`

Sets the strings that are rendered by the Upload (localization in Kendo UI for jQuery). The supported composite props are available in LocalizationProps.

multiple `Boolean`

If multiple is set to true, the selection of multiple files is enabled (multiple in Kendo UI for jQuery).
If multiple is set to false, the user can select only one file at a time.

show-file-list `Boolean`

If show-file-list is set to true, the display of a file listing for the file upload is enabled (showFileList in Kendo UI for jQuery). The disabling of a file listing might be useful if you want to customize the UI. To build your own UI, use the client-side events.

template `String | Function`

Sets a template for rendering the files in the file list (template in Kendo UI for jQuery).

The template data array consists of the following properties:

name—The name of the file. If used in the batch upload mode, name represents a comma-separated string combination of all file names.
size—The file size (in bytes). If used in the batch upload mode, size represents the total file size. If not available, the value is null.
files—An array which contains information about all selected files (name, size, and extension).

validation `Object`

The validation options for the uploaded files (validation in Kendo UI for jQuery). The supported composite props are available in ValidationProps.

Events

cancel: `Function`

Fires when the upload was cancelled while in progress (cancel in Kendo UI for jQuery).

clear: `Function`

Fires when the files are cleared through the Clear button (clear in Kendo UI for jQuery).

complete: `Function`

Fires when all active uploads complete—either successfully or with errors (complete in Kendo UI for jQuery).

error: `Function`

Fires when an upload or a remove operation fails (error in Kendo UI for jQuery).

pause: `Function`

Fires when the files are cleared through the Pause button (pause in Kendo UI for jQuery). The button is visible if chunksize is set.

progress: `Function`

Fires when the data about the progress of the upload is available (progress in Kendo UI for jQuery).

resume: `Function`

Fires when the files are resumed through the Resume button (resume in Kendo UI for jQuery). The button is visible if chunksize is set and the file upload is paused.

remove: `Function`

Fires when an uploaded file is about to be removed (remove in Kendo UI for jQuery). If remove is canceled, the remove operation is prevented.

select: `Function`

Fires when a file is selected (select in Kendo UI for jQuery).

success: `Function`

Fires when an upload or a remove operation is successfully completed (success in Kendo UI for jQuery).

upload: `Function`

Fires when one or more files are about to be uploaded (upload in Kendo UI for jQuery). The canceling of the upload event prevents the upload.

Methods

For more details about the methods available in the component's API please check its Kendo UI for jQuery API documentation.

kendoWidget

returns

Returns the Kendo UI Upload instance.