基于 Arco Design Vue 的 Upload 组件,props 中可以传递以下属性:

203 阅读1分钟

上传组件支持的属性

基于 Arco Design Vue 的 Upload 组件,props 中可以传递以下属性:

基础属性

  • action: 上传的 URL
  • fileList: 文件列表 (受控)
  • defaultFileList: 默认文件列表
  • multiple: 是否支持多选文件
  • directory: 是否支持上传文件夹
  • drag: 是否启用拖拽上传
  • accept: 接受上传的文件类型 (如: "image/", ".jpg,.png")
  • limit: 限制上传数量
  • autoUpload: 是否自动上传 (默认 true)
  • showFileList: 是否显示文件列表 (默认 true)
  • listType: 文件列表样式 ("text" | "picture" | "picture-card")
  • disabled: 是否禁用
  • tip: 提示文字

上传配置

  • headers: 上传时的请求头
  • data: 上传时额外的数据
  • name: 上传的文件字段名 (默认 "file")
  • withCredentials: 上传请求时是否携带 cookie
  • customRequest: 自定义上传行为

事件回调

  • onChange: 上传文件改变时的状态
  • onProgress: 上传中的状态
  • onSuccess: 上传成功的回调
  • onError: 上传失败的回调
  • onBeforeUpload: 上传文件之前的钩子
  • onBeforeRemove: 删除文件之前的钩子
  • onPreview: 点击文件链接或预览图标时的回调