2024年6月8日发(作者：)

一、介绍WebUploader

WebUploader是一个基于HTML5的文件上传插件，可以实现图片、

视瓶、音频等各种类型文件的上传。它具有强大的文件上传功能和丰

富的交互体验，广泛应用于各种全球信息站和Web应用中。

WebUploader提供了丰富的API和参数，可以根据需求进行定制化

开发，以实现更灵活、更高效的文件上传功能。

二、方法

在使用WebUploader进行文件上传时，通常需要调用

方法来创建一个文件上传实例。这个方法接收一

个配置对象作为参数，用来配置文件上传实例的各种参数和行为。下

面我们来详细介绍一下方法的参数及其含义。

1. pick

pick参数用于指定上传按钮的容器，可以是一个DOM元素或一个选

择器字符串。当用户点击这个容器时，就会触发文件选择窗口，选择

要上传的文件。

2. formData

formData参数用于设置文件上传时随文件一起提交的表单数据。可以

是一个对象，也可以是一个函数。如果是函数，可以在函数内部动态

地设置表单数据。

3. server

server参数用于指定文件上传的后台位置区域。上传文件时，

WebUploader会将文件传输到指定的服务器位置区域上。

4. fileVal

fileVal参数用于设置文件上传域的name值，默认为'file'。在文件上

传时，会将文件内容作为该name值的参数提交到后台。

5. chunked

chunked参数用于设置是否对大文件进行分片上传。如果将该参数设

置为true，WebUploader会自动将大文件进行分片，并将每一片都

作为一个独立的文件上传到服务器。

6. disableGlobalDnd

disableGlobalDnd参数用于设置是否禁用全局拖拽上传。如果将该参

数设置为true，用户无法将文件拖拽到页面上进行上传。

7. accept

accept参数用于设置允许上传的文件类型。可以是一个字符串，也可

以是一个对象。如果是字符串，表示允许上传的文件类型，多个类型

之间用逗号分隔。如果是对象，可以设置更详细的文件类型信息，包

括文件扩展名和MIME类型。

8. resize

resize参数用于设置是否在上传前压缩图片。如果将该参数设置为

true，WebUploader会在上传图片前对图片进行压缩，以减小文件大

小。

9. auto

auto参数用于设置是否自动上传文件。如果将该参数设置为true，用

户选择文件后，文件会立即开始上传。如果设置为false，则需要手动

调用文件上传方法才能触发文件上传。

10. chunkSize

chunkSize参数用于设置分片上传的每片大小，默认为5M。当文件

大于该值时，WebUploader会将文件进行分片上传。

11. threads

threads参数用于设置上传并发数。默认为3，表示同一时刻最多有3

个文件同时上传。

12. method

method参数用于设置文件上传的方法，可以是'POST'或'PUT'。默认

为'POST'。

13. duplicate

duplicate参数用于设置是否允许重复上传同一文件。如果将该参数设

置为false，用户无法重复上传同一文件。

14. fileNumLimit

fileNumLimit参数用于设置同时最大上传文件数。超过该数量时，将

无法再选择文件进行上传。

15. fileSizeLimit

fileSizeLimit参数用于设置文件大小的上限。超过该大小的文件将无

法上传。

16. fileSingleSizeLimit

fileSingleSizeLimit参数用于设置单个文件的大小上限。超过该大小

的文件将无法上传。

17. acceptExtensions

acceptExtensions参数用于设置允许上传的文件扩展名，多个扩展名

之间使用逗号分隔。

18. ariaLabel

ariaLabel参数用于设置上传按钮的ARIA标签。ARIA（Accessible

Rich Internet Applications）是一种让网页内容和Web应用实现无

障碍访问的技术。

以上就是方法的各个参数及其含义。通过灵活

配置这些参数，可以实现各种自定义的文件上传功能。希望以上内容

对大家有所帮助。