Skip to content

AtUpload

沈孟平
最后更新于 2025-11-18 14:57:11

主要做的封装的目的如下:

  1. 默认 NUpload 上传失败是根据 http status code 进行判断,但是一般后端接口是根据自定义 code 判断,所以这里加了一个 isSuccess 函数进行自定义判断逻辑,并且需要这个函数返回成功上传的目标文件的结果。
  2. 根据你传进来的 urlField 和 nameField 取得 value 绑定的值,并自动格式化成 NUpload 想要的 fileList 格式。
  3. 不传 action 参数,并监听 onChange 事件,可以用来在表单中手动上传。

代码演示

基础示例

图片列表

监听文件变化,手动上传

拖拽上传

API

AtUpload Props

名称类型默认值说明版本
valuearray[]文件列表数据 类型参考
is-successfunctionundefined判断是否上传成功;需要返回成功上传的目标文件的结果
drag-tipstringundefined拖拽上传提示
url-fieldstring'url'接口返回数据中 url 对应的字段
name-fieldstring'name'接口返回数据中名称对应的字段
n-upload-propsOmit<UploadProps, 'themeOverrides' | 'imageGroupProps'>undefinedNaiveUI Upload Props

AtUpload Slots

名称参数说明版本
default()自定义上传触发器

changelog

a4d32 - feat(components): 组件`AtForm`所有类型组件支持插槽 on 2025/10/24
b1629 - fix(components): 自定义上传边界处理 on 2025/5/14
ed1fb - feat(components): AtUpload isSuccess prop add file param on 2025/1/16
62833 - fix(AtUpload): 上传组件回显 on 2024/11/26
67985 - fix(components): 拖拽上传区域图标大小 on 2024/10/15
dc275 - fix(components): 拖拽上传区域未占满容器宽度 on 2024/10/15
3a828 - fix(components): 上传组件显示错误 on 2024/10/15
cb315 - feat(components): upload props 调整 on 2024/10/8
2c46a - fix(components): AtUpload 移除文件错误 on 2024/9/24
ee239 - fix(components): 如果是数组重置的时候需要深克隆一下 on 2024/9/23

贡献者

Last updated: