Свойства задачи
На этой странице представлен полный перечень свойств, которые может содержать объект задачи.
Полный список свойств объекта связи смотрите в статье Link Properties.
Обязательные свойства
Эти свойства всегда определяются на стороне клиента. Gantt ожидает наличие этих свойств в объекте задачи при загрузке данных. Если они отсутствуют, Gantt добавит их автоматически. Удаление любого из этих свойств из загруженных задач приведет к ошибкам.
| Имя | Тип | Описание |
|---|---|---|
| id | string | number | Идентификатор задачи, автоматически генерируется, если не указан |
| start_date | Date | Запланированная дата начала задачи. Если не указана, Gantt вычисляет ее на основе свойств end_date и duration. Это свойство становится необязательным, если установлено unscheduled: true. |
| end_date | Date | Запланированная дата завершения задачи. Если не указана, Gantt вычисляет ее на основе свойств start_date и duration. Это свойство становится необязательным, если установлено unscheduled: true. |
| duration | number | Длительность задачи. Если не указана, Gantt вычисляет ее на основе свойств start_date и end_date. |
Необязательные свойства
Эти свойства могут присутствовать или отсутствовать. Стандартная логика и шаблоны в Gantt будут использовать эти свойства, если они доступны.
| Имя | Тип | Описание |
|---|---|---|
| auto_scheduling | boolean | Определяет, должен ли Gantt выполнять авто-планирование для задачи (true или не указано), либо нет (false) |
| bar_height | number | Задает высоту DOM-элемента задачи на временной шкале |
| baselines | Baseline[] | Массив, содержащий базовые планы |
| calendar_id | number | string | Присваивает задаче id пользовательского календаря. Имя свойства зависит от опции calendar_property |
| color | string | Устанавливает цвет задачи на временной шкале (применяется к background-color элемента gantt_task_line) |
| constraint_date | Date | Дата ограничения задачи, добавляется при авто-планировании с временными ограничениями. Не используется, если включен auto_scheduling_compatibility. |
| constraint_type | string | Определяет тип ограничения задачи ("asap", "alap", "snet", "snlt", "fnet", "fnlt", "mso", "mfo"). Добавляется при авто-планировании с временными ограничениями. Не используется, если включен auto_scheduling_compatibility. |
| deadline | Date | Устанавливает дату дедлайна для задачи. Временная шкала отображает визуальный индикатор, если это свойство задано. |
| editable | boolean | Определяет, может ли задача быть отредактирована в режиме только для чтения. Имя свойства зависит от опции editable_property |
| group_id | string | number | Идентификатор группы, к которой принадлежит задача. Добавляется при группировке задач по свойству, указанному в relation_property метода groupBy(). |
| hide_bar | boolean | Определяет, должна ли задача (type:"task") или веха (type:"milestone") быть с крыта на временной шкале |
| key | string | number | Ключ группы, добавляется при группировке задач по массивному свойству в relation_property метода groupBy(). Также добавляется к задачам с именем группы (например, "High", "Normal", "Low" при группировке по приоритету). См. пример. |
| label | string | Метка группы, добавляется к задачам с именем группы (например, "High", "Normal", "Low" при группировке по приоритету). См. пример. |
| open | boolean | Показывает, открыта ли ветка задачи для отображения дочерних задач при инициализации. Для изменения состояния после инициализации используйте методы close() и open(). |
| parent | number | string | Идентификатор родительской задачи. Задачи с несуществующими родителями не будут отображаться. Идентификатор корневой задачи задается через конфиг root_id. |
| progress | number | Значение прогресса выполнения задачи (от 0 до 1) |
| progressColor | string | Устанавливает цвет полосы прогресса задачи на временной шкале (применяется к background-color элемента gantt_task_progress) |
| readonly | boolean | Определяет, должна ли задача быть только для чтения. Имя свойства зависит от опции readonly_property |
| render | string | Управляет отображением подзадач. Возможные значения: "split" | "". Если указано "split", подзадачи отображаются в одной строке. При включенном свойстве open_split_tasks подзадачи отображаются в одной строке только если задача свернута. |
| resource | Array <string> | Массив ресурсов, назначенных задаче. Добавляется при импорте данных из MS Project или Primavera |
| rollup | boolean | Определяет, должна ли задача (type:"task") или ве ха (type:"milestone") отображаться на родительских проектах. |
| row_height | number | Задает высоту строки задачи |
| target | string | Идентификатор целевой задачи. Это свойство соответствует свойству $drop_target. Добавляется к объекту задачи только при включенном Data Processor, после обновления задачи и связи с сервером. |
| text | any | Название задачи. При необходимости можно использовать другое имя свойства. Это свойство используется в стандартных настройках Gantt. |
| textColor | string | Устанавливает цвет текста задачи на временной шкале (применяется к color элемента gantt_task_line) |
| type | string | Тип задачи. Доступные значения определяются в объекте types:
|
| unscheduled | boolean | Показывает, является ли задача незапланированной. По умолчанию незапланированные задачи не отображаются на временной шкале, а в гриде для дат начала и окончания выводятся пустые значения. |
Динамические свойства
Динамические свойства создаются на стороне клиента для отображения текущего состояния задачи или связи. Они не предназначены для сохранения в базе данных, и Gantt проигнорирует их, если они будут включены в ваш JSON или XML.
| Имя | Тип | Описание |
|---|---|---|
| [resource_property] | string | Array <any> | Это свойство может име ть любое имя. Хранит идентификатор ресурса, связанного с resourceGrid/Timeline/Histogram/Calendar. |
| $auto_end_date | Date | Вычисленная дата окончания для проектной задачи на основе ее подзадач. Добавляется и обновляется, когда "auto_scheduling" выключен. |
| $auto_start_date | Date | Вычисленная дата начала для проектной задачи на основе ее подзадач. Добавляется и обновляется, когда "auto_scheduling" выключен. |
| $calculate_duration | boolean | Системное свойство, используемое для внутренних вычислений. |
| $custom_data | object | Содержит пользовательские свойства задачи, определенные при importFromMSProject() и importFromPrimaveraP6() |
| $dataprocessor_class | string | Системное свойство, указывающее, была ли задача обновлена. Добавляется при включенном Data Processor. Если установлено значение "updated", текст задачи отображается жирным в гриде, хотя могут применяться свои CSS-стили. |
| $drop_target | string | Идентификатор целевой задачи при вертикальном перетаскивании. Это временное свойство добавляется во время перетаскивания задачи. |
| $effective_calendar | string | Идентификатор календаря (или календаря ресурса), назначенного задаче. Используется для внутренних вычислений. |
| $expanded_branch | boolean | Показывает, видна ли задача в зависимости от того, развернуты ли родительские ветки. Если хотя бы один родитель свернут, задача скрыта, кроме случаев split-задач (подзадач). |
| $has_child | boolean | Показывает, должен ли Gantt запрашивать загрузку подзадач первого уровня с сервера. Используется при включенном branch_loading. Имя свойства зависит от опции branch_loading_property. |
| $index | number | Глобальная вертикальная позиция задачи. Это значение обновляется при открытии или закрытии задач выше или ниже. Если родитель свернут, значение не отражает фактическое положение. |
| $level | number | Уровень вложенности задачи в иерархии (начиная с нуля) |
| $local_index | number | Вертикальная позиция задачи внутри родительской ветки. Это значение не обновляется при глобальных изменениях открытия/закрытия. Если родитель свернут, значение не отражает фактическое положение. |
| $new | boolean | Добавляется при создании новой задачи через createTask() или кнопку "+". Присутствует, пока открыт lightbox, и удаляется после сохранения. |
| $no_end | boolean | Обязательное системное свойство, добавляется, если end_date невозможно вычислить (указан start_date, но нет duration или end_date). В этом случае задачу нельзя перемещать или изменять размер. end_date зависит от дат окончания подзадач, start_date фиксирован. Авто-планирование отключено. Если также установлено $no_start, задача полностью зависит от дат подзадач или первой задачи. |
| $no_start | boolean | Обязательное системное свойство, добавляется, если start_date невозможно вычислить (указан end_date, но нет duration или start_date). start_date зависит от подзадач или первой задачи. end_date остается фиксированным, если только дата начала подзадач/первой задачи не превышает его. Авто-планирование отключено. Если также установлено $no_end, задача полностью зависит от дат подзадач или первой задачи. |
| $open | boolean | Системное свойство, отражающее, открыта ли задача в данный момент (true). Изменение этого свойства и перерисовка Gantt открывает или закрывает задачу. Альтернативно используйте open() или close(). |
| $raw | object | Содержит оригинальные имена свойств задачи, импортированные из MS Project или Primavera при экспорте. Эти данные появляются до преобразования в формат, ожидаемый Gantt. |
| $rendered_at | string | number | Идентификатор строки, в которой отображается rollup-элемент или split-задача. Это временное свойство появляется только во время отображения rollup/split задачи. |
| $rendered_parent | number | string | Идентификатор родителя, под которым отображается задача (не фактический родитель). Используется внутренне и для группировки задач. |
| $rendered_type | string | Временное свойство, указывающее тип отображаемой задачи. |
| $resourceAssignments | Array <any> | Массив идентификаторов ресурсов, назначенных задаче (временное). Наиболее точные данные хранятся в хранилище назначений ресурсов. |
| $rollup | Array <string | number> | Массив идентификаторов задач и вех, которые отображаются на этой задаче |
| $source | Array <string | number> | Обязательное - массив идентификаторов всех связей, исходящих из задачи |
| $split_subtask | boolean | Присутствует, если задача является подзадачей split-задачи (отображается в одной строке с другими подзадачами) |
| $target | Array <string | number> | Обязательное - массив идентификаторов связей, направленных на задачу |
| $transparent | boolean | Временное свойство, добавляемое при вертикальном перетаскивании, делает задачу полупрозрачной в гриде. |
| $virtual | boolean | Добавляется для задач, сгруппированных по определенному критерию. Задачи с $virtual: true удаляются при сбросе группировки. |
| $wbs | string | WBS-код задачи (временный). Добавляется после вызова getWBSCode(). Если код меняется из-за изменений родителя или позиции, вызовите getWBSCode() повторно для обновления. |
Пример
const data = {
tasks: [
{ id: 1, text: "Project #1", start_date: "01-04-2025", duration: 18 },
{ id: 2, text: "Task #1", start_date: "02-04-2025", duration: 8, parent: 1 },
{ id: 3, text: "Task #2", start_date: "11-04-2025", duration: 8, parent: 1 }
],
links: []
};