SxToast (通知)
全局轻量级反馈消息。对齐 Microsoft Fluent UI Blazor Toast (v4.13.2) 的 API 结构，并说明 NextUI 当前实现状态。
使用场景
- 操作成功/失败反馈
- 系统提示与警告
- 异步任务完成提醒
约束说明
- 页面中应只放置一个
SxToast 容器。
- 实际通知内容通过
ISxToastService 触发。
行为说明
Timeout 到期后自动关闭通知。- 点击关闭按钮会触发
OnDismissed。
API
Parameters (SxToast)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| 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 属性。 |
Parameters (SxToastService / ToastMessage)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Appearance |
ToastAppearance |
Neutral |
视觉风格。 |
| Implemented |
Message |
string? |
null |
通知内容。 |
| Implemented |
Timeout |
int |
3000 |
自动关闭时间 (ms)。 |
| Implemented |
Title |
string? |
null |
通知标题。 |
Events
| 状态 |
事件名 |
类型 |
描述 |
| Implemented |
OnDismissed |
Action<Guid> |
通知消失后触发。 |
示例
@inject ISxToastService ToastService
<SxToast />
<SxButton OnClick="() => ToastService.Notify("保存成功", "提示", ToastAppearance.Success)">
触发通知
</SxButton>
参考设计 (References)
