2020-08-20 19:01:06 +02:00
# Gantt diagrams
2020-07-14 23:25:37 +02:00
2020-03-08 01:17:11 +01:00
> A Gantt chart is a type of bar chart, first developed by Karol Adamiecki in 1896, and independently by Henry Gantt in the 1910s, that illustrates a project schedule and the amount of time it would take for any one project to finish. Gantt charts illustrate number of days between the start and finish dates of the terminal elements and summary elements of a project.
2020-08-20 19:01:06 +02:00
2020-03-08 01:17:11 +01:00
## A note to users
2020-11-15 03:28:47 +01:00
Gantt Charts will record each scheduled task as one continuous bar that extends from the left to the right. The x axis represents time and the y records the different tasks and the order in which they are to be completed.
2020-08-20 19:01:06 +02:00
2020-10-16 11:49:06 +02:00
2022-03-01 13:00:52 +01:00
It is important to remember that when a date, day, or collection of dates specific to a task are "excluded", the Gantt Chart will accommodate those changes by extending an equal number of days, towards the right, not by creating a gap inside the task.
2021-12-30 08:53:47 +01:00
As shown here ![](./img/Gantt-excluded-days-within.png)
2020-08-20 19:01:06 +02:00
2020-11-15 03:28:47 +01:00
However, if the excluded dates are between two tasks that are set to start consecutively, the excluded dates will be skipped graphically and left blank, and the following task will begin after the end of the excluded dates.
2021-12-30 08:53:47 +01:00
As shown here ![](./img/Gantt-long-weekend-look.png)
2020-08-20 19:01:06 +02:00
A Gantt chart is useful for tracking the amount of time it would take before a project is finished, but it can also be used to graphically represent "non-working days", with a few tweaks.
Mermaid can render Gantt diagrams as SVG, PNG or a MarkDown link that can be pasted into docs.
2019-07-12 20:40:54 +02:00
2021-11-02 04:18:18 +01:00
```mermaid-example
2019-09-27 19:15:03 +02:00
gantt
title A Gantt Diagram
dateFormat YYYY-MM-DD
section Section
A task :a1, 2014-01-01, 30d
Another task :after a1 , 20d
section Another
Task in sec :2014-01-12 , 12d
another task : 24d
```
2022-05-11 03:08:32 +02:00
2019-07-12 20:40:54 +02:00
## Syntax
2021-11-02 04:18:18 +01:00
```mermaid-example
2019-07-16 21:13:40 +02:00
gantt
2020-08-20 00:38:24 +02:00
dateFormat YYYY-MM-DD
title Adding GANTT diagram functionality to mermaid
excludes weekends
%% (`excludes` accepts specific dates in YYYY-MM-DD format, days of the week ("sunday") or "weekends", but not the word "weekdays".)
section A section
Completed task :done, des1, 2014-01-06,2014-01-08
Active task :active, des2, 2014-01-09, 3d
Future task : des3, after des2, 5d
Future task2 : des4, after des3, 5d
section Critical tasks
Completed task in the critical line :crit, done, 2014-01-06,24h
Implement parser and jison :crit, done, after des1, 2d
Create tests for parser :crit, active, 3d
Future task in critical line :crit, 5d
Create tests for renderer :2d
Add to mermaid :1d
2021-11-08 11:52:13 +01:00
Functionality added :milestone, 2014-01-25, 0d
2020-08-20 00:38:24 +02:00
section Documentation
Describe gantt syntax :active, a1, after des1, 3d
Add gantt diagram to demo page :after a1 , 20h
Add another diagram to demo page :doc1, after a1 , 48h
section Last section
Describe gantt syntax :after doc1, 3d
Add gantt diagram to demo page :20h
Add another diagram to demo page :48h
```
2019-07-12 20:40:54 +02:00
2020-10-14 14:41:15 +02:00
It is possible to set multiple dependencies separated by space:
2022-05-11 03:08:32 +02:00
2021-11-02 04:18:18 +01:00
```mermaid-example
2019-12-11 21:28:07 +01:00
gantt
apple :a, 2017-07-20, 1w
banana :crit, b, 2017-07-23, 1d
cherry :active, c, after b a, 1d
```
2019-07-12 20:40:54 +02:00
### Title
2020-06-12 11:44:01 +02:00
The `title` is an *optional* string to be displayed at the top of the Gantt chart to describe the chart as a whole.
2019-07-12 20:40:54 +02:00
2020-06-12 11:44:01 +02:00
### Section statements
2019-07-12 20:40:54 +02:00
2020-06-12 11:44:01 +02:00
You can divide the chart into various sections, for example to separate different parts of a project like development and documentation.
To do so, start a line with the `section` keyword and give it a name. (Note that unlike with the [title for the entire chart ](#title ), this name is *required* .
2019-07-12 20:40:54 +02:00
2021-09-21 13:29:59 +02:00
### Milestones
2022-05-11 03:08:32 +02:00
You can add milestones to the diagrams. Milestones differ from tasks as they represent a single instant in time and are identified by the keyword `milestone` . Below is an example on how to use milestones. As you may notice, the exact location of the milestone is determined by the initial date for the milestone and the "duration" of the task this way: *initial date* +*duration*/2.
2021-10-19 02:05:52 +02:00
2021-11-02 04:18:18 +01:00
```mermaid-example
2021-10-19 02:05:52 +02:00
gantt
dateFormat HH:mm
axisFormat %H:%M
Initial milestone : milestone, m1, 17:49,2min
taska2 : 10min
taska3 : 5min
Final milestone : milestone, m2, 18:14, 2min
```
2021-09-21 13:29:59 +02:00
2019-07-12 20:40:54 +02:00
## Setting dates
2020-04-27 17:27:03 +02:00
`dateFormat` defines the format of the date **input** of your gantt elements. How these dates are represented in the rendered chart **output** are defined by `axisFormat` .
2019-07-12 20:40:54 +02:00
2020-08-20 19:01:06 +02:00
### Input date format
2019-07-12 20:40:54 +02:00
2020-04-27 17:27:03 +02:00
The default input date format is `YYYY-MM-DD` . You can define your custom ``dateFormat``.
2019-09-27 18:52:22 +02:00
```
2020-04-27 17:27:03 +02:00
dateFormat YYYY-MM-DD
2019-09-27 18:52:22 +02:00
```
2019-07-12 20:40:54 +02:00
2022-03-01 13:00:52 +01:00
The following formatting options are supported:
2019-07-12 20:40:54 +02:00
2020-04-27 17:29:22 +02:00
```
2020-11-10 11:31:14 +01:00
Input Example Description:
YYYY 2014 4 digit year
YY 14 2 digit year
Q 1..4 Quarter of year. Sets month to first month in quarter.
M MM 1..12 Month number
MMM MMMM January..Dec Month name in locale set by moment.locale()
D DD 1..31 Day of month
Do 1st..31st Day of month with ordinal
DDD DDDD 1..365 Day of year
X 1410715640.579 Unix timestamp
x 1410715640579 Unix ms timestamp
H HH 0..23 24 hour time
h hh 1..12 12 hour time used with a A.
a A am pm Post or ante meridiem
m mm 0..59 Minutes
s ss 0..59 Seconds
S 0..9 Tenths of a second
SS 0..99 Hundreds of a second
SSS 0..999 Thousandths of a second
Z ZZ +12:00 Offset from UTC as +-HH:mm, +-HHmm, or Z
2019-07-12 20:40:54 +02:00
```
2020-04-27 17:29:22 +02:00
2022-05-31 23:18:45 +02:00
More info in: https://momentjs.com/docs/#/parsing/string-format/
2019-07-12 20:40:54 +02:00
2020-04-27 17:27:03 +02:00
### Output date format on the axis
The default output date format is YYYY-MM-DD. You can define your custom ``axisFormat``, like `2020-Q1` for the first quarter of the year 2020.
```
2020-08-20 19:01:06 +02:00
axisFormat %Y-%m-%d
2020-04-27 17:27:03 +02:00
```
2019-07-12 20:40:54 +02:00
2022-03-01 13:00:52 +01:00
The following formatting strings are supported:
2019-07-12 20:40:54 +02:00
```
%a - abbreviated weekday name.
%A - full weekday name.
%b - abbreviated month name.
%B - full month name.
%c - date and time, as "%a %b %e %H:%M:%S %Y".
%d - zero-padded day of the month as a decimal number [01,31].
%e - space-padded day of the month as a decimal number [ 1,31]; equivalent to %_d.
%H - hour (24-hour clock) as a decimal number [00,23].
%I - hour (12-hour clock) as a decimal number [01,12].
%j - day of the year as a decimal number [001,366].
%m - month as a decimal number [01,12].
%M - minute as a decimal number [00,59].
%L - milliseconds as a decimal number [000, 999].
%p - either AM or PM.
%S - second as a decimal number [00,61].
%U - week number of the year (Sunday as the first day of the week) as a decimal number [00,53].
%w - weekday as a decimal number [0(Sunday),6].
%W - week number of the year (Monday as the first day of the week) as a decimal number [00,53].
%x - date, as "%m/%d/%Y".
%X - time, as "%H:%M:%S".
%y - year without century as a decimal number [00,99].
%Y - year with century as a decimal number.
%Z - time zone offset, such as "-0700".
%% - a literal "%" character.
```
More info in: https://github.com/mbostock/d3/wiki/Time-Formatting
2019-11-27 00:34:52 +01:00
## Comments
2020-11-04 16:52:28 +01:00
Comments can be entered within a gantt chart, which will be ignored by the parser. Comments need to be on their own line and must be prefaced with `%%` (double percent signs). Any text after the start of the comment to the next newline will be treated as a comment, including any diagram syntax
2019-11-27 00:34:52 +01:00
2021-11-11 03:04:40 +01:00
```mmd
2019-11-27 00:34:52 +01:00
gantt
title A Gantt Diagram
%% this is a comment
dateFormat YYYY-MM-DD
section Section
A task :a1, 2014-01-01, 30d
Another task :after a1 , 20d
section Another
Task in sec :2014-01-12 , 12d
another task : 24d
```
2019-07-12 20:40:54 +02:00
## Styling
2021-03-04 07:33:17 +01:00
Styling of the a gantt diagram is done by defining a number of css classes. During rendering, these classes are extracted from the file located at src/themes/gantt.scss
2019-07-12 20:40:54 +02:00
### Classes used
Class | Description
2021-03-04 07:33:17 +01:00
--- | ---
grid.tick | Styling for the Grid Lines
grid.path | Styling for the Grid's borders
.taskText | Task Text Styling
2021-03-05 03:48:26 +01:00
.taskTextOutsideRight | Styling for Task Text that exceeds the activity bar towards the right.
.taskTextOutsideLeft | Styling for Task Text that exceeds the activity bar, towards the left.
2021-03-04 07:33:17 +01:00
todayMarker | Toggle and Styling for the "Today Marker"
2019-07-12 20:40:54 +02:00
### Sample stylesheet
```css
.grid .tick {
stroke: lightgrey;
opacity: 0.3;
shape-rendering: crispEdges;
}
.grid path {
stroke-width: 0;
}
#tag {
color: white;
background: #FA283D ;
width: 150px;
position: absolute;
display: none;
padding:3px 6px;
margin-left: -80px;
font-size: 11px;
}
#tag:before {
border: solid transparent;
content: ' ';
height: 0;
left: 50%;
margin-left: -5px;
position: absolute;
width: 0;
border-width: 10px;
border-bottom-color: #FA283D ;
top: -20px;
}
.taskText {
fill:white;
text-anchor:middle;
}
.taskTextOutsideRight {
fill:black;
text-anchor:start;
}
.taskTextOutsideLeft {
fill:black;
text-anchor:end;
}
```
2020-06-12 11:44:01 +02:00
## Today marker
You can style or hide the marker for the current date. To style it, add a value for the `todayMarker` key.
```
todayMarker stroke-width:5px,stroke:#0f0,opacity:0.5
```
To hide the marker, set `todayMarker` to `off` .
```
todayMarker off
```
2019-07-12 20:40:54 +02:00
## Configuration
2020-11-04 16:52:28 +01:00
It is possible to adjust the margins for rendering the gantt diagram.
2019-07-12 20:40:54 +02:00
This is done by defining the `ganttConfig` part of the configuration object.
How to use the CLI is described in the [mermaidCLI ](mermaidCLI.html ) page.
mermaid.ganttConfig can be set to a JSON string with config parameters or the corresponding object.
```javascript
mermaid.ganttConfig = {
titleTopMargin:25,
barHeight:20,
barGap:4,
topPadding:75,
sidePadding:75
}
```
2020-11-04 16:52:28 +01:00
### Possible configuration params:
2019-07-12 20:40:54 +02:00
2021-03-04 07:33:17 +01:00
Param | Description | Default value
2019-07-12 20:40:54 +02:00
--- | --- | ---
mirrorActor|Turns on/off the rendering of actors below the diagram as well as above it|false
2020-10-14 14:41:15 +02:00
bottomMarginAdj|Adjusts how far down the graph ended. Wide borders styles with css could generate unwanted clipping which is why this config param exists.|1
2019-12-11 01:04:42 +01:00
## Interaction
2020-11-04 16:52:28 +01:00
It is possible to bind a click event to a task. The click can lead to either a javascript callback or to a link which will be opened in the current browser tab. **Note** : This functionality is disabled when using `securityLevel='strict'` and enabled when using `securityLevel='loose'` .
2019-12-11 01:04:42 +01:00
```
click taskId call callback(arguments)
click taskId href URL
```
* taskId is the id of the task
2020-11-04 16:52:28 +01:00
* callback is the name of a javascript function defined on the page displaying the graph, the function will be called with the taskId as the parameter if no other arguments are specified.
2019-12-11 01:04:42 +01:00
2022-08-19 18:55:50 +02:00
Beginner's tip—a full example using interactive links in an html context:
2020-09-07 08:02:09 +02:00
```html
2019-12-11 01:04:42 +01:00
< body >
< div class = "mermaid" >
gantt
dateFormat YYYY-MM-DD
section Clickable
Visit mermaidjs :active, cl1, 2014-01-07, 3d
Print arguments :cl2, after cl1, 3d
Print task :cl3, after cl2, 3d
click cl1 href "https://mermaidjs.github.io/"
click cl2 call printArguments("test1", "test2", test3)
click cl3 call printTask()
< / div >
< script >
2022-05-11 03:08:32 +02:00
var printArguments = function(arg1, arg2, arg3) {
alert('printArguments called with arguments: ' + arg1 + ', ' + arg2 + ', ' + arg3);
}
var printTask = function(taskId) {
alert('taskId: ' + taskId);
}
var config = {
startOnLoad:true,
securityLevel:'loose',
};
mermaid.initialize(config);
2019-12-11 01:04:42 +01:00
< / script >
< / body >
```