操作方式
同步模式
当Upload处于同步模式时,小部件的行为类似于常规文件输入。所选文件在提交表单时上传,用户可以选择可变数量的文件,并且不需要使用浏览器来支持多个文件的选择。
下面的示例演示如何从放置在表单中的现有文件输入以同步模式初始化Upload。输入名称中的数组语法用于提示Upload处理程序将照片视为数组。有关如何处理上传文件的更多信息,请参阅特定服务器技术的文档。
$(document).ready(function() {$("#photos").kendoUpload();});
异步模式
当Upload处于异步模式时,小部件需要专用的服务器处理程序来存储和删除上传的文件。所选的文件被立即上传,或者,可选地,所选的文件在用户确认后被上传。上传请求在不中断页面流的情况下在带外执行。有关可运行示例,请参阅演示在异步模式下设置上传的操作。
开始
异步模式通过HTML5文件API。在旧浏览器中,Upload将通过使用隐藏的iframe
元素。
创建HTML
输入
类型的“文件”
(没有形式
是必需的)。初始化Upload并配置异步上传端点。字段名的数组语法用于提示要处理的上传处理程序
“照片”
作为数组。$(" #照片”)。kendoUpload({async: {saveUrl: "saveHandler.php", removeUrl: "removeHandler.php", removeField: " filename []"}});
配置保存处理程序
的保存
处理程序必须接受POST请求。请求将包含一个或多个与输入
在前面的例子中,这是“[]”照片
。
的保存
Handler应该返回以下任何一个响应:
- 表示成功的空洞回应。
- 的JSON字符串。
“文本/普通”
内容编码。反序列化对象可在成功
事件处理程序。 - 任何其他表示失败的响应。
配置删除处理程序
的删除
处理程序必须接受POST请求,该请求可以通过removeVerb
选择。请求将包含一个或多个文本字段“文件名”
名称-在前面的示例中,将其更改为“文件名”[]
通过使用removeField
选择。
的删除
Handler应该返回以下任何一个响应:
- 表示成功的空洞回应。
- 的JSON字符串。
“文本/普通”
内容编码。反序列化对象可在成功
事件处理程序。 - 任何其他表示失败的响应。
设置异步模式回退
当Upload被放置在形式
并且配置为异步操作,小部件具有回退机制。未完全上传的文件将在用户提交时作为表单的一部分发送。此行为可确保即使您不采取任何特殊措施来阻止提交按钮,不会丢失任何文件。您需要处理上传的文件保存
处理程序和表单中以同步模式提交操作。