使用 IronPDF C# 在 PDF 中設定字型
IronPDF 允許 C# 開發人員從 HTML 建立帶有自訂 Web 字體和圖示字體的 PDF。 它支援像是Google Fonts這樣的外部字型服務以及透過CSS @font-face 規則的本地字型檔案,確保在所有生成的PDF中保持一致的字體。
網頁字體是專為網站設計的字體。 這些字體託管在網站伺服器上,並透過網頁瀏覽器下載,以確保網站上的文字渲染效果一致且美觀,而無需考慮使用者本地字體的可用性。 此外,使用符號和字形的圖標字體經常用於網頁設計中,以創建可縮放、可自訂的圖標,並透過 CSS 操作保持視覺上一致的使用者介面。 藉由IronPDF的字型管理功能,開發者可以輕鬆將這些字型整合到PDF生成工作流程中。
CSS 包含網頁字體,可讓您指定在造訪您的網站時要下載的字體檔案。 IronPDF 支援字型載入以及從 HTML 渲染至 PDF,因此非常適合製作需要特定品牌或排版標準的文件。 對於處理國際內容的開發者,IronPDF也提供UTF-8和國際語言支援。
快速入門:在 PDF 生成中使用 Web 字體使用 IronPDF 的 C# 函式庫將網頁和圖示字型納入您的 PDF。 本指南將教您如何使用自訂字型來呈現 HTML 內容,以確保 PDF 的一致性和視覺吸引力。 只需使用 IronPDF 渲染 HTML,即可在幾秒鐘內儲存樣式化的文件。 在開始之前,請確保您已在專案中安裝IronPDF。
-
1使用 IronPDF 安裝 NuGet Package Manager
-
2複製並運行這段程式碼。
new IronPdf.ChromePdfRenderer { RenderingOptions = { WaitFor = IronPdf.Rendering.WaitFor.AllFontsLoaded(2000) } } .RenderHtmlAsPdf("<link href=\"https://fonts.googleapis.com/css?family=Lobster\" rel=\"stylesheet\">" + "<link href=\"https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css\" rel=\"stylesheet\">" + "<p style=\"font-family:'Lobster', serif; font-size:30px;\">Hello Google Font</p>" + "<i class=\"fa fa-coffee\" style=\"font-size:40px; color:#b00;\"></i>") .SaveAs("webfonts-icons.pdf");Dim renderer As New IronPdf.ChromePdfRenderer() With { .RenderingOptions = New IronPdf.Rendering.PdfRenderingOptions() With { .WaitFor = IronPdf.Rendering.WaitFor.AllFontsLoaded(2000) } } renderer.RenderHtmlAsPdf("<link href=""https://fonts.googleapis.com/css?family=Lobster"" rel=""stylesheet"">" & "<link href=""https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css"" rel=""stylesheet"">" & "<p style=""font-family:'Lobster', serif; font-size:30px;"">Hello Google Font</p>" & "<i class=""fa fa-coffee"" style=""font-size:40px; color:#b00;""></i>") _ .SaveAs("webfonts-icons.pdf")Dim renderer As New IronPdf.ChromePdfRenderer() With { .RenderingOptions = New IronPdf.Rendering.PdfRenderingOptions() With { .WaitFor = IronPdf.Rendering.WaitFor.AllFontsLoaded(2000) } } renderer.RenderHtmlAsPdf("<link href=""https://fonts.googleapis.com/css?family=Lobster"" rel=""stylesheet"">" & "<link href=""https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css"" rel=""stylesheet"">" & "<p style=""font-family:'Lobster', serif; font-size:30px;"">Hello Google Font</p>" & "<i class=""fa fa-coffee"" style=""font-size:40px; color:#b00;""></i>") _ .SaveAs("webfonts-icons.pdf") -
3部署到您的生產環境進行測試
立即在您的項目中開始使用 IronPDF,並使用 免費試用
最小工作流程(5 個步驟)
- 下載C#程式庫IronPDF以在PDF中設置字型
- 使用 HTML 從外部來源匯入或請求字體
- 延遲渲染過程以確保正確的字體加載
- 如常渲染 HTML 至 PDF
- 使用CSS 樣式中的
@font-face規則匯入字體文件
如何在PDF中使用WebFonts和Icons?
IronPDF支援WebFonts(例如Google Fonts和Adobe web font API)以及圖示字型,像是Bootstrap和FontAwesome使用的圖示字型。 這種支援使 IronPDF 適合需要精密排版的專案,從簡單的文件到包含品牌元素的複雜報表。
字體通常需要延遲渲染才能正確載入。 如果字體載入不正確,可能會導致頁面空白,沒有任何文字。 您可以使用WaitFor.AllFontsLoaded方法透過指派最大等待時間來等待所有字型加載完成。 預設最大等待時間為500ms。 對於涉及JavaScript或動態內容的更複雜情境,請探索我們的HTML到PDF教學,涵蓋進階的渲染技術。
以下是一個小範例,展示如何在專案中使用一個名為Lobster的WebFont。
using IronPdf;
// HTML contains webfont
var html = @"<link href=""https://fonts.googleapis.com/css?family=Lobster"" rel=""stylesheet"">
<p style=""font-family: 'Lobster', serif; font-size:30px;"" > Hello Google Fonts</p>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Wait for font to load
renderer.RenderingOptions.WaitFor.AllFontsLoaded(2000);
// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
// Export the PDF
pdf.SaveAs("font-test.pdf");using IronPdf;
// HTML contains webfont
var html = @"<link href=""https://fonts.googleapis.com/css?family=Lobster"" rel=""stylesheet"">
<p style=""font-family: 'Lobster', serif; font-size:30px;"" > Hello Google Fonts</p>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Wait for font to load
renderer.RenderingOptions.WaitFor.AllFontsLoaded(2000);
// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
// Export the PDF
pdf.SaveAs("font-test.pdf");Imports IronPdf
' HTML contains webfont
Private html = "<link href=""https://fonts.googleapis.com/css?family=Lobster"" rel=""stylesheet"">
<p style=""font-family: 'Lobster', serif; font-size:30px;"" > Hello Google Fonts</p>"
Private renderer As New ChromePdfRenderer()
' Wait for font to load
renderer.RenderingOptions.WaitFor.AllFontsLoaded(2000)
' Render HTML to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
' Export the PDF
pdf.SaveAs("font-test.pdf")Imports IronPdf
' HTML contains webfont
Private html = "<link href=""https://fonts.googleapis.com/css?family=Lobster"" rel=""stylesheet"">
<p style=""font-family: 'Lobster', serif; font-size:30px;"" > Hello Google Fonts</p>"
Private renderer As New ChromePdfRenderer()
' Wait for font to load
renderer.RenderingOptions.WaitFor.AllFontsLoaded(2000)
' Render HTML to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
' Export the PDF
pdf.SaveAs("font-test.pdf")探索更多WaitFor選項,例如用於字型、JavaScript、HTML元素和網路空閒的選項,請參閱 '類別文件'。 如需能根據螢幕大小調整字型的響應式設計,請查看我們的響應式CSS用於PDF渲染的指南。
為什麼字型加載時間很重要?
如果字體載入不正確,可能會導致頁面空白,沒有任何文字。 您可以使用WaitFor.AllFontsLoaded方法透過指派最大等待時間來等待所有字型加載完成。 預設最大等待時間為500ms。 此計時考量在處理複雜的網頁應用程式或在渲染WebGL內容到PDF時特別重要,因為需要按順序加載多個資源。
字型載入延遲會因多種因素而異,包括網路速度、字型檔案大小和伺服器回應時間。當使用多種自訂字型或圖示庫時,建議增加等待時間,以確保所有排版都能正確呈現。 這對於專業文件尤其重要,因為字體遺失可能會影響可讀性和品牌一致性。
支援哪些字型服務?
IronPDF支援WebFonts(例如Google Fonts和Adobe web font API)以及圖示字型,像是Bootstrap和FontAwesome使用的圖示字型。 此外,IronPDF 還支援以下功能:
- Google 字體 (整個目錄)
- Adobe 字體 (Typekit)
- Font Awesome 圖示(所有版本)
- Bootstrap 圖示
- 材質設計圖示
- 自訂網頁字體服務透過 CSS
@import或link標籤 - 自行託管的字體檔案支援多種格式 (
TTF,OTF,WOFF,WOFF2)
如果字型未正確加載會發生什麼?
字體通常需要延遲渲染才能正確載入。 如果字體載入不正確,可能會導致頁面空白,沒有任何文字。 在這種情況下,瀏覽器通常會回退到系統預設字型,這可能會破壞您文件的視覺一致性。 IronPDF 提供多種機制來處理字型載入失敗:
- 備援字型鏈:在您的CSS
font-family宣告中定義多個字型 - 延長等待時間:對於較慢的連接,增加
AllFontsLoaded超時時間 - 本地字型嵌入:使用
@font-face和base64編碼字型以保證可用性 - 字型預加載:使用HTML預加載標籤來優先處理字型加載
如何直接匯入字型檔案?
要使用現有的字型檔案,請在CSS樣式中應用@font-face規則。 當使用@font-face規則和嵌入base64編碼的woff檔案的組合時也有效。 在以下示例中,我將使用Pixelify Sans Font。
using IronPdf;
// Import custom font
string html = @"<!DOCTYPE html>
<html>
<head>
<style>
@font-face {font-family: 'Pixelify';
src: url('fonts\PixelifySans-VariableFont_wght.ttf');
}
p {
font-family: 'Pixelify';
font-size: 70px;
}
</style>
</head>
<body>
<p>Custom font</p>
</body>
</html>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
// Export the PDF
pdf.SaveAs("customFont.pdf");using IronPdf;
// Import custom font
string html = @"<!DOCTYPE html>
<html>
<head>
<style>
@font-face {font-family: 'Pixelify';
src: url('fonts\PixelifySans-VariableFont_wght.ttf');
}
p {
font-family: 'Pixelify';
font-size: 70px;
}
</style>
</head>
<body>
<p>Custom font</p>
</body>
</html>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
// Export the PDF
pdf.SaveAs("customFont.pdf");Imports IronPdf
' Import custom font
Private html As String = "<!DOCTYPE html>
<html>
<head>
<style>
@font-face {font-family: 'Pixelify';
src: url('fonts\PixelifySans-VariableFont_wght.ttf');
}
p {
font-family: 'Pixelify';
font-size: 70px;
}
</style>
</head>
<body>
<p>Custom font</p>
</body>
</html>"
Private renderer As New ChromePdfRenderer()
' Render HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
' Export the PDF
pdf.SaveAs("customFont.pdf")Imports IronPdf
' Import custom font
Private html As String = "<!DOCTYPE html>
<html>
<head>
<style>
@font-face {font-family: 'Pixelify';
src: url('fonts\PixelifySans-VariableFont_wght.ttf');
}
p {
font-family: 'Pixelify';
font-size: 70px;
}
</style>
</head>
<body>
<p>Custom font</p>
</body>
</html>"
Private renderer As New ChromePdfRenderer()
' Render HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
' Export the PDF
pdf.SaveAs("customFont.pdf")我可以使用哪些字型檔案格式?
要使用現有的字型檔案,請在CSS樣式中應用@font-face規則。 當使用@font-face規則和嵌入base64編碼的woff檔案的組合時也有效。 IronPDF 支援下列字型檔案格式:
- TTF(TrueType Font):廣泛支援,適合螢幕和打印
- OTF(OpenType Font):高級排版功能,適用於專業文件
- WOFF(Web Open Font Format):為網頁使用優化的壓縮格式
- WOFF2:在WOFF的基礎上改進了壓縮,檔案大小更小
- EOT(Embedded OpenType):舊版瀏覽器的遺留格式
- SVG字型:基於向量的字型(在某些平台上的應用有局限)
何時應使用本地字型與網頁字型?
要使用現有的字型檔案,請在CSS樣式中應用@font-face規則。 本地字體和網頁字體之間的選擇取決於幾個因素:
在下列情況下使用本地字體:
- 在離線或限制網絡環境下工作
- 需要確保字體的可用性
- 使用專有或受許可的字體
- 優化以實現無網絡延遲地更快渲染
- 創建具有嚴格合規性要求的文件
在下列情況下使用網路字型:
- 使用大型字體庫,如Google Fonts
- 需要自動更新字體文件
- 最小化應用程序包大小
- 處理頻繁改變的排版要求
- 建立已經依賴網際網路連線的應用程式
使用Azure時有哪些限制?
Azure託管平台不支援在其較低的共享網頁應用層中載入SVG字型的伺服器。 然而,Azure 的 VPS 和 Web 角色並非以相同的方式進行沙盒隔離,並且支援 Web 字體渲染。 欲獲得詳細的Azure部署指南,請參閱我們的Azure部署指南,其中涵蓋所有層級特定限制及解決方案。
哪些Azure層級支援字型渲染?
然而,Azure 的 VPS 和 Web 角色並非以相同的方式進行沙盒隔離,並且支援 Web 字體渲染。 以下是 Azure 層級支援的細目:
完整字型支援:
- Azure 虛擬機(所有大小)
- Azure Web 角色
- App Service 高級層級 (
P1v2,P2v2,P3v2) - App Service Isolated 級別
有限的字型支援:
- App Service 基本層級 (
B1,B2,B3) - 僅支援網頁字體 - App Service 標準層級 (
S1,S2,S3) - 一些 SVG 字體限制
不支援自訂字型:
- App Service Free層級(
F1) - App Service Shared層級(
D1)
為什麼較低的Azure層級有字型限制?
Azure託管平台因沙箱限制和資源限制不支援在其較低的共享網頁應用層中載入SVG字型的伺服器。 較低層級會實施嚴格的安全邊界,以防止自訂字型渲染所需的某些系統層級作業。 這些限制有助於 Azure 維護多租戶隔離,並防止共用環境中的資源濫用。
若要解決這些限制,請考慮
- 在您的 CSS 中將字體嵌入為 base64 編碼字串
- 僅使用來自 CDNs 的網頁字體
- 在支持的環境中預渲染 PDF
- 升級到支援完整字型的更高Azure層級
https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face
常見問題
如何使用IronPDF在PDF中整合網頁字型?
您可以使用IronPDF透過Google字型等外部服務加載字型檔案,或使用CSS @font-face規則與本地字型檔案來在PDF中整合網頁字型。IronPDF支援使用WaitFor.AllFontsLoaded方法來延遲渲染過程,以確保在生成PDF前載入所有字型。
IronPDF提供哪些方法來確保字型載入成功?
IronPDF提供了多種方法來確保字型載入成功,包括使用WaitFor.AllFontsLoaded方法延遲渲染、定義備用字型鏈、延長等待時間、使用@font-face嵌入本地字型,並使用HTML預載標籤預載字型。
在使用IronPDF時,本地字型與網頁字型有何不同?
本地字型適合離線工作或需要保證可用性的情況,而網頁字型,例如Google字型,則適用於需要經常更新且擁有多樣字型選擇的互聯網連接項目。IronPDF支援這兩種選項,允許根據項目需求靈活使用。
IronPDF支援哪些字型格式?
IronPDF支援多種字型格式,包括TTF、OTF、WOFF、WOFF2、EOT和SVG字型,允許您根據不同顯示和專業需求自定義PDF中的字體。
如果在IronPDF生成的PDF中字型載入失敗會發生什麼情況?
若字型載入失敗,IronPDF會退回使用系統默認字型,這可能影響視覺設計。為避免此情況,您可以設定較長的字型載入等待時間、直接嵌入字型或使用定義的備用字型,以確保生成PDF的視覺一致性。
IronPDF可以渲染帶有圖標字型的PDF嗎?
可以,IronPDF可以通過在HTML內容中透過CSS整合FontAwesome和Bootstrap Icons等圖標字型,並使用網路字型或本地字型機制來加載這些字型,以渲染PDF。
為什麼字型載入時間在使用IronPDF生成PDF時很重要?
字型載入時間很重要,因為如果字型在生成PDF前未正確載入,可能導致空白頁面或顯示不正確。IronPDF使用WaitFor.AllFontsLoaded方法來管理此操作,確保所有字型在指定等待時間內載入。
IronPDF支援哪些線上字型服務?
IronPDF支援多種線上字型服務,包括Google字型、Adobe字型、Font Awesome、Bootstrap Icons和Material Design Icons等,提供豐富的PDF客製化字體選擇。
IronPDF如何在Azure上處理字型渲染?
IronPDF在Azure上處理字型渲染時,支援其虛擬機、Web Roles以及Premium和Isolated階層中進行字型渲染。然而,由於沙箱限制,較低的Azure階層如Free和Shared存在限制。
在Azure上使用SVG字型與IronPDF有何限制?
由於沙箱限制,Azure託管平台在其較低的共享Web應用階層中不支援SVG字型。要克服這些限制,可以將字型嵌入為base64編碼字符串,或者升級至支援完整字型的較高Azure階層。
Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。