📜  jQWidgets jqxFileUpload cancelAll() 方法(1)

📅  最后修改于: 2023-12-03 15:32:17.046000             🧑  作者: Mango

jQWidgets jqxFileUpload cancelAll() 方法介绍

简介

本文将介绍 jQWidgets jqxFileUpload 中的 cancelAll() 方法。该方法用于取消所有正在上传的文件。

方法签名
cancelAll(): void
参数说明

该方法无参数。

返回值

该方法无返回值。

使用示例
HTML
<div id="fileUpload"></div>
JavaScript
$('#fileUpload').jqxFileUpload({
    uploadUrl: 'upload.php',
    fileInputName: 'fileToUpload',
    autoUpload: false,
    multipleFilesUpload: true,
    uploadButtonElement: $('#uploadBtn'),
    cancelButtonElement: $('#cancelBtn')
});

$('#cancelAllBtn').on('click', function() {
    $('#fileUpload').jqxFileUpload('cancelAll');
});

在上述代码中,我们首先创建了一个 jQWidgets jqxFileUpload 实例,并通过传递相关配置来初始化它。其中:

  • uploadUrl: 指定上传文件的 URL。
  • fileInputName: 指定 input file 元素的 name 属性。
  • autoUpload: 设置为 false,表示需要手动调用 uploadAll() 方法来触发上传操作。
  • multipleFilesUpload: 设置为 true,表示支持同时上传多个文件。
  • uploadButtonElement: 指定上传文件的按钮元素。
  • cancelButtonElement: 指定取消上传的按钮元素。

接着我们为“取消全部上传”按钮绑定了 click 事件,当用户点击该按钮时,我们调用了 cancelAll() 方法来取消正在上传的所有文件。

注意事项
  • 该方法只能在 jQWidgets jqxFileUpload 实例上调用。
  • 取消上传操作只能在文件还未上传完成的情况下生效,如果文件已经上传完成,则无法取消上传。
  • 如果某个文件上传失败,可以通过 retry 方法来重新上传该文件。
  • 该方法同时也能够取消正在排队的文件。