从 4.1 版本开始,dhtmlxScheduler 提供了一个在线导出服务,允许您将调度器导出为 PNG 图像。
该服务是免费的,但导出的 PNG 图片将在 GPL 许可下包含库的水印。如果您购买了许可证,在有效支持期内(所有 PRO 许可证为 12 个月),导出将不会有水印。
您可以选择不同的导出服务。可以将它们本地安装在您的机器上,从而无需依赖在线服务即可导出 Scheduler 为 PNG。
请注意,导出服务并未与 Scheduler 包一起提供。有关各服务的使用条款,请参阅相关文档。
所有导出方法(如 exportToPDF、exportToPNG 等)都使用统一的 API 端点 https://export.dhtmlx.com/scheduler。允许的最大请求大小为 10 MB。
要将调度器导出为 PNG 图像,请按照以下步骤操作:
scheduler.plugins({
export_api: true
});
对于 7.0 之前的 Scheduler 版本,还需要在页面中引入 https://export.dhtmlx.com/scheduler/api.js 脚本以激活在线导出服务,例如:
<script src="codebase/dhtmlxscheduler.js"></script>
<script src="https://export.dhtmlx.com/scheduler/api.js"></script>
<input value="Export to PNG" type="button" onclick='scheduler.exportToPNG()'>
Related sample: Export to PDF/PNG
exportToPNG() 方法接受一个包含多个可选属性的对象:
name | (string) 指定输出文件的名称 |
format | ('A0', 'A1', 'A2', 'A3', 'A4', 'A5') 设置输出 PNG 图片的格式 |
orientation | ('portrait', 'landscape') 设置输出 PNG 图片的方向 |
zoom | (number) 控制输出 PNG 图片的缩放级别 |
header | (string) 为输出 PNG 图片添加页眉;可以使用任意 HTML |
footer | (string) 为输出 PNG 图片添加页脚;可以使用任意 HTML |
server | (string) 指定导出请求的 API 端点。如果您运行了本地导出服务,可用此参数。默认值为 https://export.dhtmlx.com/scheduler |
调用导出方法并带有可选参数的示例
scheduler.exportToPNG({
format:"A4",
orientation:"portrait",
zoom:1,
header:"<h1>My company</h1>",
footer:"<h4>Bottom line</h4>",
server:"https://myapp.com/myexport/scheduler"
});
您可以在 exportToPNG 方法中通过 name 属性自定义导出的 PNG 文件名:
scheduler.exportToPNG({
name:"my_beautiful_scheduler.png"});
要在输出 PNG 中包含页眉或页脚,请在 exportToPNG 方法中使用 header 和 footer 属性:
这里可以插入任意 HTML。若包含图片,请确保 "src" 属性使用全局 URL。
scheduler.exportToPNG({
name:"myscheduler.png",
header:"<h1>My company</h1>",
footer:"<h4>Bottom line</h4>"
});
要为导出的调度器应用自定义样式,可以通过以下任一方法添加 CSS:
scheduler.exportToPNG({
name:"calendar.png",
header:'<link rel="stylesheet" href="http://mysite.com/custom.css">' });
scheduler.exportToPNG({
name:"calendar.png",
header:'<style>... custom css classes here ...</style>' });
如果您的 CSS 存放在本地或内网,也可以将所有样式内联嵌入,如下所示:
scheduler.exportToPNG({
header:"<style>.tier1{ background: red; color:white;}</style>"
});
导出 Scheduler 为 PNG 时,请注意,出于安全考虑,某些 HTML 元素的导出是受限的。
如 <canvas>
、<svg>
、<script>
以及 Base64 src 属性的图片等元素并不完全支持。但您可以通过安全方式在 SVG 和 Base64 格式中包含图片:
<img>
标签,指向 SVG 图片 URL(适用于 PNG 和 JPG 导出,但不适用于 Base64),例如:<img src=https://www.svgrepo.com/download/530597/hat.svg>
url
可指向图片 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 漏洞风险中。
返回顶部