parse

Description

从客户端资源加载数据

parse: (data: string | DataToLoad1 | DataToLoad2, type?: string) => void

Parameters

• data - (必填) string | DataToLoad - 一个字符串或对象，表示 data
• type - (optional) string - 选项 ('json', 'xml') 数据类型。默认值 - 'json'

Example

gantt.parse({
    data:[
        {id:1, text:"Project #2", start_date:"01-04-2023", duration:18},
        {id:2, text:"Task #1",    start_date:"02-04-2023", duration:8,
            progress:0.6, parent:1},
        {id:3, text:"Task #2",    start_date:"11-04-2023", duration:8,
            progress:0.6, parent:1}
    ],
    links:[
        { id:1, source:1, target:2, type:1},
        { id:2, source:2, target:3, type:0}
    ]
});

Related samples

• Basic initialization

Details

Gantt 期望包含 an array with tasks 的数组被命名为 data 或 tasks，而 an array with links 的数组将被命名为 links。

以下是期望的属性列表：

• data - ([] | NewTask[]) - 包含任务数据的数组
• links? - (Link[]) - 包含链接数据的数组
• resources? - (NewResourceItem[]) - 包含资源数据的数组
• assignments? - (NewAssignmentItem[]) - 包含分配数据的数组
• collections? - (Сollections) - 包含自定义数据的数组的对象

gantt.parse({
    data: [
        { id: 1, start_date: "2025-09-23", duration: 42, 
            text: "House Construction" },
        { id: 2, start_date: "2025-12-02", duration: 60, 
            text: "House Construction" },
    ],
    "links": [
        { id: "1", source: "1", target: "2", type: "0" },
    ],
    "resources": [
        { id: 1, text: "Anna, Architect", unit: "hours/day", 
            default_value: 8, type: "work" },
    ],
    "assignments": [
      { task_id: "1", resource_id: "1", value: "8" },
      { task_id: "2", resource_id: "1", value: "8", 
            mode: "fixedDates", start_date: "2025-09-23", 
            end_date: "2025-09-25", duration: 4, delay: 2,  },
      { task_id: "2", resource_id: "1", value: "8", 
            start_date: new Date("2025-09-23 00:00:00"), 
            end_date: new Date("2025-09-26 00:00:00"), },
    ]
})

The data 或 tasks 数组期望的是与 Task 对象不同的 NewTask 对象。它也可以是字符串，或空对象。 它可以具有与 Task 对象 相同的属性，并且你可以在其中添加任意自定义属性。 区别在于某些以 $ 符号开头的 Task 对象属性会被忽略，且日期可以是字符串类型。 以下是类型描述：

• NewTask - (string | | object) - 将被添加到 Gantt 的任务对象。它可以具有以下属性：
  • id? - (string | number) - 可选，任务 ID，如未设置将自动生成
  • start_date? - (string | Date) - 可选，任务计划开始的日期
  • duration? - (number) - 可选，任务时长
  • end_date? - (string | Date) - 可选，任务计划完成的日期
  • text? - (string) - 可选，任务名称
  • open? - (boolean) - 可选，加载时是否展开以显示子任务
  • parent? - (string | number) - 可选，父任务的 ID
  • constraint_date? - (string | Date) - 可选，任务约束日期
  • [customProperty: string] - (any) - 你想要添加的任意其他属性

这不是可能的任务属性的完整列表。更多信息，请参考本文档中的内容（guides/task-properties.md）。

gantt.parse({
    data: [
        { id: 1, start_date: "2025-09-23", duration: 42, 
            text: "House Construction" },
    ]
})

---

links 数组应包含 Link对象。

gantt.parse({
    data: [],
    links: [
        { id: "1", source: "1", target: "2", type: "0" },
    ]
})

---

resources 数组期望包含 NewResourceItem 对象，可能包括:

• NewResourceItem - (object) - 添加到 Gantt 的资源条目，属性示例:
  • id? - (string | number) - 可选，资源 ID，缺失时自动生成。
  • parent? - (string | number) - 可选，父资源 ID。
  • text? - (string) - 可选，资源名称。
  • open? - (boolean) - 可选，加载时资源是否展开。
  • unit? - (string | number) - 可选，资源分配单位。
  • default_value? - (string | number) - 可选，lightbox 中显示的默认分配值。
  • [customProperty: string] - (any) - 其他附加属性。

gantt.parse({
    data: [],
    resources: [
        { id: 1, text: "Anna, Architect", unit: "hours/day", 
            default_value: 8, type: "work" },
    ]
})

---

assignments 数组期望包含 NewAssignmentItem 对象，属性示例如下:

• NewAssignmentItem - (object) - 添加到 Gantt 的分配条目，可能包括:
  • id? - (string | number) - 可选，分配 ID，缺失时自动生成。
  • task_id - (string | number) - 分配的任务 ID。
  • resource_id - (string | number) - 分配的资源 ID。
  • value - (number | string) - 可选，分配值。
  • mode? - (string) - 可选，计算模式:"default"|"fixedDates"|"fixedDuration"。
  • delay? - (number) - 可选，分配开始与任务开始的差异。
  • start_date? - (string | Date) - 可选，分配开始日期。
  • duration? - (number) - 可选，分配持续时间。
  • end_date? - (string | Date) - 可选，分配结束日期。
  • [customProperty: string] - (any) - 其他自定义属性。

gantt.parse({
    data: [],
    assignments: [
      { task_id: "1", resource_id: "1", value: "8" },
    ]
})

---

collections 对象用于加载自定义数据。其属性名可随意，值为包含集合项的数组:

• [collectionName: string] - ([] | СollectionItem[]) - 集合项数组。

每个 СollectionItem 是一个包含任意属性的对象:

gantt.parse({
    data: [
        { "id": "1", "text": "Task #1", "priority": 1, 
            "start_date": "02-04-2019", "duration": 1, },
        { "id": "2", "text": "Task #2", "priority": 2,  
            "start_date": "01-04-2019", "duration": 1, },
        { "id": "3", "text": "Task #3", "priority": 3,  
            "start_date": "02-04-2019", "duration": 1, },
        { "id": "4", "text": "Task #4", "priority": 1,  
            "start_date": "03-04-2019", "duration": 1, },
    ],
    links: [],
    collections: {
        task_priority: [
            { key: 1, label: "High" },
            { key: 2, label: "Normal" },
            { key: 3, label: "Low" }
        ]
    }
});

---

如果数据中不包含任务，仍需定义一个空的 tasks 数组:

gantt.parse({
    tasks:[],
    links:[
        { id:1, source:1, target:2, type:1},
        { id:2, source:2, target:3, type:0}
    ]
});

从 v8.0 版本开始，你还可以通过 parse() 方法同时加载资源和资源分配，以及任务和链接:

gantt.parse({
    tasks: [
        ...,
        {
            id: 5,
            text: "Interior office",
            type: "task",
            start_date: "03-04-2024 00:00",
            duration: 7,
            parent: "2",
            owner: [
                {
                    resource_id: "6",
                    value: 3,
                    start_date: "03-04-2024 00:00",
                    end_date: "05-04-2024 00:00",
                }
            ]
        },
        ...
    ],
    links: [],
    resources: [
        {id: 6, text: "John", unit: "hours/day" },
        {id: 7, text: "Mike", unit: "hours/day" },
        {id: 8, text: "Anna", unit: "hours/day" },
        {id: 9, text: "Bill", unit: "hours/day" },
        {id: 10, text: "Floe", unit: "hours/day" }
    ]
});

更多详情请参见这里。

Related API

• load

Related Guides

• 数据加载
• 支持的数据格式
• 支持的数据格式 (阅读如何加载带有 Collections 的 JSON)