<kendo:upload-async>

Configures the asynchronous upload of files. For more details, refer to the article on the async mode of the Upload.

Example

<kendo:upload>
    <kendo:upload-async></kendo:upload-async>
</kendo:upload>

Configuration Attributes

autoRetryAfter float

If async.autoRetryAfter is set, the failed upload request is repeated after the declared amount of time in miliseconds.

Example

<kendo:upload-async autoRetryAfter="autoRetryAfter">
</kendo:upload-async>

autoUpload boolean

By default, the selected files are uploaded immediately. To change this behavior, set autoUpload to false.

Example

<kendo:upload-async autoUpload="autoUpload">
</kendo:upload-async>

batch boolean

By default and if supported by the browser, the selected files are uploaded in separate requests. To change this behavior, set batch to true. As a result, all selected files are uploaded in one request.The batch mode applies to multiple files which are selected simultaneously. Files that are selected one after the other are uploaded in separate requests.

Example

<kendo:upload-async batch="batch">
</kendo:upload-async>

chunkSize float

When async.chunkSize is set, the selected files are uploaded chunk by chunk with the declared size. Each request sends a separate file blob and additional string metadata to the server. This metadata is in a stringified JSON format and contains the fileName, relativePath, chunkIndex, contentType, totalFileSize, totalChunks, and uploadUid properties. These properties enable the validation and combination of the file on the server side. The response also returns a JSON object with the uploaded and fileUid properties, which notifies the client what the next chunk is.

Example

<kendo:upload-async chunkSize="chunkSize">
</kendo:upload-async>

concurrent boolean

By default, the selected files are uploaded one after the other. When async.concurrent is set to true, all selected files start to upload simultaneously.

Example

<kendo:upload-async concurrent="concurrent">
</kendo:upload-async>

maxAutoRetries float

Sets the maximum number of attempts that are performed if an upload fails.

Example

<kendo:upload-async maxAutoRetries="maxAutoRetries">
</kendo:upload-async>

removeField java.lang.String

The name of the form field that is submitted to removeUrl.

Example

<kendo:upload-async removeField="removeField">
</kendo:upload-async>

removeUrl java.lang.String

The URL of the handler which is responsible for the removal of the uploaded files (if any). The handler must accept POST requests with one or more "fileNames" fields which specify the files that will be deleted.

Example

<kendo:upload-async removeUrl="removeUrl">
</kendo:upload-async>

removeVerb java.lang.String

The HTTP verb that will be used by the remove action.

Example

<kendo:upload-async removeVerb="removeVerb">
</kendo:upload-async>

saveField java.lang.String

The name of the form field which is submitted to saveUrl. The default value is the input name.

Example

<kendo:upload-async saveField="saveField">
</kendo:upload-async>

saveUrl java.lang.String

The URL of the handler that will receive the submitted files. The handler must accept POST requests which contain one or more fields with the same name as the original input name.

Example

<kendo:upload-async saveUrl="saveUrl">
</kendo:upload-async>

useArrayBuffer boolean

By default, the files are uploaded as file data. When set to true, the files are read as a file buffer by using FileReader. This buffer is sent in the request body.

Example

<kendo:upload-async useArrayBuffer="useArrayBuffer">
</kendo:upload-async>

withCredentials boolean

Controls whether to send credentials (cookies, headers) for cross-site requests.

Example

<kendo:upload-async withCredentials="withCredentials">
</kendo:upload-async>