说明
面向「菜单不多、层级就两级」的小型应用:结构与 AdminLayout 相同(侧栏 + 顶栏 + 内容区),差别只在侧栏形态——没有折叠按钮,一级模块整齐地排成一段「分类」标题(不可点、不折叠),页面直接平铺在下面;[Menu(Category = …)] 声明的二级分类再以更轻的小标题分段,分类内页面照常可点。当前页所属分类与模块随路由高亮,展开态与高亮规则和 AdminLayout 一致。
因为没有图标栏、也没有浮层,分类与页面一屏看全:少一次点击、少一次记忆,适合订单 / 客户 / 报表这类五六个模块就够用的系统。模块多、单模块子页多时仍建议 RailLayout(窄边栏 + 二级列)或 FlyoutLayout(按需弹层),把纵向空间让给内容。
登录门禁、[Menu] 扫描装配、标题与面包屑推导、软刷新、多页签、维护横幅、水印、命令面板与返回顶部都来自外壳基类 AppShell,与其它外壳逐项一致。侧栏固定是这一种外壳的形态本身:它没有 Collapsed 参数,「系统设置 · 侧栏默认折叠」也不会把它收起来;要可折叠的宽侧栏请用 AdminLayout。
常见能力:
- 侧栏没有折叠按钮,分组也不折叠,分类与页面常驻展开
- 模块标题即分类,二级分类(
[Menu(Category = …)])再分段,页面逐条可点 - 当前页所属分类 / 模块随路由高亮
- 两级菜单一屏看全,适合菜单不多的小型应用
- 顶栏横贯全宽、完整复用 TopBar
- 与 AdminLayout / RailLayout / FlyoutLayout 同源的外壳能力(AppShell)
- 顶栏「布局」即时换壳(Config.Shells 候选 static,可 Hidden 收起入口)
用法
@* App.razor:与其它外壳同款接法,页面可用 @layout StaticLayout 逐页覆盖 *@
<Router AppAssembly="@typeof(Program).Assembly">
<Found Context="routeData">
<RouteView RouteData="@routeData" DefaultLayout="@typeof(StaticLayout)" />
</Found>
</Router>
// 或让用户自己选:出厂 Config.Shells 已内置 admin / rail / flyout / static 四项
Config.LayoutType = typeof(StaticLayout); // 没选过偏好时的落点
@* 只是个 Sidebar 参数:在宿主自己的侧栏里也能用固定形态 *@
<Sidebar Menus="@menus" CurrentUrl="@path" Fixed="true" />
API 参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Body |
RenderFragment |
null |
|
HomeTitle |
string |
"首页" |
首页页签标题。 |
HomeUrl |
string |
"/" |
首页地址:多页签模式下钉在首位、不可关闭的那一签,也是品牌位点击的去向。 |
Languages |
List<LanguageOption> |
[] |
语言选项。留空时由顶栏从语言管理服务自取“用户启用的语言”;显式传入则覆盖。 |
Logo |
string |
"K" |
Logo 文字。 |
LogoIcon |
string |
null |
Logo 图标,设置后覆盖 Logo。 |
LogoUrl |
string |
"_content/Known/img/logo.svg" |
Logo 图片地址,优先级最高(覆盖 LogoIcon 与 Logo)。 |
Menus |
List<MenuItem> |
[] |
导航菜单。留空时由登录门禁装配([Menu] 扫描 + 模块登记表),显式传入则以其为准。 |
Notifications |
List<NotifyItem> |
[] |
顶栏通知。 |
NotifyFooter |
string |
"查看全部通知" |
通知面板底部文字,为空则不显示。 |
OnLogout |
EventCallback |
— | 事件 |
PageTitle |
string |
null |
顶栏页面标题。留空时自动取当前页在菜单中的名称。 |
ProfileUrl |
string |
"/profile" |
「个人中心」入口地址;置空以隐藏条目。 |
ScrollId |
string |
"known-static-content" |
内容滚动容器的 DOM id。 |
Searchable |
bool |
true |
是否显示全局搜索。 |
SiteTitle |
string |
null |
站点标题。留空时由「系统设置 · 系统名称」驱动。 |
UserName |
string |
"Admin" |
用户名。 |
UserRole |
string |
"超级管理员" |
用户角色。 |
所有组件均继承
BaseComponent,除上表参数外还支持Class、Style、Disabled、Visible。
扫码关注公众号
扫码加入 QQ 群