SxMessageBar (信息栏)
展示需要用户关注的重要系统通知。对齐 Microsoft Fluent UI Blazor MessageBar (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。
使用场景
- 系统通知与操作反馈
- 表单提交结果提示
- 重要状态提醒
约束说明
Message 与 ChildContent 二选一,若提供 ChildContent 则优先。
AllowHtml 为真时会按 HTML 渲染内容。
行为说明
IsDismissable 为真时显示关闭按钮。
- 点击关闭按钮会触发
OnDismiss 并隐藏组件。
API
Parameters (参数)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Message |
string? |
null |
消息文案。 |
| Implemented |
ChildContent |
RenderFragment? |
null |
自定义内容。 |
| Implemented |
Intent |
MessageIntent |
Info |
严重程度。 |
| Implemented |
IsDismissable |
bool |
true |
是否显示关闭按钮。 |
| Implemented |
AllowHtml |
bool |
false |
是否允许 HTML 内容。 |
| Implemented |
OnDismiss |
EventCallback |
null |
点击关闭回调。 |
| Implemented |
Disabled (继承) |
bool |
false |
禁用状态。 |
| Implemented |
Loading (继承) |
bool |
false |
加载状态。 |
| Implemented |
Id (继承) |
string? |
null |
组件的物理 Id。 |
| Implemented |
Class (继承) |
string? |
null |
自定义 CSS 类名。 |
| Implemented |
Style (继承) |
string? |
null |
自定义样式。 |
| Implemented |
Title (继承) |
string? |
null |
HTML title 属性。 |
| Implemented |
AdditionalAttributes (继承) |
IEnumerable<KeyValuePair<string, object>>? |
null |
捕获不匹配的 HTML 属性。 |
Events (事件)
| 状态 |
事件名 |
类型 |
描述 |
| Implemented |
OnDismiss |
EventCallback |
用户点击关闭按钮时触发。 |
示例
<SxMessageBar Intent="MessageIntent.Warning" Message="请注意保存更改" />
参考设计 (References)