前言
使用 wkhtmltopdf 實(shí)現(xiàn)轉(zhuǎn)換 PDF 時(shí)，是否可以設(shè)置自定義頁(yè)眉和頁(yè)腳內(nèi)容？wkhtmltopdf 作為一個(gè)命令行工具，它提供了全局參數(shù)、大綱參數(shù)選項(xiàng)、頁(yè)面對(duì)象參數(shù)、頁(yè)眉和頁(yè)腳參數(shù)選項(xiàng)和目錄對(duì)象參數(shù)五種命令參數(shù)。本文介紹頁(yè)眉和頁(yè)腳參數(shù)選項(xiàng)實(shí)現(xiàn)自定義頁(yè)眉和頁(yè)腳內(nèi)容。
命令參數(shù)
1、頁(yè)眉和頁(yè)腳參數(shù)
--header-center [text]：在頁(yè)眉中居中指定文本；--header-left [text]：將文本放置在頁(yè)眉的左側(cè)；--header-right [text]：將文本放置在頁(yè)眉的右側(cè)；--header-html [url]：允許對(duì)標(biāo)題使用自定義的 HTML 文件【包含格式化文本、圖像等】；
--footer-center [text]：在頁(yè)腳中居中指定文本;--footer-left [text]：將文本放在頁(yè)腳的左側(cè);--footer-right [text]：將文本放置在頁(yè)腳的右側(cè);--footer-html [url]：允許對(duì)頁(yè)腳使用自定義的 HTML 文件【包含格式化文本、圖像等】；
頁(yè)眉或頁(yè)腳參數(shù)的text用下面元素替換，則可顯示對(duì)應(yīng)的內(nèi)容。如 --footer-center "[page] of [topage]"
[page]：當(dāng)前頁(yè)碼[toPage]：總頁(yè)數(shù)[date]：當(dāng)前日期[time]：當(dāng)前時(shí)間[title]：文檔標(biāo)題[subTitle]：文檔副標(biāo)題[pageNumber]：頁(yè)碼[totalPages]：總頁(yè)數(shù)
#region 頁(yè)眉--header-spacing [value]：控制頁(yè)眉與內(nèi)容之間的間距；--header-font-size [size]：設(shè)置標(biāo)題文本的字體大??；--header-line：在頁(yè)眉下方顯示一條直線分隔正文;#endregion
#region 頁(yè)腳--footer-spacing [value]：控制頁(yè)腳與內(nèi)容之間的間距；--footer-font-size [size]：設(shè)置頁(yè)腳文本的字體大??；--footer-line：在頁(yè)腳上方顯示一條直線分隔正文;#endregion
2、頁(yè)面對(duì)象參數(shù)
#region 部分--print-media-type：用顯示媒體類型代替屏幕；--no-print-media-type：不用顯示媒體類型代替屏幕；--page-offset <offset>：設(shè)置頁(yè)碼的起始值(默認(rèn)值為0)；--encoding <encoding>：為輸入的文本設(shè)置默認(rèn)的編碼方式；--zoom <float>：設(shè)置轉(zhuǎn)換成PDF時(shí)頁(yè)面的縮放比例(默認(rèn)為1)；#endregion
3、全局參數(shù)
#region 部分--margin-bottom <unitreal> 設(shè)置頁(yè)面的 底邊距；--margin-left <unitreal> 設(shè)置頁(yè)面的 左邊距 (默認(rèn)是 10mm)；--margin-right <unitreal> 設(shè)置頁(yè)面的 右邊距 (默認(rèn)是 10mm)；--margin-top <unitreal> 設(shè)置頁(yè)面的 上邊距；--page-height <unitreal> 頁(yè)面高度；--page-size <Size> 設(shè)置頁(yè)面的尺寸，如：A4,Letter等，默認(rèn)是：A4；--page-width <unitreal> 頁(yè)面寬度；--quiet 靜態(tài)模式，不在標(biāo)準(zhǔn)輸出中打印任何信息；#endregion
4、命令參數(shù)詳解附錄
https://wkhtmltopdf.org/usage/wkhtmltopdf.txt
自定義示例
1、轉(zhuǎn)換的HTML文件
<!DOCTYPE HTML><html> <head> <meta charset="gbk"> <title>測(cè)式文件</title> </head> <body> <div id="sse"> <input id="url" size=200 value="ws://127.0.0.1:8080/service" /><button id="btn1" onclick="changewebsocket(this)" tt=1>打開(kāi)連接</button><br> <input id="msg" size=200 value='測(cè)試內(nèi)容'/> <button onclick="sendmsg()">發(fā)送數(shù)據(jù)</button><br> <textarea id="onmsg" rows="10" cols="30"></textarea> </div> </body></html>
2、作為頁(yè)眉的HTML 文件
<!DOCTYPE html><html lang="en"> <head> <title> Testing </title> </head> <body> <table cellpadding="0" cellspacing="0" border="0" style="width:100%"> <tr> <td style="max-width:40%"> <img alt="text" src="https://profile-avatar.csdnimg.cn/7d678480185a4ae5babed86c378e532e_funniyuan.jpg!1" style="max-width:100%"> </td> <td style="max-width:60%"> <table cellpadding="0" cellspacing="0" border="0" style="width:100%"> <tr> <td align="center" style="font-size:30px;color:#e14a3a;font-family:SimHei;font-weight:600;padding:15px 0 5px"> Company Name </td> </tr> <tr> <td align="center" style="font-size:16px;color:#0a0f84;font-family:SimHei;padding-bottom:10px"> Invoice </td> </tr> </table> </td> </tr> <tr> <td colspan="2" style="width:100%;border-width:1px;border-style:solid;border-color:#000"> </td> </tr> </table> </body></html>
3、實(shí)現(xiàn)與調(diào)用
using System.Diagnostics;
namespace Fountain.WinConsole.ToPDFOrImageDemo{ public class ConverterPDF:IConverterEngine { /// <summary> /// wkhtmltopdf 工具路徑 /// </summary> public string ConverterPath { get; } /// <summary> /// 轉(zhuǎn)換類型 /// </summary> public int EngineType { get; } = 1; /// <summary> /// /// </summary> /// <param name="converterPath"></param> public ConverterPDF(string converterPath) { ConverterPath = converterPath; } /// <summary> /// /// </summary> /// <param name="htmlPath"></param> /// <param name="outputPath"></param> /// <returns></returns> public bool Convert(string htmlPath, string outputPath) { try { var ticks = DateTime.UtcNow.Ticks; string optionSwitches = "";
#region 頁(yè)眉 // 設(shè)置標(biāo)題字體大小 optionSwitches += "--header-font-size 10 "; // 將 header.html 作為頁(yè)眉內(nèi)容 optionSwitches += "--header-html header.html "; #endregion
#region 頁(yè)面 // 使用的打印介質(zhì)類型，而不是屏幕 optionSwitches += "--print-media-type "; // 邊距 optionSwitches += "--margin-top 40mm --margin-bottom 10mm --margin-right 10mm --margin-left 10mm "; // 紙張大小 optionSwitches += "--page-size A4 "; #endregion
#region 頁(yè)腳 // optionSwitches += "--footer-font-size 8 "; // 在頁(yè)腳的居中部分顯示頁(yè)腳文本 optionSwitches += "--footer-right \"[page]/[topage]\" "; #endregion
Process process = new Process(); process.StartInfo.UseShellExecute = true; process.StartInfo.FileName = this.ConverterPath; process.StartInfo.Arguments = $"{optionSwitches} \"{htmlPath}\" \"{outputPath}\" "; process.Start(); } catch (Exception ex) { throw new Exception("轉(zhuǎn)PDF出錯(cuò)", ex); } return true; } }}
using System.Text;
namespace Fountain.WinConsole.ToPDFOrImageDemo{ internal class Program { static void Main(string[] args) { var ticks = DateTime.UtcNow.Ticks; string outputpdf = $"{AppDomain.CurrentDomain.BaseDirectory}{ticks}.pdf"; string htmlPath = $"{AppDomain.CurrentDomain.BaseDirectory}test.html"; string convertPath= $"{AppDomain.CurrentDomain.BaseDirectory}wkhtmltopdf.exe"; ConverterPDF converter = new ConverterPDF(convertPath); converter?.Convert(htmlPath, outputpdf); Console.ReadKey(); } }}
小結(jié)
以上是頁(yè)眉和頁(yè)腳參數(shù)選項(xiàng)內(nèi)容介紹，并通過(guò)以個(gè)示例，了解其實(shí)現(xiàn)自定義頁(yè)眉和頁(yè)腳內(nèi)容的方式。
該文章在 2024/11/18 9:05:00 編輯過(guò)
400 186 1886
