Blazor 路由與頁面導航(5)

點擊觀看視頻教程

關於

在 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="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.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:

    @page "test/{text}"

//...

關於NavigationManager中的事件和方法說明: