exportToPNG

экспортирует диаграмму Ганта в формате PNG

void exportToPNG( [object export] );

export

object

необязательный, объект с настройками экспорта (см. детали)

Example

gantt.exportToPNG();
 
//или
gantt.exportToPNG({
  name: "mygantt.png"
});
 
//или
gantt.exportToPNG({
    name:"mygantt.png",
    header:"<h1>Моя компания</h1>",
    footer:"<h4>Итог</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.

Если вы используете версию 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) имя выходного файла
skin	('terrace', 'skyblue', 'meadow', 'broadway') скин выходной диаграммы Ганта
locale	(string) устанавливает язык, который будет использоваться в выходной диаграмме Ганта
start	(string) устанавливает дату начала диапазона данных, который будет представлен в выходной диаграмме Ганта. Формат даты определяется конфигурацией date_format
end	(string) устанавливает дату окончания диапазона данных, который будет представлен в выходной диаграмме Ганта. Формат даты определяется конфигурацией date_format
data	(object) устанавливает пользовательский источник данных, который будет представлен в выходной диаграмме Ганта
header	(string) указывает заголовок, который будет добавлен к выходному изображению PDF. Обратите внимание, что здесь можно использовать любой HTML
footer	(string) указывает подвал, который будет добавлен к выходному изображению PDF. Обратите внимание, что здесь можно использовать любой HTML
server	(string) устанавливает конечную точку API для запроса. Может использоваться с локальной установкой сервиса экспорта. Значение по умолчанию - https://export.dhtmlx.com/gantt
raw	(boolean) определяет, что весь разметка Ганта будет экспортирована как есть, со всеми пользовательскими элементами. false по умолчанию. Читать детали
callback	(function) Если вы хотите получить URL для загрузки сгенерированного PNG файла, можно использовать свойство callback. Оно получает JSON объект с свойством url
additional_settings	(object) объект с дополнительными настройками. Объект может содержать следующие атрибуты: width - (number\|string) ширина выходной страницы height - (number\|string) высота выходной страницы Атрибуты width и height будут проигнорированы, если указан slice_archive. slice_archive - (boolean\|object) позволяет сохранять большой график по частям и получать их в архиве. В качестве объекта атрибут принимает параметры width и height. Если размер части не определен (т.е. slice_archive: true), размеры по умолчанию составляют 1000×1000. slice_check - (boolean) добавляет HTML страницу в архив. Страница позволяет проверить, что все части экспортированы корректно.

Экспорт больших диаграмм Ганта по частям

Максимальные размеры экспортируемого файла составляют 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 изображения

Вы можете либо определить размеры выходных PNG изображений, установив атрибут как объект с параметрами width и height:

slice_archive: {width: 2000, height: 2000}

либо установить атрибут в true. В этом случае экспортированные части диаграммы Ганта будут иметь размеры по умолчанию: 1000×1000.

slice_archive: true

Временные ограничения

Сервис экспорта имеет временные ограничения.

Если процесс занимает более 20 секунд, экспорт будет отменен, и произойдет следующая ошибка:

Error: Timeout trigger 20 seconds

Если несколько человек экспортируют диаграмму Ганта одновременно, процесс может занять больше времени, чем обычно. Но это нормально, так как время, затраченное на запрос экспорта от конкретного пользователя, учитывается отдельно.

Если вам нужно экспортировать большие диаграммы, вы можете использовать отдельный модуль экспорта. Модуль экспорта предоставляется бесплатно, если вы приобрели Gantt по лицензии Commercial, Enterprise или Ultimate, или вы можете купить модуль отдельно.