上传参数

给上传按钮设置的参数。

参数 说明 说明
data-upload 对应的input的name名称 必填
data-upload-number 单传还是多传 ‘one’或其他,其他为多选
data-upload-exts 验证的图片扩展 默认 *,更多用法 见下面介绍
data-upload-icon 文件失效时显示图标 更多用法见下面介绍
data-upload-sign 分隔符 默认 竖线
data-upload-accept 上传类型 参数同layui的upload的accept一样
data-upload-mimetype 上传mime过滤 参数同layui的upload的acceptMime 一样
data-upload-disable-preview 是否开启文件预览 默认开启预览,设置为1关闭预览
data-upload-filename-field 文件原名赋值 将文件的原名赋值到另一个字段上

data-upload-exts

用法1:设置扩展名

直接设置扩展名,通过|拼接。

  1. data-upload-exts="jpg|png|gif"

用法2:系统默认的扩展名

具体扩展名见下面:

  1. data-upload-exts="*"

用法4:不限制扩展名

留空即可。

  1. data-upload-exts=""

用法4:使用系统默认的扩展名分组

具体分组见下面。

  1. // 系统支持的图片
  2. data-upload-exts="*image"
  3. // 系统支持的音乐
  4. data-upload-exts="*music"

data-upload-icon

当图片失效时,预览的图片。但其他非图片文件会自动匹配对应类型的预览图标。一般不需要处理,系统会自动匹配。

如图,svg的图片会预览显示,但压缩包会显示为图标。

data-upload-accept

该参数将传递给layui的upload组件,参考:https://layui.gitee.io/v2/docs/modules/upload.html#options

data-upload-filename-field

可以将文件的原名赋值到另一个字段上。

系统默认扩展名

上面的介绍了很多属性都会用到系统默认的扩展名,具体的内容如下:

  1. {
  2. // 图片扩展名数组
  3. 'image': ['jpg', 'jpeg', 'png', 'gif', 'bmp', 'ico', 'webp', 'svg'],
  4. // word扩展名数组
  5. 'word': ['doc', 'docx'],
  6. // excel扩展名数组
  7. 'excel': ['xls', 'xlsx'],
  8. // ppt扩展名数组
  9. 'ppt': ['ppt', 'pptx'],
  10. // pdf扩展名数组
  11. 'pdf': ['pdf'],
  12. // 压缩文件扩展名数组
  13. 'zip': ['zip', 'rar', '7z'],
  14. // 文本文件扩展名数组
  15. 'txt': ['txt'],
  16. // 音乐文件扩展名数组
  17. 'music': ['mp3', 'wma', 'wav', 'mid', 'm4a'],
  18. // 视频文件扩展名数组
  19. 'video': ['mp4', 'avi', 'wmv', '3gp', 'flv'],
  20. // visio扩展名数组
  21. 'visio': ['vsd', 'vsdx'],
  22. 'file': []
  23. }

具体以源代码为准

当我们希望上传图片时,可以使用*image,此时要求扩展名为['jpg', 'jpeg', 'png', 'gif', 'bmp', 'ico', 'webp', 'svg']

如果希望上传视频时,可以使用*video,此时要求的扩展名为['mp4', 'avi', 'wmv', '3gp', 'flv']

如果希望上传以上所有的,直接使用*

如果不限制扩展名,留空即可。

额外的分组

  • *office
    • word,excel,ppt,pdf
  • *media
    • image,music,video

框架对部分扩展名进行了组合,比如office,由word,excel,ppt,pdf组合。所以同时支持*office的写法。此时可以设置:data-upload-exts="*office",这样将这些分组的扩展名。

示例

  1. <div class="layui-form-item">
  2. <label class="layui-form-label required">用户头像</label>
  3. <div class="layui-input-block layuimini-upload">
  4. <input name="head_img" class="layui-input layui-col-xs6" lay-verify="required" lay-reqtext="请上传用户头像" placeholder="请上传用户头像" value="/static/common/images/head.png">
  5. <div class="layuimini-upload-btn">
  6. <span><a class="layui-btn" data-upload="head_img" data-upload-number="one" data-upload-exts="*image" data-upload-icon="image"><i class="fa fa-upload"></i> 上传</a></span>
  7. <span><a class="layui-btn layui-btn-normal" id="select_head_img" data-upload-select="head_img" data-upload-number="one" data-upload-mimetype="image/*"><i class="fa fa-list"></i> 选择</a></span>
  8. </div>
  9. </div>
  10. </div>

原文标题:data-upload上传

原文文档:ulthon_admin

原文地址:http://doc.ulthon.com/read/augushong/ulthon_admin/635c9068b9bdd/zh-cn/2.x.html

原文平台:奥宏文档

2.x