SxNavBar (导航栏)
顶级导航组件，用于在应用头部或侧边提供全局导航与操作入口。支持“两翼对冲”居中算法和自动收纳功能。对齐 Microsoft Fluent UI Blazor NavMenu/Header (v4.13.2) 的 API 结构，并说明 NextUI 当前实现状态。
使用场景
- 顶部或侧边导航入口
- 标题与快捷操作组合
- 顶栏全局菜单
约束说明
QuickActionIcons 使用 Font Awesome 图标名。TitleText 为空时仍保留标题区域。
行为说明
Alignment 控制标题对齐。AllowTitleWrap 为真时支持多行标题。ShowFunctionalMenu 控制右侧功能菜单。EnableAppStack=false 时，返回与首页动作由 OnBack / OnNavigateHome 驱动。
API
Parameters (参数)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
TitleText |
string |
"" |
标题文案。 |
| Implemented |
TitleTemplate |
RenderFragment? |
null |
标题模板。 |
| Implemented |
TitlePrefix |
RenderFragment? |
null |
标题前内容。 |
| Implemented |
TitleSuffix |
RenderFragment? |
null |
标题后内容。 |
| Implemented |
LeftContent |
RenderFragment? |
null |
左侧内容。 |
| Implemented |
LeftActions |
RenderFragment? |
null |
左侧动作区（位于返回按钮之前）。 |
| Implemented |
ToggleIcon |
string |
"bars" |
折叠按钮图标名。 |
| Implemented |
BackLabel |
string? |
null |
返回按钮文本。 |
| Implemented |
IsSidebarMode |
bool |
false |
是否侧边栏模式。 |
| Implemented |
ShowHamburger |
bool |
false |
是否显示汉堡按钮。 |
| Implemented |
QuickActionIcons |
List<string>? |
null |
右侧快捷图标。 |
| Implemented |
MinVisibleQuickActions |
int |
0 |
最少保留图标数。 |
| Implemented |
ShowFunctionalMenu |
bool |
true |
是否显示功能菜单。 |
| Implemented |
FunctionalMenu |
RenderFragment? |
null |
自定义功能菜单。 |
| Implemented |
EnableAppStack |
bool |
true |
启用应用堆栈导航。 |
| Implemented |
Alignment |
NavBarAlignment |
Center |
标题对齐。 |
| Implemented |
Appearance |
NavBarAppearance |
Solid |
视觉风格。 |
| Implemented |
Size |
ControlSize |
None |
高度尺寸。 |
| Implemented |
Sticky |
bool |
false |
吸顶效果。 |
| Implemented |
AllowTitleWrap |
bool |
false |
标题换行。 |
| Implemented |
MaxTitleLines |
int |
2 |
最大换行数。 |
| Implemented |
TitleFontWeight |
int |
700 |
标题字重。 |
| Implemented |
DebugLayout |
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 |
额外属性。 |
Events (事件)
| 状态 |
事件名 |
类型 |
描述 |
| Implemented |
OnBack |
EventCallback |
点击返回按钮时触发。 |
| Implemented |
OnQuickActionClick |
EventCallback<string> |
点击快捷图标时触发。 |
| Implemented |
OnToggleSidebar |
EventCallback |
点击汉堡按钮时触发。 |
| Not Implemented |
OnChangeLanguage |
EventCallback |
语言切换回调。 |
| Implemented |
OnNavigateHome |
EventCallback |
首页回调。 |
| Not Implemented |
OnToggleTheme |
EventCallback |
主题切换回调。 |
示例
<SxNavBar TitleText="消息中心" QuickActionIcons="@_icons" />
参考设计 (References)
