Upload

拖拽区 + 文件列表 + 上传进度。

最后更新 2026-10-25 19:27:08

说明

基于 Blazor InputFile，OnUpload 回调中可读取 file.Stream 并交给业务侧保存。

常见能力：

拖拽区
多文件
大小校验
进度与状态

用法

<Upload @bind-Files="@files" OnUpload="@Save" Tip="支持 PNG / JPG / PDF" />

API 参数

参数	类型	默认值	说明
`Accept`	`string`	`null`	accept 属性，如 .png,.jpg。留空时取「系统设置 · 允许的扩展名」。
`ButtonText`	`string`	`"点击上传"`	按钮 / 图片卡片触发器的文案。
`ChildContent`	`RenderFragment`	`null`
`Files`	`List<UploadFile>`	`[]`	已选文件。
`FilesChanged`	`EventCallback<List<UploadFile>>`	—	事件
`InputId`	`string`	`"known-upload-file"`	隐藏 input 的 id。
`MaxCount`	`int`	`0`	最大文件数，0 表示不限制；达到上限后隐藏触发器。
`MaxSize`	`Int64`	`0`	单文件大小上限（字节），0 表示取「系统设置 · 单文件大小上限（MB）」。
`Mode`	`string`	`"zone"`	触发器形态：zone（拖拽区）/ button（普通按钮）/ picture（图片卡片）。
`Multiple`	`bool`	`true`	是否允许多选。
`OnRemove`	`EventCallback<UploadFile>`	—	事件文件被移除。
`OnUpload`	`Func<UploadFile, Task>`	`null`	上传单个文件回调（业务侧保存）。
`ShowZone`	`bool`	`true`	是否显示拖拽区。
`Size`	`string`	`null`	按钮形态的尺寸：留空为默认，可传 sm / xs 收紧（仅对 Mode="button" 生效）。
`Tip`	`string`	`null`	提示文字。留空时按生效的大小 / 类型限制自动生成。
`Visible`	`bool`	`true`	取得或设置组件是否可见，默认为false。
`VisibleChanged`	`EventCallback<bool>`	—	事件取得或设置组件可见性变化时的回调事件。
`Class`	`string`	`null`	取得或设置组件的CSS类名，用于自定义样式。
`Disabled`	`bool`	`false`	取得或设置组件是否禁用，默认为false。
`Style`	`string`	`null`	取得或设置组件的内联样式，用于自定义样式。

所有组件均继承 BaseComponent，除上表参数外还支持 Class、Style、Disabled、Visible。