feat: 增加 PdfOptions 配置项

Author: ArgoZhang

src/BootstrapBlazor/Options/PdfOptions.cs

@@ -0,0 +1,17 @@
+// 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([email protected]) Website: https://www.blazor.zone
+
+namespace BootstrapBlazor.Components;
+
+/// <summary>
+/// PdfOptions 实例用于设置导出 Pdf 相关选项
+/// </summary>
+public class PdfOptions
+{
+    /// <summary>
+    /// 获得/设置 是否横向打印 默认 false
+    /// </summary>
+    public bool Landscape { get; set; }
+}

src/BootstrapBlazor/Services/DefaultHtml2PdfService.cs

@@ -12,29 +12,11 @@ class DefaultHtml2PdfService : IHtml2Pdf
 {
     private const string ErrorMessage = "请增加依赖包 BootstrapBlazor.Html2Pdf 通过 AddBootstrapBlazorHtml2PdfService 进行服务注入; Please add BootstrapBlazor.Html2Pdf package and use AddBootstrapBlazorHtml2PdfService inject service";
 
-    /// <summary>
-    /// <inheritdoc/>
-    /// </summary>
-    public Task<byte[]> PdfDataAsync(string url) => throw new NotImplementedException(ErrorMessage);
+    public Task<byte[]> PdfDataAsync(string url, PdfOptions? options = null) => throw new NotImplementedException(ErrorMessage);
 
-    /// <summary>
-    /// <inheritdoc/>
-    /// </summary>
-    public Task<Stream> PdfStreamAsync(string url) => throw new NotImplementedException(ErrorMessage);
+    public Task<Stream> PdfStreamAsync(string url, PdfOptions? options = null) => throw new NotImplementedException(ErrorMessage);
 
-    /// <summary>
-    /// Export method
-    /// </summary>
-    /// <param name="html">html raw string</param>
-    /// <param name="links"></param>
-    /// <param name="scripts"></param>
-    public Task<byte[]> PdfDataFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null) => throw new NotImplementedException(ErrorMessage);
+    public Task<byte[]> PdfDataFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null, PdfOptions? options = null) => throw new NotImplementedException(ErrorMessage);
 
-    /// <summary>
-    /// Export method
-    /// </summary>
-    /// <param name="html">html raw string</param>
-    /// <param name="links"></param>
-    /// <param name="scripts"></param>
-    public Task<Stream> PdfStreamFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null) => throw new NotImplementedException(ErrorMessage);
+    public Task<Stream> PdfStreamFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null, PdfOptions? options = null) => throw new NotImplementedException(ErrorMessage);
 }

src/BootstrapBlazor/Services/IHtml2Pdf.cs

@@ -22,27 +22,31 @@ public interface IHtml2Pdf
     /// Export method
     /// </summary>
     /// <param name="url">url</param>
-    Task<byte[]> PdfDataAsync(string url);
+    /// <param name="options"></param>
+    Task<byte[]> PdfDataAsync(string url, PdfOptions? options = null);
 
     /// <summary>
     /// Export method
     /// </summary>
     /// <param name="url">url</param>
-    Task<Stream> PdfStreamAsync(string url);
+    /// <param name="options"></param>
+    Task<Stream> PdfStreamAsync(string url, PdfOptions? options = null);
 
     /// <summary>
     /// Export method
     /// </summary>
     /// <param name="html">html raw string</param>
     /// <param name="links"></param>
     /// <param name="scripts"></param>
-    Task<byte[]> PdfDataFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null);
+    /// <param name="options"></param>
+    Task<byte[]> PdfDataFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null, PdfOptions? options = null);
 
     /// <summary>
     /// Export method
     /// </summary>
     /// <param name="html">html raw string</param>
     /// <param name="links"></param>
     /// <param name="scripts"></param>
-    Task<Stream> PdfStreamFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null);
+    /// <param name="options"></param>
+    Task<Stream> PdfStreamFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null, PdfOptions? options = null);
 }