说明
面向「模块很多、单模块子页面也多」的后台:左上是品牌位,左侧是 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 群