npm 包 samjs-files-upload 使用教程

阅读时长 4 分钟读完

简介

samjs-files-upload 是 npm 上一款非常实用的前端上传文件插件,可以实现文件的多种上传方式,并且支持文件类型、大小校验等功能。

安装

在命令行中使用 npm 进行安装:

使用方法

导入模块

在需要使用 samjs-files-upload 的页面中引入模块:

创建实例

在页面中创建一个 Upload 实例,并将相关配置传入:

-- -------------------- ---- -------
----- -------- - --- --------
  --- ----------
  ---- --------------------------------
  --------- -----
  ------------ ---- - ---- - --
  ------- -------------- ------------ -------------------
  --------------- -------------- ---
  ----------- -------------- -------- ---
  ---------- -------------- --------- ---
  -------- -------------- --------- ---
  ----------- ------------------ --
---

配置选项

以下是 Upload 构造函数的可配置选项:

选项 默认值 描述
el 必选,指定上传组件所在的 DOM 元素,可以是 ID 、class 或标签名
url 必选,指定上传文件的服务器 URL
multiple true 可选,是否支持多文件上传
maxFileSize 10MB 可选,限制上传文件大小,单位为字节
accept [] 可选,指定可上传文件的格式,是一个 MIME 类型数组
onBeforeUpload 可选,上传前执行的回调函数,参数为当前正在上传的文件
onProgress 可选,上传过程中执行的回调函数,参数为当前正在上传的文件和当前进度百分比
onSuccess 可选,上传成功后执行的回调函数,参数为当前上传的文件和服务器返回的响应数据
onError 可选,上传失败后执行的回调函数,参数为当前上传的文件和错误信息
onComplete 可选,上传完成后执行的回调函数,参数为服务器返回的响应数据

示例代码

-- -------------------- ---- -------
--------- -----
------
  ------
    ----- --------------- --
    ------------- ------------
  -------
  ------
    ---- ------------------

    ------- --------------
      ------ ------ ---- ---------------------

      ----- -------- - --- --------
        --- ----------
        ---- ----------
        --------- -----
        ------------ ---- - ---- - --
        ------- -------------- ------------ -------------------
        --------------- -------------- -
          -------------------- -----------
        --
        ----------- -------------- -------- -
          -------------------- ---------- ------- -------- -----
        --
        ---------- -------------- --------- -
          -------------------- ---------- --------- ----------
        --
        -------- -------------- --------- -
          -------------------- ---------- --------- ----------
        --
        ----------- ------------------ -
          -------------------- ----------
        -
      ---
    ---------
  -------
-------

总结

samjs-files-upload 是一款非常实用的前端文件上传插件,可以满足大部分上传场景的需求。使用时只需要创建一个 Upload 实例,并传入相关的配置选项即可。希望本文对您有所帮助。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055d5a81e8991b448db211

纠错
反馈