Blazor布局是继承LayoutComponentBase的UI复用组件,核心为@Body占位与@layout指定;可单页设置、全局默认或禁用;支持嵌套布局实现多级结构。
Blazor 布局(Layout)本质是复用 UI 结构的组件,核心就两点:定义一个继承 LayoutComponentBase 的组件,在里面放 @Body 占位;然后让页面“认它当母版页”——要么单页指定,要么全局统一。
在 Shared 文件夹里新建 MainLayout.razor(推荐位置),内容类似这样:
@inherits LayoutComponentBase
@Body 标记子页面内容插入的位置@code、数据绑定、注入服务MainLayout.razor.css(CSS 隔离生效)示例:
@inherits LayoutComponentBase我的顶部导航 @Body
有两种方式,按需选择:
.razor 页面顶部加一行 @layout MainLayout
App.razor,把 改成
一旦设了全局默认,所有没显式声明 @layout 的页面都会自动套用它。
有些页面不需要公共导航或页脚,比如登录页、404 页。有俩办法:
@layout null,直接禁用布局App.razor 里用条件逻辑控制:@if (routeData.PageType != typeof(Pages.Login))
{ } else { }
如果某类页面还要再套一层专属结构(比如后台管理页带侧边菜单),可以嵌套:
AdminLayout.razor),同样 @inherits LayoutComponentBase
@layout MainLayout,表示它自己也用主布局包装@layout AdminLayout,就能同时获得两级结构本质上就是“布局套布局”,层级清晰,不冲突。
基本上就这些。布局不是魔法,就是把重复 HTML 提出来,靠继承和占位实现复用——改一处,全站同步更新。