StaticLayout

侧栏与分组都不折叠:模块排成分类标题,页面常驻平铺在下面,分类和页面两级一屏看全;适合菜单不多的小型应用。

最后更新

说明

面向「菜单不多、层级就两级」的小型应用:结构与 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 交流群二维码 扫码加入 QQ 群