热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

wlgantt:一个简单易用且高度可配置的甘特图进度计划项目管理插件

wl-gantt简介甘特图(Ganttchart)又称为横道图、条状图(Barchart)、生产计划进度图。其通过条状图来显示项目,进

wl-gantt


简介

甘特图(Gantt chart)又称为横道图、条状图(Bar chart)、生产计划进度图。其通过条状图来显示项目,进度,和其他时间相关的系统进展的内在关系随着时间进展的情况。以提出者亨利·劳伦斯·甘特(Henry Laurence Gantt)先生的名字命名。
目前市面上最有名的几个gantt插件占据江湖了非常久远的时间,它们古老又强大。
但无一例外的是:它们收费或极其难用并且依赖非常古老的技术,其中有些技术现在入行的新手甚至从未听闻。
【jQueryGantt】【plusgantt】【dhtmlx】 不可否认它们都非常的强大,不管是从性能还是功能性。但是大多的业务需求并不需要如此庞然大物才能满足需求。 另一方面古老的技术稀缺的文档又让开发者无从下手(收费版甚至不提供文档,而你的老板又肯定不会提供钱买下授权)。
wl-gantt出现的背景就是笔者在公司的Vue项目中使用B***Gantt插件所受到的巨大伤害:基于extjs(对于17年入行的我来说没听过)、不提供开发文档、没有中文资料、源码加密,开发全靠打印实例找属性。 wl-gantt是一个基于Vue及elementUi的gantt甘特图插件,是一个896的码奴在仅有的剩余的1中挤时间开发而成。
它目提供的功能有:自动检查源数据是否符合project任务安排规则、结束后开始的前置任务规则、yearAndmonth|yearAndWeek|ManthAndDay日期跨度地洞切换、内置前置任务管理器。
它的优点:非常简单易用,并且高度可配置,自动抹平不合格数据并给与提示,不会无缘无故产生异常。
它正在逐渐长大,下个阶段,它将学会:
1. yearAndMonth、monthAndDay、yearAndWeek时间跨度配置 【已完成,month及week格子起止位置待精确化】
2. 内置前置任务选择器 【已完成】
3. 整合树表全选联动功能 【已完成】
4. 添加、移除任务回调 【已完成】
4. 任务连接线
5. 任务自定义悬浮提示
6. 和所有你觉得需要用到的需求


在线演示 - GitHub


wl-gantt 与市面应用较广的大佬型插件对比


wl-gantt 外观简洁清爽,非常简单易用,高度可配置
wl-gantt



jquery Gantt 笨重、老旧、较丑但文档还算清晰
jquery Gantt



js gantt 不想多说了
js gantt



dhtmlxGantt 功能强大、全面;但是使用难度高,不切合现代框架及ui库,很难在项目中完美应用
dhtmlxGantt



frappe-gantt 功能好少
frappe



bryntum 唯一较美观的,但是可配置性差,无法和组件结合;不校验源数据正确性就报错、崩溃;规则死板不符合项目使用;收费年950$; 功能强大但文档只有简单介绍,详细用法只能控制台打印
bryntum



更新说明


2020-04-03 懒加载
2020-02-20 更新gantt,详见版本说明1.0.1
2019-12-14 更新gantt,增加内置前置任务列,支持多选前置和单选前置,并自动校验源数据前置任务合法性。
2019-12-3 更新gantt。1表格支持el-table大部分AttributesEvents,详细列表见下方;2名称列增加nameFormatter格式化内容函数支持;3日期列改为点击显示编辑输入框的形式。
2019-12-2 更新gantt.1日期支持yearAndMonth、monthAndDay、yearAndWeek类型,详见版本记录1;2修复部分时间更改情况不回调的问题。



已支持el-table参数及事件列表

:fit="fit":size="size":border="border":data="selfData":stripe="stripe":height="height":row-key="rowKey":row-style="rowStyle":class="dateTypeClass":cell-style="cellStyle":max-height="maxHeight":tree-props="selfProps":current-row-key="rowKey":row-class-name="rowClassName":cell-class-name="cellClassName":expand-row-keys="expandRowKeys":header-row-style="headerRowStyle":header-cell-style="headerCellStyle":default-expand-all="defaultExpandAll":header-row-class-name="headerRowClassName":highlight-current-row="highlightCurrentRow":header-cell-class-name="headerCellClassName"@header-contextmenu="handleHeaderContextMenu"@selection-change="handleSelectionChange"@row-contextmenu="handleRowContextMenu"@current-change="handleCurrentChange"@cell-mouse-enter="handleMouseEnter"@cell-mouse-leave="handleMouseLeave"@expand-change="handleExpandChange"@filter-change="handleFilterChange"@cell-dblclick="handleCellDbClick"@header-click="handleHeaderClick"@row-dblclick="handleRowDbClick"@sort-change="handleSortChange"@cell-click="handleCellClick"@select-all="handleSelectAll"@row-click="handleRowClick"@select="handleSelect"

快速上手

npm i wl-gantt --save

npm i wl-gantt -S

import wlGantt from 'wl-gantt'

import "wl-gantt/lib/wl-gantt.css"

Vue.use(wlGantt)


文档


Attributes 参数


序号参数说明类型可选值默认值注意
1data数据Array-[]-
2dateTypegantt图区日期表头类型StringmonthAndDay、yearAndMonth、yearAndDayyearAndMonth-
3treeProps树表配置项Object--见下方props
4startDate项目开始时间String、Object必填-注意:不要求任务时间线在项目开始时间内,并且当任务时间超出项目时间时,将更新项目时间
5endDate项目结束时间String、Object必填-注意:不要求任务时间线在项目开始时间内,并且当任务时间超出项目时间时,将更新项目时间
6checkSource是否检查源数据符合规则Boolean--检查源数据为自动修改不符合规范的时间为符合规则的期望值
7treatIdAsIdentityId是否使用id来作为自增idBoolean-false如果是请保证id本来就简短的数字型而不是较长的字符串或guid
8autoGanttDateType自动调整gantt时间跨度类型,具体规则见版本记录1Boolean-true-
9nameFormatter名称列格式化内容函数Function--Function(row, column, cellValue, index)
10其他Table Attributes文档地址----
11usePreColumn是否使用内置前置任务列Boolean-false-
12preMultiple前置任务是否可以多选Boolean-true如果开启多选则pre字段必须是Array,否则可以是Number\String
13preFormatter前置内容列格式化函数Function--如不传则根据prop name字段+,拼接
14emptyCellText空值单元格占位符String-‘-’-
15useCheckColumn是否使用内置复选框列Boolean-false-
16useIndexColumn是否使用内置序号列Boolean-false-
17edit是否可编辑Boolean-true-
18parentChild使用复选框时,是否父子关联Boolean-true必须配置props的id、children字段
19ganttOnly是否只显示图形Boolean-false-
20lazy同el-tableBoolean-false-
21load同el-tableFunction---
22contextMenuOptions右键浮窗配置项,如果存在则点击gantt右键显示配置的浮窗信息Array--数组内对象属性有:* @param {String} label 展示名称 * @param {String} prop 绑定的字段 * @param {String} icon 可选 字体图标class

props 配置项


序号参数说明默认值
1children数据的子集children字段,表示为树表children
2name用于显示名字的字段name
3id每条数据的id,必须唯一id
4pid每条数据的父节点id字段pid
5startDate每条数据的开始时间字段startDate
6endDate每条数据的结束时间字段endDate
7identityId数据自增ididentityId
8parents自增父级id树,逗号分隔parents
9pre前置任务字段,字段值应是前置任务的idpre
10hasChildren指定哪些行是包含子节点hasChildren

Events 事件


序号事件名说明回调参数
1timeChange当任务时间发生更改时触发function(row) 依次为当前行数据
2其他Table Events文档地址-
3preChange前置任务修改事件function(row) 依次为当前行数据
4nameChange名称修改事件function(row) 依次为当前行数据
5taskAdd添加任务事件function(row) 依次为当前行数据
6taskRemove删除任务事件function(row) 依次为当前行数据

Methods 方法


序号方法名说明回调参数
1loadTree手动调用树表懒加载function(row) 依次为要展开的行信息
2loadTreeAdd更新树表懒加载后的子节点function(id, list) 依次为要更新的节点id,要添加的子节点list,注意此为合并list和原来的子节点数据
3loadTreeRemove移除懒加载数据的子节点function(id, list) 依次为要更新的节点id,要删掉的子字节的rowKey

slot


序号名字说明
1prv用于插入列表中名称前的列,如不生效需加fixed
2-插入在默认列及甘特图之间的列

版本记录


1.0.3版本,修复超过一年的时间跨度展示错误;增加右键浮窗功能



1.0.2版本,增加lazy和load参数,支持懒加载,并提供懒加载时的方法:Methods:1,2,3;增加ganttOnly参数支持只显示图形



1.0.1版本 增加内置复选框列、序号列;增加是否可编辑参数;修改内置前置任务列配置参数值为false;增加复选框的父子联动属性;增加名称列可编辑逻辑;增加添加、移除任务事件;



1.0.0版本 增加内置前置任务列,支持多选前置和单选前置,并自动校验源数据前置任务合法性。



0.1.6版本 更新gantt。1表格支持el-table大部分AttributesEvents;2名称列增加nameFormatter格式化内容函数支持;3日期列改为点击显示编辑输入框的形式。注意树表时rowKey参数必须传,默认为id



0.1.5版本 更新gantt日期支持yearAndMonth、monthAndDay、yearAndWeek类型,并自动调整,规则为:大于12个月的自动调整为yearAndMonth,3个月到12个月之间的,自动调整为yearAndWeek, 2个月及以内的自动调整为monthAndDay。新增参数autoGanttDateType可以管理是否自动调整,如果要关闭自动调整请保证时间跨度尽可能的少,否则会有明显的性能问题。修复部分时间更改情况不回调的问题。



推荐阅读
  • 提升 Kubernetes 集群管理效率的七大专业工具
    Kubernetes 在云原生环境中的应用日益广泛,然而集群管理的复杂性也随之增加。为了提高管理效率,本文推荐了七款专业工具,这些工具不仅能够简化日常操作,还能提升系统的稳定性和安全性。从自动化部署到监控和故障排查,这些工具覆盖了集群管理的各个方面,帮助管理员更好地应对挑战。 ... [详细]
  • 本文详细介绍了使用 Python 进行 MySQL 和 Redis 数据库操作的实战技巧。首先,针对 MySQL 数据库,通过 `pymysql` 模块展示了如何连接和操作数据库,包括建立连接、执行查询和更新等常见操作。接着,文章深入探讨了 Redis 的基本命令和高级功能,如键值存储、列表操作和事务处理。此外,还提供了多个实际案例,帮助读者更好地理解和应用这些技术。 ... [详细]
  • 如何高效启动大数据应用之旅?
    在前一篇文章中,我探讨了大数据的定义及其与数据挖掘的区别。本文将重点介绍如何高效启动大数据应用项目,涵盖关键步骤和最佳实践,帮助读者快速踏上大数据之旅。 ... [详细]
  • 本文深入探讨了 hCalendar 微格式在事件与时间、地点相关活动标记中的应用。作为微格式系列文章的第四篇,前文已分别介绍了 rel 属性用于定义链接关系、XFN 微格式增强链接的人际关系描述以及 hCard 微格式对个人和组织信息的描述。本次将重点解析 hCalendar 如何通过结构化数据标记,提高事件信息的可读性和互操作性。 ... [详细]
  • 本文全面解析了JavaScript中的DOM操作,并提供了详细的实践指南。DOM节点(Node)通常代表一个标签、文本或HTML属性,每个节点都具有一个nodeType属性,用于标识其类型。文章深入探讨了DOM节点的创建、查询、修改和删除等操作,结合实际案例,帮助读者更好地理解和掌握DOM编程技术。 ... [详细]
  • 技术日志:使用 Ruby 爬虫抓取拉勾网职位数据并生成词云分析报告
    技术日志:使用 Ruby 爬虫抓取拉勾网职位数据并生成词云分析报告 ... [详细]
  • 开源实习机会 | Compiler SIG 正式发布实习任务,诚邀您加入申请!
    对编译技术充满兴趣却苦于无从入手?当前疫情形势下,外出实习变得困难重重?现在,Compiler SIG 正式发布了一系列实习任务,为有志之士提供了宝贵的机会。无论你是初学者还是有一定基础的学生,都能在这里找到适合自己的实践项目。我们诚挚邀请您的加入,共同探索编译技术的无限可能! ... [详细]
  • 在深入研究 React 项目的过程中,特别是在探索 react-router 源码时,我发现了其中蕴含的中间件概念。这激发了我对中间件的进一步思考与整理。本文将详细探讨 Redux 中间件的原理及其在实际项目中的应用,帮助读者更好地理解和使用这一强大工具。通过具体示例和代码解析,我们将揭示中间件如何提升应用的状态管理和异步操作处理能力。 ... [详细]
  • 通过使用CIFAR-10数据集,本文详细介绍了如何快速掌握Mixup数据增强技术,并展示了该方法在图像分类任务中的显著效果。实验结果表明,Mixup能够有效提高模型的泛化能力和分类精度,为图像识别领域的研究提供了有价值的参考。 ... [详细]
  • 利用树莓派畅享落网电台音乐体验
    最近重新拾起了闲置已久的树莓派,这台小巧的开发板已经沉寂了半年多。上个月闲暇时间较多,我决定将其重新启用。恰逢落网电台进行了改版,回忆起之前在树莓派论坛上看到有人用它来播放豆瓣音乐,便萌生了同样的想法。通过一番调试,终于实现了在树莓派上流畅播放落网电台音乐的功能,带来了全新的音乐享受体验。 ... [详细]
  • FastDFS Nginx 扩展模块的源代码解析与技术剖析
    FastDFS Nginx 扩展模块的源代码解析与技术剖析 ... [详细]
  • 如何在Mac上构建高效的本地服务器环境
    在Mac上构建高效的本地服务器环境,首先需要了解基本步骤:1. 配置目录基础;2. 启动Apache服务;3. 添加自定义文档至本地服务器;4. 查看自定义效果。此外,还可以通过手机或其他电脑访问本机服务器,以确保跨设备的兼容性和调试效果。Mac系统自带的Apache服务为本地开发提供了便捷的工具,本文将详细介绍每个步骤的具体操作方法。 ... [详细]
  • 深入解析 Vue 中的 Axios 请求库
    本文深入探讨了 Vue 中的 Axios 请求库,详细解析了其核心功能与使用方法。Axios 是一个基于 Promise 的 HTTP 客户端,支持浏览器和 Node.js 环境。文章首先介绍了 Axios 的基本概念,随后通过具体示例展示了如何在 Vue 项目中集成和使用 Axios 进行数据请求。无论你是初学者还是有经验的开发者,本文都能为你解决 Vue.js 相关问题提供有价值的参考。 ... [详细]
  • 在今天的实践中,我深入学习了网页图像抓取技术,通过编写爬虫程序批量获取网站上的图片资源。具体来说,我选择了一个包含大量高质量图片的网站作为练习对象,并成功实现了将这些图片批量下载到本地存储。这一过程不仅提升了我对爬虫技术的理解,还增强了我的编程能力。 ... [详细]
  • 掌握PHP编程必备知识与技巧——全面教程在当今的PHP开发中,了解并运用最新的技术和最佳实践至关重要。本教程将详细介绍PHP编程的核心知识与实用技巧。首先,确保你正在使用PHP 5.3或更高版本,最好是最新版本,以充分利用其性能优化和新特性。此外,我们还将探讨代码结构、安全性和性能优化等方面的内容,帮助你成为一名更高效的PHP开发者。 ... [详细]
author-avatar
每天听点心理学_961
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有