feat: 增加 AddBootstrapBlazorDom2ImageService 服务扩展

Author: ArgoZhang

src/components/BootstrapBlazor.Dom2Image/Extensions/ServiceCollectionExtensions.cs

@@ -0,0 +1,26 @@
+// Copyright (c) Argo Zhang (argo@163.com). All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+// Website: https://www.blazor.zone or https://argozhang.github.io/
+
+using BootstrapBlazor.Components;
+
+namespace Microsoft.Extensions.DependencyInjection;
+
+/// <summary>
+/// BootstrapBlazor 服务扩展类
+/// </summary>
+public static class BootstrapBlazorHtml2PdfServiceExtensions
+{
+    /// <summary>
+    /// 添加 AzureOpenAIService 服务
+    /// </summary>
+    /// <param name="services"></param>
+    public static IServiceCollection AddBootstrapBlazorDom2ImageService(this IServiceCollection services)
+    {
+        services.AddScoped<IDom2ImageService, DefaultDom2ImageService>();
+#if NET8_0_OR_GREATER
+        services.AddKeyedScoped<IDom2ImageService, DefaultDom2ImageService>("BootstrapBlazor.Dom2Image");
+#endif
+        return services;
+    }
+}

src/components/BootstrapBlazor.Dom2Image/Services/DefaultDom2ImageService.cs

@@ -0,0 +1,62 @@
+// Copyright (c) Argo Zhang (argo@163.com). All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+// Website: https://www.blazor.zone or https://argozhang.github.io/
+
+using Microsoft.Extensions.Logging;
+using Microsoft.JSInterop;
+
+namespace BootstrapBlazor.Components;
+
+/// <summary>
+/// 默认 Html to Image 实现
+/// <param name="runtime"></param>
+/// <param name="logger"></param>
+/// </summary>
+class DefaultDom2ImageService(IJSRuntime runtime, ILogger<DefaultDom2ImageService> logger) : IDom2ImageService
+{
+    private JSModule? _jsModule;
+
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    public async Task<string?> GetUrlAsync(string selector, Dom2ImageOptions? options = null, CancellationToken token = default)
+    {
+        string? data = null;
+        try
+        {
+            _jsModule ??= await LoadModule();
+            data = await _jsModule.InvokeAsync<string?>("getUrl", token, selector, options);
+        }
+        catch (OperationCanceledException) { }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "{GetUrlAsync} throw exception", nameof(GetUrlAsync));
+        }
+        return data;
+    }
+
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    public async Task<Stream?> GetStreamAsync(string selector, Dom2ImageOptions? options = null, CancellationToken token = default)
+    {
+        Stream? data = null;
+        try
+        {
+            _jsModule ??= await LoadModule();
+            var streamReference = await _jsModule.InvokeAsync<IJSStreamReference?>("getStream", selector, options);
+            if (streamReference != null)
+            {
+                data = await streamReference.OpenReadStreamAsync(streamReference.Length, token);
+            }
+        }
+        catch (OperationCanceledException) { }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "{GetUrlAsync} throw exception", nameof(GetUrlAsync));
+        }
+        return data;
+    }
+
+    private Task<JSModule> LoadModule() => runtime.LoadModule("./_content/BootstrapBlazor.Dom2Image/dom2image.js");
+}

src/components/BootstrapBlazor.Dom2Image/Services/Dom2ImageOptions.cs

@@ -0,0 +1,86 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the Apache 2.0 License
+// See the LICENSE file in the project root for more information.
+// Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
+
+using System.Text.Json.Serialization;
+
+namespace BootstrapBlazor.Components;
+
+/// <summary>
+/// Dom2ImageOptions 选项类
+/// </summary>
+public class Dom2ImageOptions
+{
+    /// <summary>
+    /// Removes redundant styles. Default value is true
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public bool? Compress { get; set; }
+
+    /// <summary>
+    /// Skips idle delay for faster results. Default value is true
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public bool? Fast { get; set; }
+
+    /// <summary>
+    /// Inlines fonts (icon fonts always embedded). Default value is false
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public bool? EmbedFonts { get; set; }
+
+    /// <summary>
+    /// Output scale multiplier. Default value is 1
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public int? Scale { get; set; }
+
+    /// <summary>
+    /// Device pixel ratio
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public int? Dpr { get; set; }
+
+    /// <summary>
+    /// Output specific width size
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public int? Width { get; set; }
+
+    /// <summary>
+    /// Output specific height size
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public int? Height { get; set; }
+
+    /// <summary>
+    /// Fallback color for JPG/WebP. Default value is #fff
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string? BackgroundColor { get; set; }
+
+    /// <summary>
+    /// Quality for JPG/WebP (0 to 1)
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public float? Quality { get; set; }
+
+    /// <summary>
+    /// Select png, jpg, webp Blob type. Default value is svg
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string? Type { get; set; }
+
+    /// <summary>
+    /// CSS selectors for elements to exclude
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string[]? Exclude { get; set; }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string[]? LocalFonts { get; set; }
+}

src/components/BootstrapBlazor.Dom2Image/Services/IDom2ImageService.cs

@@ -0,0 +1,29 @@
+// Copyright (c) Argo Zhang (argo@163.com). All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+// Website: https://www.blazor.zone or https://argozhang.github.io/
+
+namespace BootstrapBlazor.Components;
+
+/// <summary>
+/// IDom2ImageService 接口定义
+/// </summary>
+public interface IDom2ImageService
+{
+    /// <summary>
+    /// 通过指定选择器获得 Html 元素返回图片数据
+    /// </summary>
+    /// <param name="selector"></param>
+    /// <param name="options"></param>
+    /// <param name="token"></param>
+    /// <returns></returns>
+    Task<string?> GetUrlAsync(string selector, Dom2ImageOptions? options = null, CancellationToken token = default);
+
+    /// <summary>
+    /// 通过指定选择器获得 Html 元素返回图片数据流
+    /// </summary>
+    /// <param name="selector"></param>
+    /// <param name="options"></param>
+    /// <param name="token"></param>
+    /// <returns></returns>
+    Task<Stream?> GetStreamAsync(string selector, Dom2ImageOptions? options = null, CancellationToken token = default);
+}