Components

FileUpload 文件上传

为资源、头像、镜像与配置导入提供可拖放的多文件上传工作流，状态始终由文件列表清晰呈现。

带进度的资源上传

可拖放多张图片；演示请求会显示进度，并随机模拟一次可重试的失败。

选择文件或拖放到这里

支持 image/png,image/jpeg,image/webp · 单个文件最大 5.0 MB

<FileUpload
  accept="image/png,image/jpeg,image/webp"
  :max-size="5 * 1024 * 1024"
  :max-files="4"
  :upload="uploadAsset"
  @reject="showError($event.reason)"
/>

配置文件校验

不传 upload 时，组件作为文件选择与校验控件使用；通过 change 获取当前文件项。

选择文件或拖放到这里

支持 .json,.yaml,.yml · 单个文件最大 256.0 KB

<FileUpload
  accept=".json,.yaml,.yml"
  :multiple="false"
  :max-size="256 * 1024"
  @change="configFiles = $event"
/>

API 参考

属性	类型	默认值	说明
`accept / multiple`	`string / boolean`	`'' / true`	原生 accept 规则和多文件选择开关。
`maxSize / maxFiles`	`number`	`—`	单文件字节上限与最多文件数。
`upload`	`FileUploadHandler`	`—`	异步上传处理器，接收 file、signal 和 setProgress。传入后自动上传。
`change / reject`	`event`	`—`	当前文件列表变化，或某个文件未通过校验。
`upload / success / error / cancel`	`event`	`—`	文件上传生命周期事件。
`label`	`string`	`'上传文件'`	拖放区域的无障碍标签。