更新记录

1.3.2(2022-06-16)

修复Tabbar窗口无法选择文件的问题

1.3.1(2022-06-15)

修复因上个版本更新取消强制cuWebview参数,导致传入该参数时直接传给了接口的问题

1.3.0(2022-05-19)

取消app端上传函数cuwebview参数,只需传入接口相关属性,另外在新版上传组件做了更多优化,建议需要文件选择上传的同学移步 全文件选择上传2.0版

查看更多

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.3.13 app-vue app-nvue × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

l-file

完整示例可导入示例项目运行

不要期待更新,我很懒~

希望能帮到你!

附件选择上传已单独发布插件,使上传按钮完全内嵌于页面,不再从底部单独二次弹框 若只需要用文件选择上传功能,建议使用新版组件: 全文件选择上传2.0版

本插件也可以继续使用,根据需求选择


使用说明

属性 是否必填 值类型 返回值 说明
@up-success CallBack {data,name,size} 上传成功回调data为服务端返回值

ref调用

作用 方法 传入参数类型 说明
下载 download <URL,type,fileName> type='save'为保存到本地,默认为获取临时路径
预览 open URL 预览文件
上传 upload Object 上传文件,参数见下方函数说明

vue:

// 以下代码写于根目录下第一个view顶部或跟在自定义导航栏后面
<l-file 
    ref="lFile" 
    @up-success="upSuccess"
></l-file>

  • 函数说明
/* 临时下载文件并打开查看 */
this.$refs.lFile.download({url})
.then(path=>{
    // 打开文件
    this.$refs.lFile.open(path);
});

/**
* =======附件下载=======
* 
* type 非save为临时下载
* customName 仅type=save生效 附件自定义名称需带后缀,自定义目录需以/结尾
* DownloadOptions 仅type=save生效 可选参数(http://www.html5plus.org/doc/zh_cn/downloader.html#plus.downloader.DownloadOptions)
* 默认下载到_downloads/files/ 可通过DownloadOptions自定义
*/
this.$refs.lFile.download({
    url, //必填,附件网络地址
    type:'save', //选填,非save为临时下载
    customName:'自定义文件名需要带后缀.jpg',
    //...DownloadOptions直接写key:value 
    // 例如:
    method: 'GET'
})
.then(path=>{
    this.localPath = path;
});

/* 
=======选择文件+上传=======

url=上传服务器地址,必填
name=上传文件的key(选填,默认为file)
header=请求头(选填)
*/
this.$refs.lFile.upload({
    //替换为你的上传接口地址
    url: 'http://document/upload',
    // 服务端接收附件的key
    name: 'file',
    //根据你接口需求自定义 (优先不传content-type,安卓端无法收到参数再传)
    header: {
        'Authorization': 'bearer eyJhbGciO',
        'uid': '27682',
        'client': 'app',
    },

    // 限制选择附件的大小上限,默认10M
    // maxSize: 20,

    // 若需要在body单独添加附件名或附件大小如下方式传入组件:
    // addName: '后端要的附件名称字段key,此处请勿写name的同值如(file),会覆盖name',
    // addSize: '后端要的附件大小字段key'

    // body参数直接写key,value,如:
    // date: '2020-1-1',
    // key2: 'value2',
});

温馨提示

  • 文件上传
    1. 如不清楚怎么调用可导入完整示例可查看使用方式
    2. APP端请优先联调Android,上传成功后再运行iOS端,如iOS返回status=0则需要后端开启允许跨域;
    3. header的Content-Type类型需要与服务端要求一致,否则收不到附件(服务端若没有明文规定则可不写,使用默认匹配)
    4. java不清楚怎么配置跨域可以找我;若是php,跨域需要注意不能配置为*星号,需为file单独设置跨域,具体百度~
    5. 欢迎加入QQ讨论群1:701468256(已满,偶有人退)
    6. 欢迎加入QQ讨论群2:469580165(已满,偶有人退)
    7. 欢迎加入QQ讨论群3:667530868

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问