экспортирует диаграмму Ганта в виде PNG изображения
| export | object | необязательный, объект с параметрами экспорта (подробнее см. ниже) |
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);
}
});
Этот метод является частью расширения export, поэтому убедитесь, что плагин export_api включён. Дополнительную информацию можно найти в статье Экспорт в PDF и PNG.
Для версий Gantt старше 8.0 необходимо подключить скрипт 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) HTML содержимое, добавляемое в шапку экспортируемого PNG |
| footer | (string) HTML содержимое, добавляемое в подвал экспортируемого PNG |
| server | (string) URL API эндпоинта для запросов экспорта. Полезно, если у вас есть локальный сервис экспорта. По умолчанию https://export.dhtmlx.com/gantt |
| raw | (boolean) если true, экспортирует разметку Gantt точно как есть, включая кастомные элементы. По умолчанию false. Подробнее |
| callback | (function) функция обратного вызова, получающая JSON объект с URL для загрузки сгенерированного PNG |
| additional_settings | (object) дополнительные настройки, включая:
|
Максимальный размер экспорта — 10000×10000 пикселей.
Вы можете задать ширину и высоту с помощью свойств width и height в additional_settings, но если произведение этих значений превысит 100000000 (10000×10000), экспортируемое PNG будет обрезано.
Для работы с большими диаграммами можно экспортировать их по частям и упаковывать в архив с помощью опции slice_archive в additional_settings:
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
Одновременный экспорт от нескольких пользователей может увеличить время обработки, но время экспорта для каждого пользователя отслеживается отдельно.
Для экспорта больших диаграмм рассмотрите использование standalone export module. Этот модуль бесплатен при наличии лицензий Commercial, Enterprise или Ultimate, либо может быть приобретён отдельно здесь.