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 方法来重新上传该文件。
• 该方法同时也能够取消正在排队的文件。