概述
本 Demo 展示了如何在导出 PDF 时注册和使用自定义字体。演示了两种字体定制方式:通过 registerFont 方法注册自定义字体,以及通过 fallbackFont 方法为特定字体提供备选字体文件。
实现思路
加载预设的工作簿数据(使用 fromJSON 方法)
注册自定义字体 customfont1 到 PDF 字体管理器
为单元格设置自定义字体的样式
设置备选字体函数,将 Calibri 字体替换为 customfont2
配置打印信息(边框、网格线、居中等)
点击按钮导出包含自定义字体的 PDF 文件
代码解析
注册自定义字体
使用 PDFFontsManager.registerFont 方法注册字体。name 参数指定字体名称,font 参数是一个对象,包含字体的不同样式(如 normal、bold、italic 等),值为字体文件的 ArrayBuffer 或 base64 编码。
为单元格设置自定义字体
获取单元格样式后,设置 fontFamily 属性为已注册的字体名称,然后应用样式。导出 PDF 时会使用注册的字体文件。
设置备选字体
重写 fallbackFont 方法可以为特定字体提供备用字体。font 参数是 CSS 字体字符串(如 "11px Calibri"),方法返回对应的字体文件。当导出时遇到 Calibri 字体,会使用 customfont2.ttf 替代。
导出 PDF
调用工作簿的 savePDF 方法,成功回调中获取 Blob 对象并保存为文件。
运行效果
表格加载后,第 0 行第 0 列的单元格使用了自定义字体 customfont1
点击「导出 PDF」按钮,工作簿导出为 PDF 文件
导出的 PDF 中,customfont1 字体的内容会使用注册的字体文件渲染
所有原本使用 Calibri 字体的内容,会自动替换为 customfont2 字体显示
API 参考
PDFFontsManager.registerFont
name: 字体名称
font: 字体对象,包含不同样式(如 { normal: ArrayBuffer })
PDFFontsManager.fallbackFont
font: CSS 字体字符串
返回值:字体文件的 ArrayBuffer 或 base64 编码
Workbook.savePDF
successCallback: 成功回调,参数为 Blob 对象
errorCallback: 错误回调
options: 可选,PDF 元数据(title、author 等)
sheetIndex: 可选,指定导出的工作表索引
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {sheetCount: 2});
initSpread(spread);
};
function initSpread(spread) {
document.getElementById('savePDF').onclick = function () {
spread.savePDF(function (blob) {
saveAs(blob, 'download.pdf');
}, console.log);
};
var data = report, fontsObj = fonts;
spread.fromJSON(data);
var sheet = spread.getActiveSheet();
sheet.setColumnWidth(0, 50);
sheet.setColumnWidth(1, 120);
sheet.setColumnWidth(2, 60);
sheet.setColumnWidth(3, 60);
// Register the specific custom font.
registerCustomFont(fontsObj);
setCustomFontForCell(sheet);
// Provide a custom font file for the specific font string.
customizeFont(fontsObj);
// setting printInfo
setPrintInfo(spread);
}
function registerCustomFont(fontsObj) {
var fonts = {
normal: fontsObj["customfont1.ttf"]
};
GC.Spread.Sheets.PDF.PDFFontsManager.registerFont('customfont1', fonts);
}
function setCustomFontForCell (sheet) {
var style = sheet.getStyle(0, 0);
style.fontFamily = 'customfont1';
sheet.setStyle(0, 0, style);
}
function customizeFont(fontsObj) {
var fonts = {
normal: fontsObj["customfont2.ttf"]
};
GC.Spread.Sheets.PDF.PDFFontsManager.fallbackFont = function (font) {
var fontInfoArray = font.split(' '), fontName = fontInfoArray[fontInfoArray.length - 1];
if (fontName === 'Calibri') {
return fonts.normal;
}
}
}
function setPrintInfo(spread) {
var sheet = spread.getActiveSheet();
var printInfo = sheet.printInfo();
printInfo.showBorder(true);
printInfo.showGridLine(false);
printInfo.showColumnHeader(GC.Spread.Sheets.Print.PrintVisibilityType.hide);
printInfo.showRowHeader(GC.Spread.Sheets.Print.PrintVisibilityType.hide);
printInfo.centering(GC.Spread.Sheets.Print.PrintCentering.horizontal);
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta name="spreadjs culture" content="zh-cn" />
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/FileSaver.js" type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-print/dist/gc.spread.sheets.print.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-pdf/dist/gc.spread.sheets.pdf.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/data/fonts.js" type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/data/pdfExportData.js" type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" class="sample-spreadsheets"></div>
<div class="options-container">
<p>点击此按钮,将带有自定义字体的 Spread 工作簿保存为 PDF 文件。</p>
<div class="option-row">
<input type="button" value="导出 PDF" id="savePDF">
</div>
</div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 280px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 280px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
.option-row {
font-size: 14px;
padding: 5px;
margin-top: 10px;
}
input {
padding: 8px 14px;
display: block;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}