Blazor 实战系列（三）

.NET Core abp vNext Blazor
Blazor
发布日期:   2020-06-11
文章字数:   2.6k
阅读时长:   11 分
阅读次数:  

上一篇完成了博客的主题切换，菜单和二维码的显示与隐藏功能，本篇继续完成分页查询文章列表的数据展示。

添加页面

现在点击页面上的链接，都会提示错误消息，因为没有找到对应的路由地址。先在 Pages 下创建五个文件夹：Posts、Categories、Tags、Apps、FriendLinks。

然后在对应的文件夹下添加 Razor 组件。

  • Posts 文件夹：文章列表页面Posts.razor、根据分类查询文章列表页面Posts.Category.razor、根据标签查询文章列表页面Posts.Tag.razor、文章详情页Post.razor
  • Categories 文件夹：分类列表页面Categories.razor
  • Tags 文件夹：标签列表页面Tags.razor
  • Apps 文件夹：Apps.razor准备将友情链接入口放在里面
  • FriendLinks 文件夹：友情链接列表页面FriendLinks.razor

先分别创建上面这些 Razor 组件，差不多除了后台 CURD 的页面就这些了，现在来逐个突破。

不管三七二十一，先把所有页面的路由给确定了，指定页面路由使用 @page 指令，官方文档说不支持可选参数，但是可以支持多个路由规则。

默认先什么都不显示，可以将之前的加载中圈圈写成一个组件，供每个页面使用。

在 Shared 文件夹添加组件Loading.razor。

<!--Loading.razor-->
<div class="loader"></div>
//Posts.razor
@page "/posts/"
@page "/posts/page/{page:int}"
@page "/posts/{page:int}"

<Loading />

@code {
    /// <summary>
    /// 当前页码
    /// </summary>
    [Parameter]
    public int? page { get; set; }
}

这里我加了三条，可以匹配没有 page 参数，带 page 参数的，/posts/page/{page:int}这个大家可以不用加，我是用来兼容目前线上的博客路由的。总的来说可以匹配到：/posts、/posts/1、/posts/page/1这样的路由。

//Posts.Category.razor
@page "/category/{name}"

<Loading />

@code {
    /// <summary>
    /// 分类名称参数
    /// </summary>
    [Parameter]
    public string name { get; set; }
}

根据分类名称查询文章列表页面，name 当作分类名称参数，可以匹配到类似于：/category/aaa、/category/bbb这样的路由。

//Posts.Tag.razor
@page "/tag/{name}"

<Loading />

@code {
    /// <summary>
    /// 标签名称参数
    /// </summary>
    [Parameter]
    public string name { get; set; }
}

这个根据标签名称查询文章列表页面和上面差不多一样，可以匹配到：/tag/aaa、/tag/bbb这样的路由。

//Post.razor
@page "/post/{year:int}/{month:int}/{day:int}/{name}"

<Loading />

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

    [Parameter]
    public int month { get; set; }

    [Parameter]
    public int day { get; set; }

    [Parameter]
    public string name { get; set; }
}

文章详情页面的路由有点点复杂，以/post/开头，加上年月日和当前文章的语义化名称组成。分别添加了四个参数年月日和名称，用来接收 URL 的规则，使用 int 来设置路由的约束，最终可以匹配到路由：/post/2020/06/09/aaa、/post/2020/06/9/bbb这样的。

//Categories.razor
@page "/categories"

<Loading />

//Tags.razor
@page "/tags"

<Loading />

//FriendLinks.razor
@page "/friendlinks"

<Loading />

分类、标签、友情链接都是固定的路由，像上面这样就不多说了，然后还剩一个Apps.razor。

//Apps.razor @page "/apps"

<div class="container">
  <div class="post-wrap">
    <h2 class="post-title">-&nbsp;Apps&nbsp;-</h2>
    <ul>
      <li>
        <a target="_blank" href="https://support.qq.com/products/75616"
          ><h3>吐个槽_留言板</h3></a
        >
      </li>
      <li>
        <NavLink href="/friendlinks"><h3>友情链接</h3></NavLink>
      </li>
    </ul>
  </div>
</div>

在里面添加了一个友情链接的入口，和一个 腾讯兔小巢 的链接，欢迎大家吐槽留言噢。

现在可以运行一下看看，点击所有的链接都不会提示错误，只要路由匹配正确就会出现加载中的圈圈了。

文章列表

在做文章列表的数据绑定的时候遇到了大坑，有前端开发经验的都知道，JavaScript 弱类型语言中接收 json 数据随便玩，但是在 Blazor 中我试了下动态接受传递过来的 JSON 数据，一直报错压根运行不起来。所以在请求 api 接收数据的时候需要指定接收对象，那就好办了我就直接引用 API 中的.Application.Contracts就行了啊，但是紧接着坑又来了，目标框架对不上，引用之后也运行不起来，这里应该是之前没有设计好。

于是，我就想了一个折中的办法吧，将 API 中的返回对象可以用到的 DTO 先手动拷贝一份到 Blazor 项目中，后续可以考虑将公共的返回模型做成 Nuget 包，方便使用。

那么，最终就是在 Blazor 中添加一个 Response 文件夹，用来放接收对象，里面的内容看图：

有点傻，先这样解决，后面在做进一步的优化吧。

将我们复制进来的东东，在_Imports.razor中添加引用。

//_Imports.razor
@using System.Net.Http
@using System.Net.Http.Json
@using Microsoft.AspNetCore.Components.Forms
@using Microsoft.AspNetCore.Components.Routing
@using Microsoft.AspNetCore.Components.Web
@using Microsoft.AspNetCore.Components.WebAssembly.Http
@using Meowv.Blog.BlazorApp.Shared
@using Response.Base
@using Response.Blog

@inject HttpClient Http
@inject Commons.Common Common

@inject HttpClient Http：注入HttpClient，用它来请求 API 数据。

现在有了接收对象，接下来就好办了，来实现分页查询文章列表吧。

先添加三个私有变量，限制条数，就是一次加载文章的数量，总页码用来计算分页，还有就是 API 的返回数据的接收类型参数。

/// <summary>
/// 限制条数
/// </summary>
private int Limit = 15;

/// <summary>
/// 总页码
/// </summary>
private int TotalPage;

/// <summary>
/// 文章列表数据
/// </summary>
private ServiceResult<PagedList<QueryPostDto>> posts;

然后当页面初始化的时候，去加载数据，渲染页面，因为 page 参数可能存在为空的情况，所以要考虑进去，当为空的时候给他一个默认值 1。

/// <summary>
/// 初始化
/// </summary>
protected override async Task OnInitializedAsync()
{
    // 设置默认值
    page = page.HasValue ? page : 1;

    await RenderPage(page);
}

/// <summary>
/// 点击页码重新渲染数据
/// </summary>
/// <param name="page"></param>
/// <returns></returns>
private async Task RenderPage(int? page)
{
    // 获取数据
    posts = await Http.GetFromJsonAsync<ServiceResult<PagedList<QueryPostDto>>>($"/blog/posts?page={page}&limit={Limit}");

    // 计算总页码
    TotalPage = (int)Math.Ceiling((posts.Result.Total / (double)Limit));
}

在初始化方法中设置默认值，调用RenderPage(...)获取到 API 返回来的数据，并根据返回数据计算出页码，这样就可以绑定数据了。

@if (posts == null)
{
    <Loading />
}
else
{
    <div class="post-wrap archive">
        @if (posts.Success && posts.Result.Item.Any())
        {
            @foreach (var item in posts.Result.Item)
            {
                <h3>@item.Year</h3>
                @foreach (var post in item.Posts)
                {
                    <article class="archive-item">
                        <NavLink href="@("/post" + post.Url)">@post.Title</NavLink>
                        <span class="archive-item-date">@post.CreationTime</span>
                    </article>
                }
            }
            <nav class="pagination">
                @for (int i = 1; i <= TotalPage; i++)
                {
                    var _page = i;

                    if (page == _page)
                    {
                        <span class="page-number current">@_page</span>
                    }
                    else
                    {
                        <a class="page-number" @onclick="@(() => RenderPage(_page))" href="/posts/@_page">@_page</a>
                    }
                }
            </nav>
        }
        else
        {
            <ErrorTip />
        }
    </div>
}

在加载数据的时候肯定是需要一个等待时间的，因为不可抗拒的原因数据还没加载出来的时候，可以让它先转一会圈圈，当posts不为空的时候，再去绑定数据。

在绑定数据，for 循环页码的时候我又遇到了一个坑 😂，这里不能直接去使用变量 i，必须新建一个变量去接受它，不然我传递给RenderPage(...)的参数就会是错的，始终会取到最后一次循环的 i 值。

当判断数据出错或者没有数据的时候，在把错误提示<ErrorTip />扔出来显示。

做到这里，可以去运行看看了，肯定会报错，因为还有一个重要的东西没有改，就是我们接口的BaseAddress，在Program.cs中，默认是当前 Blazor 项目的运行地址。

我们需要先将 API 项目运行起来，拿到地址配置在Program.cs中，因为现在还是本地开发，有多种办法可以解决，可以将.HttpApi.Hosting设为启动项目直接运行起来，也可以使用命令直接dotnet run。

我这里为了方便，直接发布在 IIS 中，后续只要电脑打开就可以访问了，你甚至选择其它任何你能想到的方式。

关于如何发布这里先不做展开，有机会的话写一篇将.net core 开发的项目发布到 Windows、Linux、Docker 的教程吧。

所以我的Program.cs中配置如下：

//Program.cs
using Meowv.Blog.BlazorApp.Commons;
using Microsoft.AspNetCore.Components.WebAssembly.Hosting;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace Meowv.Blog.BlazorApp
{
    public class Program
    {
        public static async Task Main(string[] args)
        {
            var builder = WebAssemblyHostBuilder.CreateDefault(args);
            builder.RootComponents.Add<App>("app");

            var baseAddress = "https://localhost";

            if (builder.HostEnvironment.IsProduction())
                baseAddress = "https://api.meowv.com";

            builder.Services.AddTransient(sp => new HttpClient
            {
                BaseAddress = new Uri(baseAddress)
            });

            builder.Services.AddSingleton(typeof(Common));

            await builder.Build().RunAsync();
        }
    }
}

baseAddress默认为本地开发地址，使用builder.HostEnvironment.IsProduction()判断是否为线上正式生产环境，改变baseAddress地址。

现在可以看到已经可以正常获取数据，并且翻页也是 OK 的，然后又出现了一个新的 BUG😂。

解决 BUG

细心的可以发现，当我点击头部组件的Postsa 标签菜单时候，页面没有发生变化，只是路由改变了。

思来想去，我决定使用NavigationManager这个 URI 和导航状态帮助程序来解决，当点击头部的Postsa 标签菜单直接刷新页面得了。

在Common.cs中使用构造函数注入NavigationManager，然后添加一个跳转指定 URL 的方法。

/// <summary>
/// 跳转指定URL
/// </summary>
/// <param name="uri"></param>
/// <param name="forceLoad">true，绕过路由刷新页面</param>
/// <returns></returns>
public async Task RenderPage(string url, bool forceLoad = true)
{
    _navigationManager.NavigateTo(url, forceLoad);

    await Task.CompletedTask;
}

当forceLoad = true的时候，将会绕过路由直接强制刷新页面，如果forceLoad = false，则不会刷新页面。

紧接着在Header.razor中修改代码，添加点击事件。

@*<NavLink class="menu-item" href="posts">Posts</NavLink>*@

<NavLink class="menu-item" href="posts" @onclick="@(async () => await Common.RenderPage("posts"))">Posts</NavLink>

总算是搞定，完成了分页查询文章列表的数据绑定，今天就到这里吧，未完待续…

文章作者: 阿星𝑷𝒍𝒖𝒔
文章链接: https://meowv.com/dotnet/abp/blazor-bestpractice-3/
版权声明: 本博客所有文章除特別声明外，均采用 CC BY 4.0 许可协议。转载请注明来源 阿星𝑷𝒍𝒖𝒔 !
.NET Core abp vNext Blazor
赏
评论
  目录