Frappe Gantt开发环境搭建指南

2025-06-08 08:55:01作者：廉彬冶Miranda

Frappe Gantt是一个功能强大的甘特图库，本文将详细介绍如何搭建其开发环境并进行本地开发调试。

项目背景

Frappe Gantt是一个基于SVG的交互式甘特图库，具有响应式设计和丰富的功能特性。在最新版本中，项目结构调整移除了原本的index.html入口文件，这给部分开发者带来了困惑。

开发环境搭建步骤

1. 创建入口文件

首先需要在项目根目录下创建index.html文件，内容如下：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Frappe Gantt Demo</title>
    <link rel="stylesheet" href="./builder/demo.css">
</head>
<body>
    <h1>Frappe Gantt Demos</h1>
    
    <!-- 各功能演示区域 -->
    <div class="gantt-demo-section">
        <h2>Central Demo</h2>
        <div id="central-demo"></div>
    </div>
    
    <!-- 其他演示区域 -->
    <script type="module" src="./builder/demo.js"></script>
</body>
</html>

2. 配置演示数据

在builder/demo.js中配置演示用的任务数据：

import Gantt from '../src/index'

const tasks = [
    {
        start: daysSince(-7),
        end: daysSince(-5),
        name: 'Initial brainstorming',
        id: 'Task 0',
        progress: random(),
    },
    // 更多任务数据...
];

// 初始化Gantt实例
new Gantt('#central-demo', tasks, {
    scroll_to: daysSince(-7),
    infinite_padding: false,
});

3. 辅助函数

添加日期处理和随机数生成的辅助函数：

function daysSince(days) {
    const date = new Date();
    date.setDate(date.getDate() + days);
    return date.toISOString().split('T')[0];
}

function random() {
    return Math.floor(Math.random() * 100);
}