# 文件上传

文件上传组件可以上传图片、文件。上传后的图片支持下载和预览,文件支持下载。

# 概念说明

# 主要属性

组件通用属性请参见组件通用说明

  • 值:当前已上传的文件列表。
  • 上传的文件字段名:默认file,支持自定义,后端通过该字段获取文件。
  • 支持上传的文件类型:支持对上传的文件类型进行限制,格式为“.后缀名”,如“.jpeg”表示仅支持上传jpeg格式的文件。多个文件类型时需使用英文逗号隔开,如“.jpeg,.png,.gif”表示仅支持上传jpeg、png、gif格式的文件。若为空值,则支持上传所有类型的文件。
  • 转换器:可选择JSON或URL字符串。
  • 上传地址:文件上传的URL地址,如/upload。
  • 请求headers:请求头。
  • 附加数据:补充描述。
  • 是否只读:正常显示,但禁止选择或输入。
  • 设置cookie值:通过设置 withCredentials 为 true 获得的第三方 cookies,将会依旧享受同源策略。
  • URL字段名:请求返回的 URL 字段名。
  • 是否自动上传:开启后选择文件后会自动上传,默认开启。
  • 多文件上传:开启后可上传多个文件,默认关闭,多文件可设置数量上限。
  • 列表数量上限:列表数量上限,默认为999。
  • 最大文件大小,单位为MB:可上传的最大文件大小。默认50MB;如果为数字,则表示单位为字节;如果为字符串,可以添加以下单位:kBMBGB
  • 图片选择模式:支持通过图库或相机输入。
  • 禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。
  • 文件访问策略:支持任何人可访问和用户登录后可访问两种方式。
  • 文件有效期:支持配置文件自动清理,开启后可自定义上传后有效天数。

# 组件内置逻辑

  • chooseFile:H5应用独有逻辑,调用后会按照当前浏览器适配打开拍照模式或是文件选择模式。

# 事件

  • 搜索框组件仅支持组件事件。
    • 组件事件:点击、文件大小超额、删除预览、上传成功时、上传错误时。

# 注意事项

  • 如果实体中字段需要保存文件或图片,请将数据类型设置为Text(长文本)。

  • 若选择单文件上传,每次上传会自动覆盖上一次上传的文件,仅保留最新上传的文件。

# 样式

样式说明请参见组件通用说明

# 示例

# 一个文件上传

image-202303036

上次更新: 2023年06月15日