Blazor路由与页面导航开发介绍

2024-04-02 19:55

短信预约 -IT技能 免费直播动态提醒

在 Blazor 中，应用中的每个页面都是一个组件，通常在 razor 文件中定义，具有一个或多个指定路由。路由大多数发生在客户端，而不涉及特定的服务器请求。浏览器首先发出对应用程序根地址的请求。然后， Blazor 应用中的根 Router 组件会处理截获导航请求，并将它们处理到正确的组件。

Blazor 中的路由由 Router 组件处理。 Router 组件通常在应用程序的根组件（ App.Razor ）中使用。

Router

下面是VisualStudio创建的默认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>

Router 组件将发现指定 AppAssembly 中和指定 AdditionalAssemblies 中的可路由组件。当浏览器导航时，Router 会截获导航，并使用提取的 RouteData 呈现其 Found 参数的内容（如果路由与地址匹配），否则 Router 将呈现其 NotFound 参数。
RouteView 组件会处理 RouteData 指定的匹配组件（如果有）。如果匹配的组件没有布局，则使用可选的指定DefaultLayout 。

路由模板

在声明的Razor组件当中, 可以在组件当中定义一个或多个@Page "/xxx" , 通过该声明表示该组件可用于Router的导航, 否则只充当单个应用组件。

原因: Blazor 会编译带有 @page指令的.razor文件，将为生成的类提供指定路由模板的 RouteAttribute, 当浏览器发出对应用程序根地址的请求时, Blazor 应用中的根 Router 组件会处理截获导航请求，并将它们处理到正确的组件, 如果能够找到组件,将会为其呈现在指定的 Layout 当中, 否则呈现 NotFound 的自定义内容。 (关于Router组件的介绍)

添加@page "xxx" 参数是必需的, 如果你需要用于导航, 与ASP.NET Web窗体不同，指向Blazor组件的路由不会从其文件位置推断出来（尽管这可能是将来添加的功能）。

@page "/test/{text}"
@page "/test"

<h6>Hello</h6>
<h3>@Text</h3>

@code {
    [Parameter]
    public string Text { get; set; }
}

路由参数

在上面的代码中, @page "/test/{text}" , 尖括号的部分则代表路由参数, 代表该页面在导航时可以接受一个参数。
注意:当声明路由参数的时候,由于需要该参数, 则需要为该参数声明一个组件参数 (不区分大小写):

    @page "/NodePage/test/{Text}"

@code {
    [Parameter]
    public string TexT { get; set; }
}

路由约束

可以为路由参数设定路由约束, 可以用于限定参数的类型, 使用方式:

    @page "/Users/{Id:int}"

<h1>The user Id is @Id!</h1>

@code {
    [Parameter]
    public int Id { get; set; }
}

可用于约束的列表:

导航组件

NavLink 组件

创建导航链接时，请使用 NavLink 组件代替 HTML 超链接元素 ()。 NavLink 组件的行为方式类似于元素，但它根据其 active 是否与当前 URL 匹配来切换 href CSS 类。

以下 NavMenu 组件创建启动导航栏，该导航栏演示如何使用 NavLink 组件：

    <div class="@NavMenuCssClass" @onclick="@ToggleNavMenu">
    <ul class="nav flex-column">
        <li class="nav-item px-3">
            <NavLink class="nav-link" href="" Match=" rel="external nofollow" 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" rel="external nofollow"  Match="NavLinkMatch.Prefix">
                <span class="oi oi-plus" aria-hidden="true"></span> My Component
            </NavLink>
        </li>
    </ul>
</div>

NavLinkMatch.All – NavLink 在与当前整个 URL 匹配的情况下处于活动状态。
NavLinkMatch.Prefix（默认）– NavLink 在与当前 URL 的任何前缀匹配的情况下处于活动状态。

NavigationManager

NavigationManager 服务，可用于：

获取当前浏览器地址
获取基址
触发器导航
当地址更改时收到通知

在C#代码中, 可以使用NavigationManager进行页面导航,如下所示:

1.在Razor中注入: @inject NavigationManager NavigationManager
2.创建方法,使用NavigateTo 传递URL

    @inject NavigationManager NavigationManager
<button @onclick="NacigationToPage">NavigationTo</button>
@code{
    public void NacigationToPage()
    {
        NavigationManager.NavigateTo("/test/999");
    }
}

test.razor 页面引用@page: