FlyoutLayout

窄边栏只放一级模块,点模块在右侧滑出弹层,全部子页面一次平铺;点页面跳转并收起,适合模块很多的系统。

最后更新

说明

面向「模块很多、单模块子页面也多」的后台:左上是品牌位,左侧是 74px 图标窄边栏,只渲染菜单树的顶层节点。点一级模块时,内容区左缘滑出弹层(最小 264px,随分类列自动撑开,最多占满内容区;竖向对齐被点开的一级模块——放得下就顶边对齐向下展开,下方不够则底边对齐向上翻;高度随内容,内容高于视口时才铺满可用高度并由正文滚动),把该模块的分类横向排成列、页面一次性平铺——每个分类的页面每列最多 5 行,超过 5 行同类横向再起一列;分类块整体最多两行,更多分类在弹层内纵向滚动。没有折叠态、也不分页;点任一页面即跳转并收起弹层,点遮罩、右上角关闭按钮或再点同一个模块同样收起。内容区平时占满整个宽度,不再为常驻二级导航列让位。

与 RailLayout 共用同一条窄边栏与顶栏视觉(.rail-top / .rail-nav / .rail-item),差别只在二级菜单的出场方式:RailLayout 把二级列固定展开在窄边栏右侧,FlyoutLayout 把它收成按需弹层。只有一个可跳转页面的模块不弹层,点一下直接进该页——为一条链接再开一层弹层只是多一次点击。宽度与列宽是 CSS 变量 --rail-width / --fly-panel-width(最小宽)/ --fly-col-width(每列宽),宿主在实例上覆写样式即可,不必改框架。

登录门禁、[Menu] 扫描装配、标题与面包屑推导、软刷新、多页签、维护横幅、水印、命令面板与返回顶部都来自外壳基类 AppShell,与 AdminLayout / RailLayout 逐项一致;路由变化或切换外壳时弹层自动收起。≤860px 时弹层改为盖住窄边栏的左侧抽屉(高度同样随内容,超出视口时滚动),分类列回到单列纵向排列,遮罩铺满整屏。

常见能力:

  • 窄边栏 + 按需滑出弹层,内容区始终占满宽度
  • 弹层竖向对齐被点模块:顶边向下展开,下方不够则底边向上翻
  • 分类横向成列,页面一次平铺、不折叠
  • 每个分类每列最多 5 行,超出横向再起一列
  • 分类块最多两行,更多分类弹层内纵向滚动
  • 点页面跳转并收起;遮罩 / 关闭按钮 / 再点模块均可收起
  • 单页面模块直接跳转,不弹层
  • 顶栏横贯全宽、完整复用 TopBar
  • 与 AdminLayout / RailLayout 同源的外壳能力(AppShell)
  • 宽度与列宽经 CSS 变量覆写(--rail-width / --fly-panel-width / --fly-col-width)
  • 高度随内容;子菜单超出视口时面板铺满可用高度、正文出现纵向滚动条
  • ≤860px 弹层转左侧抽屉、分类单列
  • 顶栏「布局」即时换壳(Config.Shells 候选 flyout)

用法

@* App.razor:与其它外壳同款接法,页面可用 @layout FlyoutLayout 逐页覆盖 *@
<Router AppAssembly="@typeof(Program).Assembly">
  <Found Context="routeData">
    <RouteView RouteData="@routeData" DefaultLayout="@typeof(FlyoutLayout)" />
  </Found>
</Router>
// 或让用户自己选:出厂 Config.Shells 已内置 admin / rail / flyout 三项
Config.LayoutType = typeof(FlyoutLayout);   // 没选过偏好时的落点

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-flyout-content" 内容滚动容器的 DOM id。
Searchable bool true 是否显示全局搜索。
SiteTitle string null 站点标题。留空时由「系统设置 · 系统名称」驱动。
UserName string "Admin" 用户名。
UserRole string "超级管理员" 用户角色。

所有组件均继承 BaseComponent,除上表参数外还支持 Class、Style、Disabled、Visible。

微信公众号二维码 扫码关注公众号
QQ 交流群二维码 扫码加入 QQ 群