在现代的项目管理中，时间是一种宝贵的资源，而甘特图则是一把解锁项目进度的魔法钥匙，想象一下，您可以在一个直观而动态的时间轴上，清晰地看到项目的每一个任务如何交织在一起，如何随着时间的推移展开，如何影响着项目的整体进度。这就是Dhtmlx Gantt带给我们的强大能力。
目录
初识Dhtmlx Gantt
Dhtmlx Gantt配置项
Dhtmlx Gantt基础操作
多任务实现
初识Dhtmlx Gantt
Dhtmlx Gantt介绍：主要是用来创建和管理甘特图的工具库，甘特图是一种项目管理图表，通过条形图展示任务的开始时间、持续时间和完成进度，同时显示任务之间的依赖关系。Dhtmlx Gantt提供了丰富的功能和可定制选项，开发者可以轻松构建出功能强大、直观清晰的甘特图，用于项目计划和进度管理，从而使得用户可以灵活地配置和显示项目的时间轴、任务列表、资源分配情况等信息。这里我们可以阅读一下Dhtmlx Gantt的官网了解详细信息：地址 ：
因为公司项目主要使用react技术栈，这里我们就拿该框架进行举例，参考文档：地址 ：
插件安装：这里我们选择安装稳定版本(博主以稳定版本讲解)的，终端执行如下命令即可：
npm i dhtmlx-gantt后面使用该插件的时候，直接导入包和对应的样式即可：
import { Gantt} from "dhtmlx-gantt";
import "dhtmlx-gantt/codebase/dhtmlxgantt.css";当然也可以安装试用版本，和稳定版本有点区别，这里大家可自行去官网翻阅，这里不再赘述：
npm install @dhx/trial-gantt如果您选择安装试用版，导入路径应如下所示：
import { Gantt} from "@dhx/trial-gantt";
import "@dhx/trial-gantt/codebase/dhtmlxgantt.css";这里我们仿造官网给出的案例，如下给出先给出完整的代码进行基础演示：
import { useEffect, useRef } from 'react';
import { gantt } from 'dhtmlx-gantt';
import 'dhtmlx-gantt/codebase/dhtmlxgantt.css';
import './index.less'const data = {// 任务数据data: [{id: 1,text: 'projectName',start_date: '01-04-2023',end_date: '05-12-2023',progress: 0.3,value: 20,},{id: 2,text: '任务1',start_date: '02-04-2023',end_date: '11-07-2023',progress: 0.6,value: 20,},{id: 3,text: '任务211',start_date: '02-04-2023',end_date: '23-07-2023',progress: 0,value: 20,}],// 任务连线数据links: [{ id: 1, source: 1, target: 2, type: '1' },{ id: 2, source: 2, target: 3, type: '0' }]
};// 左侧标题数据
const columns = [{ name: 'text', label: '项目名称', width: 100, align: "center" },{ name: 'start_date', label: '开始时间', width: 100, align: "center" },{ name: 'start_date', label: '开始时间', width: 100, align: "center" },{ name: 'value', label: '计划工期', width: 100, align: "center" },
];const GanttView = () => {// 获取gantrt容器实例const ganttRef = useRef<any>();// 初始化ganttconst initGantt = () => {// 基础配置gantt.clearAll() // 清空之前的配置gantt.i18n.setLocale('cn'); // 设置中文gantt.config.readonly = true; // 设置为只读，否则是可以移动甘特图和连线的gantt.init(ganttRef.current); // 初始化甘特图gantt.parse(data); // 渲染数据gantt.config.order_branch = "marker";// 表头样式设置gantt.config.scale_height = 60; // 设置表头高度gantt.config.sort = true; // 点击表头可排序gantt.config.columns = columns; // 设置左侧表头数据gantt.config.scales = [ // 设置表头右侧刻度// 设置时间刻度相关属性// 显示月日用这个// { unit: 'month', step: 1, format: '%Y-%m' },// { unit: 'day', step: 1, format: '%Y-%m-%d' }// 显示年月用这个{ unit: 'year', step: 1, format: '%Y' },{ unit: 'month', step: 1, format: '%M' }];// 表内容样式设置gantt.config.row_height = 40; // 设置内容行高gantt.config.bar_height = 40; // 设置进度条高度gantt.templates.task_text = function (start, end, task) { // 自定义内容进度上的文本return '内容'};// 表内容背景颜色gantt.templates.task_row_class = function (start, end, task) {return "gantt_task111";};// tooltips样式设置gantt.plugins({tooltip: true,});gantt.config.tooltip_offset_x = 10; gantt.config.tooltip_offset_y = 30;gantt.templates.tooltip_text = function (start, end, task) {return (task.text +'<br/><span>开始:</span> ' +gantt.templates.tooltip_date_format(start) +'<br/><span>结束:</span> ' +gantt.templates.tooltip_date_format(end) +'<br/><span>进度:</span> ' +// Math.round(task.progress * 100) +'%');};// 设置连线事件gantt.config.show_links = true;}useEffect(() => {initGantt();}, []);return (<div className="ganttView"><div className='ganttContainer' ref={ganttRef}></div></div>)
};
export default GanttView;最终得到的效果如下所示：
Dhtmlx Gantt配置项
接下来开始对配置项进行一个简单的介绍，如下所示：
数据配置项：甘特图中表头标题和表内容中的数据
任务数据data：在任务数据中里面对象的配置项有各种属性值，接下来就常用的属性值介绍：
/*
gantt.parse 方法中的 data 参数是一个包含任务信息的数组。每个任务都包含多个字段，下面是一些常用的字段及其作用：
id: 任务的唯一标识符。
text: 任务的名称。
start_date: 任务的开始日期，可以是一个字符串或者一个 Date 对象。
end_date: 任务的结束日期，可以是一个字符串或者一个 Date 对象。
duration: 任务的持续时间，以天为单位。如果 end_date 和 duration 都提供了，duration 会被忽略。
progress: 任务的进度，以百分比表示。
parent: 父任务的 id，如果当前任务是顶级任务，则该字段为 0。
open: 是否展开当前任务的子任务。如果不提供，默认为 true。
state: 用于设置任务的状态。状态可以是任何自定义值，例如 "in progress"、"completed"、"cancelled" 等等。在 Gantt 图中，任务的状态可以通过任务条颜色、边框、文本样式等 visulization 属性进行自定义渲染，以便用户更直观地了解任务状态的变化。可以在 Gantt 文档中的 Visualization 属性部分了解有关自定义任务状态可视化的更多信息。
除了上面列出的常用字段之外，还有很多其他可选字段，例如 color、link、type 等，可以根据实际需求来添加。
*/const data = [{ id: 1, text: "Task 1", start_date: "2023-03-15", duration: 3 },{ id: 2, text: "Task 2", start_date: "2023-03-18", duration: 2, parent: 1 },
];
links数组：链接数据数组，包含每个链接的信息，例如 id、source、target 等等。
// 任务连线数据
links: [{ id: 1, source: 1, target: 2, type: '1' },{ id: 2, source: 2, target: 3, type: '0' }
]当然还有一些其他常见的配置项这里就不再一一赘述了，如下：
key: 任务数据对象中唯一标识每个任务的属性名称，默认为 "id"。
parent: 任务数据对象中用于标识父任务的属性名称，默认为 "parent".
open_tree_initially: 布尔值，如果设置为 true，则所有任务默认展开。
preserve_links: 布尔值，如果设置为 true，则链接信息中的任务不存在时也会保留链接。
preserve_tasks: 布尔值，如果设置为 true，则链接信息中的任务不存在时也会保留任务。基础配置项：初始化甘特图时要进行的基础配置
gantt.clearAll() // 清空之前的配置
gantt.i18n.setLocale('cn'); // 设置中文
gantt.config.readonly = true; // 设置为只读，否则是可以移动甘特图和连线的
gantt.init(ganttRef.current); // 初始化甘特图
gantt.parse(data); // 渲染数据表头样式配置项：对表头标题进行样式配置
// 甘特图样式设置
gantt.config.scale_height = 60; // 设置表头高度
// 设置头部左侧表头标题背景颜色
gantt.templates.grid_header_class = function (date, scale) {return "gantt_grid_head111";
};
// 设置左侧标题表内容背景颜色
gantt.templates.grid_row_class = function (date, scale) {return "gantt_scale_cell111";
};
// 设置头部右侧上标题内容背景颜色
gantt.templates.scale_cell_class = function (scale) {return "gantt_grid_head111";
};
// 设置头部右侧下标题内容背景颜色
gantt.templates.scale_row_class = function (scale) {return "gantt_grid_head111";
};
// 设置表主内容背景颜色
gantt.templates.task_row_class = function (start, end, task) {return "gantt_task111";
};
gantt.config.sort = true; // 设置点击左侧表头可排序
gantt.config.columns = columns; // 设置左侧表头数据
gantt.config.scales = [ // 设置表头右侧刻度// 设置时间刻度相关属性// 显示月日用这个// { unit: 'month', step: 1, format: '%Y-%m' },// { unit: 'day', step: 1, format: '%Y-%m-%d' }// 显示年月用这个{ unit: 'year', step: 1, format: '%Y' },{ unit: 'month', step: 1, format: '%M' }
];表内容样式配置项：对表内容进行样式配置
// 表内容样式设置
gantt.config.row_height = 40; // 设置内容行高
gantt.config.bar_height = 40; // 设置进度条高度
gantt.templates.task_text = function (start, end, task) { // 自定义内容进度上的文本return '内容'
};悬浮框样式配置项：对表悬浮框进行样式配置
// tooltips样式设置
gantt.plugins({tooltip: true,// quick_info: true, // 快速信息框// multiselect: true,// 激活多任务选择
});
gantt.config.tooltip_offset_x = 10; // 设置tooltips水平偏移量
gantt.config.tooltip_offset_y = 30; // 设置tooltips垂直偏移量
gantt.templates.tooltip_text = function (start, end, task) {return (task.text +'<br/><span>开始:</span> ' +gantt.templates.tooltip_date_format(start) +'<br/><span>结束:</span> ' +gantt.templates.tooltip_date_format(end) +'<br/><span>进度:</span> ' +// Math.round(task.progress * 100) +'%');
};Dhtmlx Gantt基础操作
接下来复现一下一个甘特图的效果，这里我们给出书写甘特图的流程书写：
初始化甘特图：首先我们创建甘特图的容器，然后进行一些初始配置：
import { useEffect, useRef } from 'react';
import { gantt } from 'dhtmlx-gantt';
import 'dhtmlx-gantt/codebase/dhtmlxgantt.css';const GanttView = () => {// 获取gantrt容器实例const ganttRef = useRef<any>();// 初始化ganttconst initGantt = () => {gantt.clearAll() // 清空之前的配置gantt.i18n.setLocale('cn'); // 设置中文gantt.config.readonly = true; // 设置为只读，否则是可以移动甘特图和连线的gantt.init(ganttRef.current); // 初始化甘特图gantt.parse(data); // 渲染数据}useEffect(() => {initGantt();}, []);return (<div className="ganttView"><div className='ganttContainer' ref={ganttRef}></div></div>)
};
export default GanttView;给出表头数据：接下来开始创建表头数据：
const data = {data: [ // 任务数据{ id: 1, text: '任务1', start_date: '01-04-2023', end_date: '05-12-2023', progress: 0.3 },{ id: 2, text: '任务1', start_date: '02-04-2023', end_date: '11-07-2023', progress: 0.6 },{ id: 3, text: '任务3', start_date: '12-07-2023', end_date: '09-09-2023', progress: 0 }],links: [ // 任务连线数据{ id: 1, source: 1, target: 2, type: '1' },{ id: 2, source: 2, target: 3, type: '0' }]
};const columns = [ // 左侧标题数据{ name: 'text', label: '项目名称', width: 100, align: "center" },{ name: 'start_date', label: '开始时间', width: 100, align: "center" },{ name: 'end_date', label: '结束时间', width: 100, align: "center" },
];样式配置：接下来给甘特图设置相关样式：
const initGantt = () => {// 基础配置gantt.clearAll() // 清空之前的配置gantt.i18n.setLocale('cn'); // 设置中文gantt.config.readonly = false; // 设置为只读，否则是可以移动甘特图和连线的gantt.init(ganttRef.current); // 初始化甘特图gantt.parse(data); // 渲染数据// 甘特图样式设置gantt.config.scale_height = 60; // 设置表头高度// 设置头部左侧表头标题背景颜色gantt.templates.grid_header_class = function (date, scale) {return "gantt_grid_head111";};// 设置左侧标题表内容背景颜色gantt.templates.grid_row_class = function (date, scale) {return "gantt_scale_cell111";};// 设置头部右侧上标题内容背景颜色gantt.templates.scale_cell_class = function (scale) {return "gantt_grid_head111";};// 设置头部右侧下标题内容背景颜色gantt.templates.scale_row_class = function (scale) {return "gantt_grid_head111";};// 设置表主内容背景颜色gantt.templates.task_row_class = function (start, end, task) {return "gantt_task111";};gantt.config.sort = true; // 设置点击左侧表头可排序gantt.config.columns = columns; // 设置左侧表头数据gantt.config.scales = [ // 设置表头右侧刻度// 设置时间刻度相关属性// 显示月日用这个// { unit: 'month', step: 1, format: '%Y-%m' },// { unit: 'day', step: 1, format: '%Y-%m-%d' }// 显示年月用这个{ unit: 'year', step: 1, format: '%Y' },{ unit: 'month', step: 1, format: '%M' }];// 表内容样式设置gantt.config.row_height = 40; // 设置内容行高gantt.config.bar_height = 40; // 设置进度条高度gantt.templates.task_text = function (start, end, task) { // 自定义内容进度上的文本return '内容'};// tooltips样式设置gantt.plugins({ tooltip: true });gantt.config.tooltip_offset_x = 10; // 设置tooltips水平偏移量gantt.config.tooltip_offset_y = 30; // 设置tooltips垂直偏移量gantt.templates.tooltip_text = function (start, end, task: any) {return (task.text +'<br/><span>开始:</span> ' +gantt.templates.tooltip_date_format(start) +'<br/><span>结束:</span> ' +gantt.templates.tooltip_date_format(end) +'<br/><span>进度:</span> ' +Math.round(task.progress * 100) +'%');};// 设置连线事件gantt.config.show_links = true;gantt.config.drag_project = true;
}最终呈现的效果如下所示：
多任务实现
如果想在同一个x轴显示多条任务，需要配置分组，每组的子任务通过parent属性进行联系主任务，这里通过如下代码进行演示：
const data = {// 任务数据data: [//第一组 整条数据需要带上render属性 里面多段的数据parent执行整条的id{ id: '1', name: '张三', render: 'split', text: '' },{ id: '1-1', parent: 1, text: '派工', color: '#008c8c', start_date: '15-06-2024 08:30', end_date: '15-06-2024: 10:30' },{ id: '1-2', parent: 1, text: '休息', color: 'blue', start_date: '16-06-2024: 13:00', end_date: '16-06-2024:23:00' },// 第二组{ id: '2', name: '李四', render: 'split', text: '' },{ id: '2-1', parent: 2, text: '派工', color: '#008c8c', start_date: '15-06-2024 18:30', end_date: '15-06-2024: 22:30' },{ id: '2-2', parent: 2, text: '休息', color: 'blue', start_date: '16-06-2024: 13:00', end_date: '16-06-2024:23:00' },// 第三组{ id: '3', name: '王五', render: 'split', text: '' },{ id: '3-1', parent: 3, text: '派工', color: '#008c8c', start_date: '15-06-2024 8:30', end_date: '15-06-2024: 22:30' },{ id: '3-2', parent: 3, text: '休息', color: 'blue', start_date: '16-06-2024: 13:00', end_date: '16-06-2024:23:00' },{ id: '3-3', parent: 3, text: '休息', color: 'blue', start_date: '16-06-2024: 13:00', end_date: '17-06-2024:3:00' },{ id: '3-4', parent: 3, text: '派工', color: '#008c8c', start_date: '17-06-2024:2:00', end_date: '17-06-2024: 8:00' }],
};如果想在同一时段实现多任务，当前组件库好像实现不了，至少博主查阅了一下午的文档没找到，然后这里我通过css样式来进行控制其高度，然后通过判断任务之间的时段是否重叠进行动态添加类名，具体代码如下：
import { useEffect, useRef } from 'react';
import { gantt } from 'dhtmlx-gantt';
import 'dhtmlx-gantt/codebase/dhtmlxgantt.css';
import './index.less'const data = {// 任务数据data: [//第一组 整条数据需要带上render属性 里面多段的数据parent执行整条的id{ id: '1', name: '张三', render: 'split', text: '' },{ id: '1-1', parent: 1, text: '派工', color: '#008c8c', start_date: '15-06-2024 08:30', end_date: '15-06-2024: 10:30' },{ id: '1-2', parent: 1, text: '休息', color: 'blue', start_date: '16-06-2024: 13:00', end_date: '16-06-2024:23:00' },// 第二组{ id: '2', name: '李四', render: 'split', text: '' },{ id: '2-1', parent: 2, text: '派工', color: '#008c8c', start_date: '15-06-2024 18:30', end_date: '15-06-2024: 22:30' },{ id: '2-2', parent: 2, text: '休息', color: 'blue', start_date: '16-06-2024: 13:00', end_date: '16-06-2024:23:00' },// 第三组{ id: '3', name: '王五', render: 'split', text: '' },{ id: '3-1', parent: 3, text: '派工', color: '#008c8c', start_date: '15-06-2024 8:30', end_date: '15-06-2024: 22:30' },{ id: '3-2', parent: 3, text: '休息', color: 'blue', start_date: '16-06-2024: 13:00', end_date: '16-06-2024:23:00' },{ id: '3-3', parent: 3, text: '休息', color: 'blue', start_date: '16-06-2024: 13:00', end_date: '17-06-2024:3:00' },{ id: '3-4', parent: 3, text: '派工', color: '#008c8c', start_date: '17-06-2024:2:00', end_date: '17-06-2024: 8:00' },// { id: '3-4', parent: 3, text: '派工', color: '#008c8c', start_date: '16-06-2024:12:00', end_date: '17-06-2024: 8:00' },],
};// 左侧标题数据
const columns = [{ name: 'id', label: '序号', resize: true, max_width: 60, align: "center" },{ name: 'name', label: '姓名', resize: true, max_width: 60, align: "center" },
];const GanttView = () => {// 获取gantrt容器实例const ganttRef = useRef<any>();// 初始化ganttconst initGantt = () => {gantt.clearAll() // 清空之前的配置gantt.i18n.setLocale('cn'); // 设置中文gantt.config.readonly = true; // 设置为只读，否则是可以移动甘特图和连线的gantt.config.start_date = new Date(2024, 5, 15); // 设置甘特图开始日期 gantt.config.end_date = new Date(2024, 5, 18); // 设置甘特图结束日期 gantt.init(ganttRef.current); // 初始化甘特图gantt.parse(data); // 渲染数据gantt.config.columns = columns; // 设置左侧表头数据gantt.config.scale_height = 60; // 设置表头高度gantt.config.min_column_width = 10; // 设置列最小宽度// 设置头部右侧上标题内容背景颜色gantt.templates.scale_cell_class = function (scale) {return "gantt_grid_head_top";};gantt.config.scales = [ // 设置甘特图时间轴{ unit: 'day', step: 1, format: '%Y/%m/%d' },{ unit: 'hour', step: 1, format: function(date) { return date.getHours(); // 显示从0到23的小时范围 }} ];// 表内容样式设置gantt.templates.task_row_class = function (start, end, task) { // 设置表主内容背景颜色return "gantt_task_main_content";};gantt.config.row_height = 40; // 设置内容行高gantt.config.bar_height = 40; // 设置进度条高度gantt.templates.task_text = function (start, end, task) {return `<div style="color: #fff; font-size: 12px;">${task?.text}</div>`;};let count = 0gantt.templates.task_class = function(start, end, task) { if (count < 1) {// 创建一个空对象来存储结果let tasksByParent: { [key: string]: any[] } = {}; // 创建空对象来存储任务按父任务分组的结果// 遍历任务数组data.data.forEach((task) => {if (task.parent) {// 检查是否已经存在该parent对应的数组，如果不存在则创建一个空数组if (!tasksByParent[task.parent]) {tasksByParent[task.parent] = [];}// 将当前任务对象添加到对应parent值的数组中tasksByParent[task.parent].push(task);}});// 检查时间重叠并添加类名Object.keys(tasksByParent).forEach(parentId => {let tasks = tasksByParent[parentId];for (let i = 0; i < tasks.length; i++) {for (let j = i + 1; j < tasks.length; j++) {if (tasksOverlap(tasks[i], tasks[j])) {tasks[i].className = (i % 2 === 0) ? 'custom-height-top2' : 'custom-height-bottom2';tasks[j].className = (j % 2 === 0) ? 'custom-height-top2' : 'custom-height-bottom2';}}}for (let i = 0; i < tasks.length; i++) {for (let j = i + 1; j < tasks.length; j++) {for (let k = j + 1; k < tasks.length; k++) {if (tasksOverlap(tasks[i], tasks[j]) && tasksOverlap(tasks[i], tasks[k]) && tasksOverlap(tasks[j], tasks[k])) {// 为每个重叠任务分配不同的类名tasks[i].className = 'custom-height-top3';tasks[j].className = 'custom-height-bottom3';tasks[k].className = 'custom-height-center3';}}}}});console.log(tasksByParent);count++;}return task.className || ""; // 返回任务的类名，如果没有类名则返回空字符串}; // 检查两个任务时间段是否有重叠function tasksOverlap(task1: any, task2: any) {return (task1.start_date < task2.end_date && task2.start_date < task1.end_date);}// tooltips样式设置gantt.plugins({ tooltip: true });gantt.config.tooltip_offset_x = 10; // 设置tooltips水平偏移量gantt.config.tooltip_offset_y = 30; // 设置tooltips垂直偏移量gantt.templates.tooltip_text = function (start: Date, end: Date, task: any): string {if (task.text) {return (`<div class="gantt-tooltip"><div class="gantt-tooltip-time"><div class="time-word">当前时间：</div><div class="time-value"><div class="time-value-content"><span>开始时间：</span>${start.toLocaleString()}</div><div class="time-value-content"><span>结束时间：</span>${end.toLocaleString()}</div></div></div><div class="gantt-tooltip-task"><div class="task-word">当前任务：</div><div class="task-value">${task.text}</div></div></div>`);}return "";};}useEffect(() => {initGantt();}, []);return (<div className="ganttView"><div className='ganttContainer' ref={ganttRef} style={{ width: '100%' }}></div></div>)
};
export default GanttView;上述代码我通过for循环来判断，识别当前是双任务还是三任务的时间进行了重叠，这里给出具体的css样式：
.ganttView {width: 100%;height: 250px;.ganttContainer {width: 100vw;overflow: hidden;height: 100%;// 设置左侧头部数据.gantt_grid_scale {background-color: #dce8ee;.gantt_grid_head_cell {font-size: 14px;font-weight: bold;color: #000;}}// 设置右侧头部数据.gantt_task_scale {background-color: #dce8ee;.gantt_grid_head_top {font-size: 14px !important;font-weight: bold;color: #000;}.gantt_scale_cell {font-size: 10px;font-weight: bold;color: #000;}}.gantt_task_main_content {background-color: #57ce7d;}// 去除表格单元格的竖线 .gantt_task_cell, .gantt_task_cell.gantt_cell { border-right: none !important;} // 保留左侧标题单元格的竖线 .gantt_grid_head_cell, .gantt_grid_data .gantt_cell { border-right: 1px solid #dcdcdc !important; } /* 去除左侧标题和右侧表格内容的激活状态样式 */ .gantt_grid_data, .gantt_row.gantt_selected {background-color: transparent !important;}// 去除左侧标题内容的悬停效果.gantt_row:hover {background: none !important; // 去除背景色 }.gantt_row:active {background: none !important; // 去除背景色 }.custom-height-top2 {height: 20px !important; /* 设置特定任务条的高度 */ line-height: 20px !important; /* 调整行高以垂直居中文本 */ }.custom-height-bottom2 {height: 20px !important; /* 设置特定任务条的高度 */ line-height: 20px !important; /* 调整行高以垂直居中文本 */ margin-top: 20px;}.custom-height-top3 {height: 13.3px !important; /* 设置特定任务条的高度 */ line-height: 13.3px !important; /* 调整行高以垂直居中文本 */ }.custom-height-center3 {height: 13.3px !important; /* 设置特定任务条的高度 */ line-height: 13.3px !important; /* 调整行高以垂直居中文本 */ margin-top: 13.3px;}.custom-height-bottom3 {margin-top: 26.6px;height: 13.3px !important; /* 设置特定任务条的高度 */ line-height: 13.3px !important; /* 调整行高以垂直居中文本 */ }}
}// tooltips样式
.gantt_tooltip {background-color: #ccc;.gantt-tooltip-time {display: flex;flex-direction: column;gap: 4px;margin-bottom: 4px;.time-word {color: #000;font-size: 12px;font-weight: bold;}.time-value {display: flex;flex-direction: column;gap: 2px;span {font-weight: bold;}}}.gantt-tooltip-task {display: flex;align-items: center;.task-word {color: #000;font-size: 12px;font-weight: bold;}.task-value {color: red;}}
}当然还有单个任务的展示：
import { useEffect, useRef } from 'react';
import { gantt } from 'dhtmlx-gantt';
import 'dhtmlx-gantt/codebase/dhtmlxgantt.css';
import './index.less'const data = {// 任务数据data: [//第一组 整条数据需要带上render属性 里面多段的数据parent执行整条的id{ id: '1', name: '张三', render: 'split', text: '' },{ id: '1-1', parent: 1, text: '工', color: 'blue', start_date: '14-06-2024', duration: 1 },{ id: '1-2', parent: 1, text: '工', color: 'blue', start_date: '15-06-2024', duration: 1 },{ id: '1-3', parent: 1, text: '工', color: 'blue', start_date: '16-06-2024', duration: 1 },{ id: '1-4', parent: 1, text: '工', color: 'blue', start_date: '17-06-2024', duration: 1 },{ id: '1-5', parent: 1, text: '工', color: 'blue', start_date: '18-06-2024', duration: 1 },{ id: '1-6', parent: 1, text: '工', color: 'blue', start_date: '19-06-2024', duration: 1 },{ id: '1-7', parent: 1, text: '年', color: 'red', start_date: '20-06-2024', duration: 1 },{ id: '1-8', parent: 1, text: '闲', color: 'green', start_date: '21-06-2024', duration: 1 },{ id: '1-9', parent: 1, text: '工', color: 'blue', start_date: '22-06-2024', duration: 1 },{ id: '1-10', parent: 1, text: '工', color: 'blue', start_date: '23-06-2024', duration: 1 },{ id: '1-11', parent: 1, text: '工', color: 'blue', start_date: '24-06-2024', duration: 1 },{ id: '1-12', parent: 1, text: '工', color: 'blue', start_date: '25-06-2024', duration: 1 },{ id: '1-13', parent: 1, text: '工', color: 'blue', start_date: '26-06-2024', duration: 1 },{ id: '1-14', parent: 1, text: '工', color: 'blue', start_date: '27-06-2024', duration: 1 },{ id: '1-15', parent: 1, text: '工', color: 'blue', start_date: '28-06-2024', duration: 1 },{ id: '1-16', parent: 1, text: '工', color: 'blue', start_date: '29-06-2024', duration: 1 },{ id: '1-17', parent: 1, text: '闲', color: 'green', start_date: '30-06-2024', duration: 1 },{ id: '1-18', parent: 1, text: '闲', color: 'green', start_date: '1-07-2024', duration: 1 },{ id: '1-19', parent: 1, text: '工', color: 'blue', start_date: '2-07-2024', duration: 1 },{ id: '1-20', parent: 1, text: '工', color: 'blue', start_date: '3-07-2024', duration: 1 },{ id: '1-21', parent: 1, text: '工', color: 'blue', start_date: '4-07-2024', duration: 1 },{ id: '1-22', parent: 1, text: '工', color: 'blue', start_date: '5-07-2024', duration: 1 },{ id: '1-23', parent: 1, text: '工', color: 'blue', start_date: '6-07-2024', duration: 1 },{ id: '1-24', parent: 1, text: '工', color: 'blue', start_date: '7-07-2024', duration: 1 },{ id: '1-25', parent: 1, text: '工', color: 'blue', start_date: '8-07-2024', duration: 1 },{ id: '1-26', parent: 1, text: '工', color: 'blue', start_date: '9-07-2024', duration: 1 },{ id: '1-27', parent: 1, text: '工', color: 'blue', start_date: '10-07-2024', duration: 1 },{ id: '1-28', parent: 1, text: '工', color: 'blue', start_date: '11-07-2024', duration: 1 },{ id: '1-29', parent: 1, text: '工', color: 'blue', start_date: '12-07-2024', duration: 1 },{ id: '1-30', parent: 1, text: '工', color: 'red', start_date: '13-07-2024', duration: 1 },// 第二组{ id: '2', name: '李四', render: 'split', text: '' },{ id: '2-1', parent: 2, text: '工', color: 'blue', start_date: '14-06-2024', duration: 1 },{ id: '2-2', parent: 2, text: '工', color: 'blue', start_date: '15-06-2024', duration: 1 },{ id: '2-3', parent: 2, text: '工', color: 'blue', start_date: '16-06-2024', duration: 1 },{ id: '2-4', parent: 2, text: '工', color: 'blue', start_date: '17-06-2024', duration: 1 },{ id: '2-5', parent: 2, text: '工', color: 'blue', start_date: '18-06-2024', duration: 1 },{ id: '2-6', parent: 2, text: '工', color: 'blue', start_date: '19-06-2024', duration: 1 },{ id: '2-7', parent: 2, text: '工', color: 'blue', start_date: '20-06-2024', duration: 1 },{ id: '2-8', parent: 2, text: '工', color: 'blue', start_date: '21-06-2024', duration: 1 },{ id: '2-9', parent: 2, text: '工', color: 'blue', start_date: '22-06-2024', duration: 1 },{ id: '2-10', parent: 2, text: '工', color: 'blue', start_date: '23-06-2024', duration: 1 },{ id: '2-11', parent: 2, text: '工', color: 'blue', start_date: '24-06-2024', duration: 1 },{ id: '2-12', parent: 2, text: '工', color: 'blue', start_date: '25-06-2024', duration: 1 },{ id: '2-13', parent: 2, text: '工', color: 'blue', start_date: '26-06-2024', duration: 1 },{ id: '2-14', parent: 2, text: '工', color: 'blue', start_date: '27-06-2024', duration: 1 },{ id: '2-15', parent: 2, text: '工', color: 'blue', start_date: '28-06-2024', duration: 1 },{ id: '2-16', parent: 2, text: '工', color: 'blue', start_date: '29-06-2024', duration: 1 },{ id: '2-17', parent: 2, text: '工', color: 'blue', start_date: '30-06-2024', duration: 1 },{ id: '2-18', parent: 2, text: '工', color: 'blue', start_date: '01-07-2024', duration: 1 },{ id: '2-19', parent: 2, text: '工', color: 'blue', start_date: '02-07-2024', duration: 1 },{ id: '2-20', parent: 2, text: '工', color: 'blue', start_date: '03-07-2024', duration: 1 },{ id: '2-21', parent: 2, text: '工', color: 'blue', start_date: '04-07-2024', duration: 1 },{ id: '2-22', parent: 2, text: '工', color: 'blue', start_date: '05-07-2024', duration: 1 },{ id: '2-23', parent: 2, text: '工', color: 'blue', start_date: '06-07-2024', duration: 1 },{ id: '2-24', parent: 2, text: '工', color: 'blue', start_date: '07-07-2024', duration: 1 },{ id: '2-25', parent: 2, text: '工', color: 'blue', start_date: '08-07-2024', duration: 1 },{ id: '2-26', parent: 2, text: '工', color: 'blue', start_date: '09-07-2024', duration: 1 },{ id: '2-27', parent: 2, text: '闲', color: 'green', start_date: '10-07-2024', duration: 1 },{ id: '2-28', parent: 2, text: '工', color: 'blue', start_date: '11-07-2024', duration: 1 },{ id: '2-29', parent: 2, text: '工', color: 'blue', start_date: '12-07-2024', duration: 1 },{ id: '2-30', parent: 2, text: '工', color: 'blue', start_date: '13-07-2024', duration: 1 }, // 第三组{ id: '3', name: '王五1', render: 'split', text: '' },{ id: '3-1', parent: 3, text: '工', color: 'blue', start_date: '14-06-2024', duration: 1 },{ id: '3-2', parent: 3, text: '工', color: 'blue', start_date: '15-06-2024', duration: 1 },{ id: '3-3', parent: 3, text: '工', color: 'blue', start_date: '16-06-2024', duration: 1 },{ id: '3-4', parent: 3, text: '工', color: 'blue', start_date: '17-06-2024', duration: 1 },{ id: '3-5', parent: 3, text: '工', color: 'blue', start_date: '18-06-2024', duration: 1 },{ id: '3-6', parent: 3, text: '工', color: 'blue', start_date: '19-06-2024', duration: 1 },{ id: '3-7', parent: 3, text: '工', color: 'blue', start_date: '20-06-2024', duration: 1 },{ id: '3-8', parent: 3, text: '工', color: 'blue', start_date: '21-06-2024', duration: 1 },{ id: '3-9', parent: 3, text: '工', color: 'blue', start_date: '22-06-2024', duration: 1 },{ id: '3-10', parent: 3, text: '工', color: 'blue', start_date: '23-06-2024', duration: 1 },{ id: '3-11', parent: 3, text: '工', color: 'blue', start_date: '24-06-2024', duration: 1 },{ id: '3-12', parent: 3, text: '工', color: 'blue', start_date: '25-06-2024', duration: 1 },{ id: '3-13', parent: 3, text: '工', color: 'blue', start_date: '26-06-2024', duration: 1 },{ id: '3-14', parent: 3, text: '工', color: 'blue', start_date: '27-06-2024', duration: 1 },{ id: '3-15', parent: 3, text: '工', color: 'blue', start_date: '28-06-2024', duration: 1 },{ id: '3-16', parent: 3, text: '工', color: 'blue', start_date: '29-06-2024', duration: 1 },{ id: '3-17', parent: 3, text: '工', color: 'blue', start_date: '30-06-2024', duration: 1 },{ id: '3-18', parent: 3, text: '工', color: 'blue', start_date: '01-07-2024', duration: 1 },{ id: '3-19', parent: 3, text: '工', color: 'blue', start_date: '02-07-2024', duration: 1 },{ id: '3-20', parent: 3, text: '工', color: 'blue', start_date: '03-07-2024', duration: 1 }, { id: '3-21', parent: 3, text: '工', color: 'blue', start_date: '04-07-2024', duration: 1 }, { id: '3-22', parent: 3, text: '工', color: 'blue', start_date: '05-07-2024', duration: 1 },{ id: '3-23', parent: 3, text: '工', color: 'blue', start_date: '06-07-2024', duration: 1 },{ id: '3-24', parent: 3, text: '工', color: 'blue', start_date: '07-07-2024', duration: 1 }, { id: '3-25', parent: 3, text: '工', color: 'blue', start_date: '08-07-2024', duration: 1 },{ id: '3-26', parent: 3, text: '工', color: 'blue', start_date: '09-07-2024', duration: 1 },{ id: '3-27', parent: 3, text: '工', color: 'blue', start_date: '10-07-2024', duration: 1 },{ id: '3-28', parent: 3, text: '工', color: 'blue', start_date: '11-07-2024', duration: 1 },{ id: '3-29', parent: 3, text: '工', color: 'blue', start_date: '12-07-2024', duration: 1 },{ id: '3-30', parent: 3, text: '工', color: 'blue', start_date: '13-07-2024', duration: 1 },],
};// 左侧标题数据
const columns = [{ name: 'id', label: '序号', resize: true, max_width: 60, align: "center" },{ name: 'name', label: '姓名', resize: true, max_width: 60, align: "center" },
];const GanttView1 = () => {// 获取gantrt容器实例const ganttRef = useRef<any>();// 初始化ganttconst initGantt = () => {gantt.clearAll() // 清空之前的配置gantt.i18n.setLocale('cn'); // 设置中文gantt.config.readonly = true; // 设置为只读，否则是可以移动甘特图和连线的gantt.config.start_date = new Date(2024, 5, 14); // 设置甘特图开始日期 gantt.config.end_date = new Date(2024, 6, 14); // 设置甘特图结束日期 gantt.init(ganttRef.current); // 初始化甘特图gantt.parse(data); // 渲染数据gantt.config.columns = columns; // 设置左侧表头数据gantt.config.scale_height = 60; // 设置表头高度gantt.config.min_column_width = 10; // 设置列最小宽度// 设置头部右侧上标题内容背景颜色gantt.templates.scale_cell_class = function (scale) {return "gantt_grid_head_top";};gantt.config.scales = [{ unit: 'month', step: 1, format: function(date) {var formattedMonth = gantt.date.date_to_str('%m')(date); // 获取月份的两位数字表示formattedMonth = formattedMonth.replace(/^0+/, ''); // 去除月份前面的零return formattedMonth + '月'; // 返回格式化后的月份字符串}},{ unit: 'day', step: 1, format: function(date) {var formattedDay = gantt.date.date_to_str('%d')(date); // 获取天的两位数字表示 formattedDay = formattedDay.replace(/^0+/, ''); // 去除天数前面的零 return formattedDay; // 返回格式化后的天数字符串 }}];// 表内容样式设置gantt.templates.task_row_class = function (start, end, task) { // 设置表主内容背景颜色return "gantt_task_main_content";};gantt.config.row_height = 40; // 设置内容行高gantt.config.bar_height = 40; // 设置进度条高度gantt.templates.task_text = function (start, end, task) {return `<div style="color: #fff; font-size: 14px;">${task?.text}</div>`;};// tooltips样式设置gantt.plugins({ tooltip: true });gantt.config.tooltip_offset_x = 10; // 设置tooltips水平偏移量gantt.config.tooltip_offset_y = 30; // 设置tooltips垂直偏移量gantt.templates.tooltip_text = function (start: Date, end: Date, task: any): string {if (task.text) {return (`<div class="gantt-tooltip"><div class="gantt-tooltip-time-space"><div class="time-word">当前时间：</div><div class="time-value">${start.getMonth() + 1}月${start.getDate()}日</div></div><div class="gantt-tooltip-task"><div class="task-word">当前状态：</div><div class="task-value">${task.text}</div></div></div>`);}return "";};}useEffect(() => {initGantt();}, []);return (<div className="ganttView2"><div className='ganttContainer' ref={ganttRef} style={{ width: '100%' }}></div></div>)
};
export default GanttView1;CSS样式如下：
.ganttView2 {width: 100%;height: 250px;.ganttContainer {width: 100vw;overflow: hidden;height: 100%;// 设置左侧头部数据.gantt_grid_scale {background-color: #dce8ee;.gantt_grid_head_cell {font-size: 14px;font-weight: bold;color: #000;}}// 设置右侧头部数据.gantt_task_scale {background-color: #dce8ee;.gantt_grid_head_top {font-size: 14px !important;font-weight: bold;color: #000;}.gantt_scale_cell {font-size: 10px;font-weight: bold;color: #000;}}// 保留左侧标题单元格的竖线 .gantt_grid_head_cell, .gantt_grid_data .gantt_cell { border-right: 1px solid #dcdcdc !important; } /* 去除左侧标题和右侧表格内容的激活状态样式 */ .gantt_grid_data, .gantt_row.gantt_selected {background-color: transparent !important;}// 去除左侧标题内容的悬停效果.gantt_row:hover {background: none !important; // 去除背景色 }.gantt_row:active {background: none !important; // 去除背景色 }}
}// tooltips样式
.gantt_tooltip {background-color: #ccc;.gantt-tooltip-time-space {display: flex;align-items: center;margin-bottom: 4px;align-items: baseline;.time-word {color: #000;font-size: 12px;font-weight: bold;}.time-value {color: #000;}}.gantt-tooltip-task {display: flex;align-items: center;.task-word {color: #000;font-size: 12px;font-weight: bold;}.task-value {color: red;}}
}实现的界面大家可自行运行，这里不再赘述。
![[极客大挑战 2019]PHP1](https://i-blog.csdnimg.cn/direct/9a04a7550dcf474f93a58ab656390ba1.png)
