Blazor中的布局和MVC中的布局是类似的。
新建一个Razor页面,所有新增的布局都要继承LayoutComponentBase,同时标识自定义内容的输出位置,即标识Body的位置。如图所示:
我们修改一下index.razor页面中的代码,增加@layout MyLayout。运行后,按F12查看网页源代码如下:
布局的内容被<app></app>
标签包着,这也意味着,我们的layout并不是页面的全部内容,而仅仅只是blazor相关的内容。
顺便说一下,布局是可以“继承”的,也就是说,我们可以声明一个新的布局继承自MainLayout.razor ,只需要指定如下代码即可:
@inherits LayoutComponentBase
@layout MainLayout
定义在App.razor中:
<Router AppAssembly="@typeof(Program).Assembly">
<Found Context="routeData">
<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
</Found>
<NotFound>
<LayoutView Layout="@typeof(MainLayout)">
<p>Sorry, there's nothing at this address.</p>
</LayoutView>
</NotFound>
</Router>
里面有三个重要组件:
路由定义很简单,只需要前缀@page,然后定义你的路由名称即可,如@page “index”。当然一个页面可以定义多个路由。如下:
这个其实和ASP.NET Core API的路由方式没有太大区别,包括路由约束部分。
@page "/Index/{Theme}"
接收参数的方式也很简单,需要声明一个get;set的属性,并且必须是public的,同时需要用Parameter特性去标识。
@{
[Parameter]
public string Theme{get;set;}
}
以下是路由约束,相比于MVC,这些约束也没什么变化。
<div class="@NavMenuCssClass" @onclick="@ToggleNavMenu">
<ul class="nav flex-column">
<li class="nav-item px-3">
<NavLink class="nav-link" href="" Match="NavLinkMatch.All">
<span class="oi oi-home" aria-hidden="true"></span> Home
</NavLink>
</li>
<li class="nav-item px-3">
<NavLink class="nav-link" href="MyComponent" Match="NavLinkMatch.Prefix">
<span class="oi oi-plus" aria-hidden="true"></span> My Component
</NavLink>
</li>
</ul>
</div>
NavLinkMatch有两个枚举:
@inject NavigationManager NavigationManager
成员 | 描述 |
---|---|
Uri | 获取当前的绝对URL |
BaseUri | 获取根URI(末尾带斜杠),然后以此追加相对路径进而组合成绝对URI |
NavigateTo | 导航到指定的 URI(前提是设置forceLoad 为true),使用此方式,会绕过客户端路由,使得浏览器会强制刷新页面,如:UriHelper.NavigateTo("/DataList/" + Index, forceLoad); |
LocationChanged | 当导航位置更改时触发的事件 |
ToAbsoluteUri | 将相对 URI 转换为绝对 URI |
ToBaseRelativePath | 给定一个根 URI(例如,以前由BaseUri返回的 URI),将绝对 URI 转换为带有根URI 前缀的相对 URI |
Blazor虽然提供了十分丰富而又灵活的路由功能,但目前还没有一个明确的功能让我们使用可选参数,但是我们可以变通一下,就是设置接收的数据类型为可空类型。代码如下:
@page “DataList/{Index:int}”
[Parameter]
public int? Index { get; set; }
protected override void OnInitialized()
{
base.OnInitialized();
Index = Index?? 1;
}