SxFileUpload (文件上传)
支持拖拽和多文件选择的上传组件。对齐 Microsoft Fluent UI Blazor InputFile (v4.13.2) 的 API 结构，并说明 NextUI 当前实现状态。
使用场景
约束说明
MaximumFileCount 仅在 Multiple=true 时生效。- 组件仅处理选择与展示，不包含上传逻辑。
行为说明
- 选择文件会触发
OnFilesChanged。
- 当
Disabled=true 时不响应拖拽与点击。
API
Parameters (参数)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Multiple |
bool |
false |
是否支持多文件选择。 |
| Implemented |
Accept |
string? |
null |
限制上传的文件类型 (如 .jpg, .pdf)。 |
| Implemented |
MaximumFileCount |
int |
10 |
允许一次上传的最大文件数。 |
| Implemented |
MaximumFileSize |
long |
10485760 |
单个文件允许的最大字节数（默认 10MB）。 |
| Implemented |
Id (继承) |
string? |
null |
组件的物理 Id。 |
| Implemented |
Class (继承) |
string? |
null |
自定义 CSS 类名。 |
| Implemented |
Style (继承) |
string? |
null |
自定义样式。 |
| Implemented |
Title (继承) |
string? |
null |
HTML title 属性。 |
| Implemented |
Disabled (继承) |
bool |
false |
是否禁用交互。 |
| Implemented |
AdditionalAttributes (继承) |
IEnumerable<KeyValuePair<string, object>>? |
null |
捕获不匹配的 HTML 属性。 |
Events (事件)
| 状态 |
事件名 |
类型 |
描述 |
| Implemented |
OnFilesChanged |
EventCallback<InputFileChangeEventArgs> |
文件选择状态改变时触发。 |
示例
<SxFileUpload Multiple="true" Accept="image/*" />
参考设计 (References)
