导出为 PDF
本文涉及 dhtmlxScheduler 4.1 及以上版本的导出。如使用 dhtmlxScheduler 4.0 或更早版本，请参阅 此处 的详细信息。
自版本 4.1 起，dhtmlxScheduler 提供了一种将调度器导出为 PDF 格式的新方法：一种 在线导出服务。
该服务是免费的，但输出的 PDF 文件将包含在 GPL 许可下的库水印。若您购买许可证，导出结果在有效支持期内（所有 PRO 许可证为 12 个月）将不带水印。
使用导出服务
有多种导出服务可用。您可以将它们安装在本地计算机上，并本地将 Scheduler 导出为 PDF。
请注意，导出服务并不包含在 Scheduler 软件包中，请阅读 相应文章 以了解每种服务的使用条款。
请求大小限制
有一个通用 API 端点 https://export.dhtmlx.com/scheduler，提供诸如 exportToPDF() 与 exportToPNG() 等导出方法。最大请求大小为 10 MB。
默认导出为 PDF
要将调度器导出为 PDF 文档，请完成以下步骤：
- 若要使用在线导出服务，请通过
plugins()方法启用export_api插件：
scheduler.plugins({
export_api: true
});
如果您使用的 Scheduler 版本早于 7.0，请在页面中包含 https://export.dhtmlx.com/scheduler/api.js 文件以启用在线导出服务，例如：
<script src="codebase/dhtmlxscheduler.js"></script>
<script src="https://export.dhtmlx.com/scheduler/api.js"></script>
- 调用
exportToPDF()方法以导出 Scheduler：
<input value="Export to PDF" type="button" onclick='scheduler.exportToPDF()'/>
相关示例
export 方法的参数
exportToPDF() 方法接收一个包含若干属性的对象作为参数。所有属性都是可选的：
| name | (string) 导出 PDF 的文件名 |
| format | ('A0', 'A1', 'A2', 'A3', 'A4', 'A5') PDF 输出的纸张尺寸 |
| orientation | ('portrait', 'landscape') PDF 页面的方向 |
| zoom | (number) PDF 输出的缩放级别 |
| header | (string) PDF 顶部包含的 HTML 内容 |
| footer | (string) PDF 底部包含的 HTML 内容 |
| server | (string) 导出请求的 API 端点 URL。如果使用本地导出服务可设置此项。默认值为 https://export.dhtmlx.com/scheduler |
| additional_settings | (object) 其他导出选项，包括:
|
使用可选属性调用 export 方法
scheduler.exportToPDF({
name: "myscheduler.pdf",
format: "A4",
orientation: "portrait",
zoom: 1,
header: "<h1>My company</h1>",
footer: "<h4>Bottom line</h4>",
server: "https://myapp.com/myexport/scheduler"
});
输出文件的名称
要为输出文件设置自定义名称，请在 exportToPDF() 方法的参数中使用 name 属性：
scheduler.exportToPDF({
name: "my_beautiful_scheduler.pdf"
});
输出文件的页眉/页脚
要为输出的 PDF 文件添加页眉/页脚，请在 exportToPDF() 方法的参数中使用 header/footer 属性：
请注意，在指定参数时您可以使用任意 HTML。在指定图片时，请记得将全局路径设置为 src 属性的值。
scheduler.exportToPDF({
name: "myscheduler.pdf",
header: "<h1>My company</h1>",
footer: "<h4>Bottom line</h4>"
});
为输出文件应用自定义样式
要为调度器应用自定义样式，请提供包含自定义 CSS 类的样式表：
- 通过链接：
scheduler.exportToPDF({
name: "calendar.pdf",
header: '<link rel="stylesheet" href="http://mysite.com/custom.css">'
});
- 或通过 'style' 标签：
scheduler.exportToPDF({
name: "calendar.pdf",
header: '<style>... custom css classes here ...</style>'
});
注意，上述解决方案适用于全局 HTTP 引用。如果您的 CSS 类是在内网/本地环境中指定的，则可以按如下方式将所有样式嵌入：
scheduler.exportToPDF({
header: "<style>.tier1{background: red; color:white;}</style>"
});
导出 HTML 元素
在将 Scheduler 导出为 PDF 时，请注意由于潜在的安全性原因，对 HTML 元素的导出有所限制。
并非所有 HTML 元素都完全允许导出，例如 <canvas>、<svg>、<script> 以及其 src 属性包含 Base64 图像的图片。然而 ，在 SVG 与 Base64 格式中仍有可安全导出的图片方式：
- 您可以使用一个
<img/>元素，其src属性包含 SVG 格式的图片 URL（适用于 PNG 和 JPG，Base64 格式不适用），例如：
<img src="https://www.svgrepo.com/download/530597/hat.svg">
- 您可以使用样式元素，例如
background或background-image，并将url属性设为图片链接或 Base64 格式的图片作为其值（适用于 PNG/JPG/SVG 格式）
.red {
background: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAACNMs+9AAAABmJLR0QA/wD/AP+gvaeTAAAAB3RJTUUH1ggDCwMADQ4NnwAAAFVJREFUGJWNkMEJADEIBEcbSDkXUnfSgnBVeZ8LSAjiwjyEQXSFEIcHGP9oAi+H0Bymgx9MhxbFdZE2a0s9kTZdw01ZhhYkABSwgmf1Z6r1SNyfFf4BZ+ZUExcNUQUAAAAASUVORK5CYII=") 100%/contain no-repeat;
display: inline-block;
width: 32px;
height: 32px;
}
如果您有导出模块并且需要导出在线导出服务器不支持的 HTML 元素，您可以提交支持请求以获取关于对模块进行哪些修改以移除限制的说明。然而，请注意，这样做会使您的服务器容易受到 XSS 攻击。