exportToPNG

导出甘特图为 PNG 图片

void exportToPNG( [object export] );

export

object

可选，包含导出选项的对象（详见下文）

Example

gantt.exportToPNG();
 
//或
gantt.exportToPNG({
  name: "mygantt.png"
});
 
//或
gantt.exportToPNG({
    name:"mygantt.png",
    header:"<h1>My company</h1>",
    footer:"<h4>Bottom line</h4>",
    locale:"en",
    start:"01-04-2013",
    end:"11-04-2013",
    skin:'terrace',
    data:{ },
    server:"https://myapp.com/myexport/gantt",
    raw:true,
    callback: function(res){
        alert(res.url);
    }
});

Details

该方法属于 export 扩展，因此请确保已启用 export_api 插件。更多信息请参见导出为 PDF 和 PNG 文章。

对于 8.0 版本之前的 Gantt，需要在页面中引入 https://export.dhtmlx.com/gantt/api.js 脚本以使用在线导出服务，例如：

<script src="codebase/dhtmlxgantt.js"></script>
<script src="https://export.dhtmlx.com/gantt/api.js"></script>

exportToPNG 方法接受一个对象参数，包含多个可选属性：

name	(string) 导出 PNG 的文件名
skin	('terrace', 'skyblue', 'meadow', 'broadway') 导出甘特图的视觉主题
locale	(string) 导出甘特图的语言设置
start	(string) 导出图表中显示数据范围的开始日期。日期格式遵循 date_format 的设置
end	(string) 导出图表中显示数据范围的结束日期。日期格式遵循 date_format 的设置
data	(object) 提供用于导出图表的自定义数据源
header	(string) 作为页眉添加到导出 PNG 中的 HTML 内容
footer	(string) 作为页脚添加到导出 PNG 中的 HTML 内容
server	(string) 导出请求的 API 端点 URL。适用于本地导出服务。默认值为 https://export.dhtmlx.com/gantt
raw	(boolean) 若为 true，则精确导出甘特图的 markup，包括自定义元素。默认值为 false。更多详情
callback	(function) 回调函数，接收包含生成 PNG 下载 URL 的 JSON 对象
additional_settings	(object) 额外设置，包括： width - (number\|string) 输出页面的宽度 height - (number\|string) 输出页面的高度注意如果设置了 slice_archive，则 width 和 height 会被忽略。 slice_archive - (boolean\|object) 启用分片导出大图并打包成归档文件。如果是对象，则接受 width 和 height 选项。若设置为 true，默认分片大小为 1000×1000。 slice_check - (boolean) 在归档中添加一个 HTML 页面，用于验证所有分片是否正确导出。

分片导出大型甘特图

最大导出尺寸限制为 10000×10000 像素。

你可以通过 additional_settings 中的 width 和 height 属性调整宽高，但如果两者乘积超过 100000000（10000×10000），导出的 PNG 会被裁剪。

若需导出更大图表，可以通过 additional_settings 中的 slice_archive 选项将图表分片导出并打包成归档：

gantt.exportToPNG({
    server: "https://export.dhtmlx.com/beta/gantt",
    additional_settings:{
        //width: 2000,
        //height: 2000,
        slice_archive: {width: 2000, height: 2000},
        slice_check: true,
    }
});

示例： 导出为 PNG 图片

你可以通过将 slice_archive 设置为带有 width 和 height 的对象来指定分片大小：

slice_archive: {width: 2000, height: 2000}

或者直接设置为 true，使用默认的 1000×1000 分片大小：

slice_archive: true

时间限制

导出服务对处理时间有限制。

如果导出时间超过 20 秒，导出将被取消，且会显示以下错误：

Error: Timeout trigger 20 seconds

多个用户同时导出可能会增加处理时间，但每个用户的导出时间是单独计时的。

若需导出大型图表，建议使用独立导出模块。该模块随 Commercial、Enterprise 或 Ultimate 许可证免费提供，或可单独购买此处。