基于.NetCore开发博客项目 StarBlog - (20) 图片显示优化

时间:2022-11-27 15:03:59

前言

我的服务器带宽比较高,博客部署在上面访问的时候几乎没感觉有加载延迟,就没做图片这块的优化,不过最近有小伙伴说博客的图片加载比较慢,那就来把图片优化完善一下吧~

目前有两个地方需要完善

  • 图片瀑布流
  • 图片缩略图

图片瀑布流

关于瀑布流之前的文章有介绍: 基于.NetCore开发博客项目 StarBlog - (10) 图片瀑布流

不过当时直接套用的 Bootstrap5 例子代码,有偶尔显示错位的bug

我又去看了一下 masonry-layout 的官网,找到这个bug的原因:瀑布流在图片还没加载完成就渲染好了,而图片的大小不一,造成了最终显示错位。

解决方法也很简单,用 imagesLoaded 这个库,它有个事件,在全部图片加载完成后触发,在事件响应里面再渲染一次瀑布流,就搞定了~

masonry-layout 这个库里面不附带 imagesLoaded ,要用必须自己安装。

我用的版本是 5.0.0

yarn add imagesloaded

StarBlog.Webgulpfile.js 里配置一下路径

// 使用 npm 下载的前端组件,自定义存放位置
const customLibs = [
  // ...
  {name: 'imagesloaded', dist: './node_modules/imagesloaded/*.js'},
]

然后执行 gulp move

接着,修改一下图片页面 StarBlog.Web/Views/Photography/Index.cshtml

引入 js 依赖,我这里还用了 environment tag helper,可以根据不同的环境引入不同的文件。在开发环境引入完整 js 文件,生产环境引入 ``*.min` 文件。

@section bottom {
    <environment include="Development">
        <script src="~/lib/jquery/dist/jquery.js"></script>
        <script src="~/lib/masonry-layout/dist/masonry.pkgd.js"></script>
        <script src="~/lib/imagesloaded/imagesloaded.pkgd.js"></script>
    </environment>
    <environment exclude="Development">
        <script src="~/lib/jquery/dist/jquery.min.js"></script>
        <script src="~/lib/masonry-layout/dist/masonry.pkgd.min.js"></script>
        <script src="~/lib/imagesloaded/imagesloaded.pkgd.min.js"></script>
    </environment>
    <script src="~/js/photo.js"></script>
}

把图片列表部分的代码改一下

<div >
  @foreach (var photo in Model.Photos) {
    <div class="col-sm-6 col-lg-4 mb-4 grid-item">
      <partial name="Widgets/PhotoCard" model="photo"/>
    </div>
  }
</div>

然后是 js/photo.js里的 js 代码

// init Masonry
let $grid = $('#photo-grid').masonry({
    itemSelector: '.grid-item',
    percentPosition: true,
})
// layout Masonry after each image loads
$grid.imagesLoaded().progress( function() {
    $grid.masonry('layout');
});

搞定~

图片缩略图

一开始我用的是 SixLabors.ImageSharp.Web 这个库

挺方便的,以中间件的形式使用

通过 Nuget 安装之后,在 program.cs 里配置一下

// 注册服务
builder.Services.AddImageSharp();
// 添加中间件
app.UseImageSharp();

之后就可以在任意图片文件的地址后面加上 width=xxx&format=xxx 这样的参数来实现调整大小和转换格式了~

图片列表的每个图片我做成了一个 partial view 组件,在 StarBlog.Web/Views/Shared/Widgets/PhotoCard.cshtml 这个文件

要把这个改成缩略图,只需要修改一下 img 元素

现在每个图片缩略图宽度300(宽度自适应),格式转换成 webp

<img class="bd-placeholder-img card-img-top" src="/media/@Model.FilePath?width=300&format=webp" alt="">

这个中间件还有很多其他参数可以设置,我只用到两个,详情可以看文档: https://docs.sixlabors.com/articles/imagesharp.web/processingcommands.html

Progressive JPEG

本来用 ImageSharp.Web 中间件已经够好了

但还有一点美中不足,就是它不支持生成 progressive JPEG 图片,这样就没办法在加载图片的时候先显示一个模糊的轮廓,再逐渐变清晰,而是从上到下一行一行加载,不好看~

所以,我用了 Magick.NET 这个库来实现生成 progressive JPEG 格式的图片。

这个库有三种版本:Q8, Q16, Q16-HDRI

根据官网文档,我选择了它推荐的 Q8 版本,性能最好 (图片质量无所谓了)

使用 nuget 安装 Magick.NET-Q8-AnyCPU 这个库

修改 StarBlog.Web/Services/PhotoService.cs

现在我要来写一个生成缩略图的方法

/// <summary>
/// 生成Progressive JPEG缩略图 (使用 MagickImage)
/// </summary>
public async Task<byte[]> GetThumb(string id, int width=300) {
  var photo = await _photoRepo.Where(a => a.Id == id).FirstAsync();
  using (var image = new MagickImage(GetPhotoFilePath(photo))) {
    image.Format = MagickFormat.Pjpeg;
    image.Resize(width,0);
    return image.ToByteArray();
  }
}

接着再写个接口

编辑 StarBlog.Web/Apis/PhotoController.cs

[HttpGet("{id}/Thumb")]
public async Task<IActionResult> GetThumb(string id, [FromQuery] int width = 300) {
  var data = await _photoService.GetThumb(id, width);
  return new FileContentResult(data, "image/jpeg");
}

搞定。

现在只需要访问 /Api/Photo/{图片ID}/Thumb?width=300 这个地址,就可以生成 progressive JPEG 格式的缩略图了~

最后再来改造一下 StarBlog.Web/Views/Shared/Widgets/PhotoCard.cshtml 组件

<img class="bd-placeholder-img card-img-top" alt=""
         src="@Url.Action("GetThumb", "Photo", new {id = Model.Id, width = 300})">

okk~

小结

相比起 ImageSharp.Web 中间件自带缓存的特性,我这个自己写的缩略图方法是比较粗糙的,而且每次请求都是动态生成,会给服务器带来一定压力。

不过它没有 Progressive JPEG 呀,这个功能缺失真的太难受了,只能期待它早日实现这个功能吧~

不然就只能我自己来实现缓存功能提高性能了~

系列文章

参考资料