You are viewing documentation for an older version. For current documentation - click here.
 Gantt Chart Specification Sheet
 SWF: Gantt.swf

Quick Links (within this page)
 Chart  Data  Others
 Chart Image
 Chart Objects
 Functional Attributes
 Legend properties
 Cosmetics properties
 Scroll bar properties
 Paddings and Margins
 Tooltip
 Sample XML Data
 <categories> element
 <category> element
 <processes> element
 <process> element
 <tasks> element
 <task> element
 <trendlines> --> <line> element
 <datatable> element
 <datacolumn> element
 <text> element
 <connectors> element
 <connector> element
 <milestones> --> <milestone> element
 <legend> --> <item> element

 Gantt Chart looks as under:
Gantt Chart
 Sample XML / JSON for Gantt Chart:
<chart dateFormat="mm/dd/yyyy" caption="Project Gantt" subCaption="From 1st Feb 2007 - 31st Aug 2007">
<categories>
<category start="02/01/2007" end="03/01/2007" label="Feb"/>
<category start="03/01/2007" end="04/01/2007" label="Mar"/>
<category start="04/01/2007" end="05/01/2007" label="Apr"/>
<category start="05/01/2007" end="06/01/2007" label="May"/>
<category start="06/01/2007" end="07/01/2007" label="Jun"/>
<category start="07/01/2007" end="08/01/2007" label="Jul"/>
<category start="08/01/2007" end="09/01/2007" label="Aug"/>
</categories>
<processes fontSize="12" isBold="1" align="right">
<process label="Identify Customers"/>
<process label="Survey 50 Customers"/>
<process label="Interpret Requirements"/>
<process label="Study Competition"/>
<process label="Documentation of features"/>
<process label="Brainstorm concepts"/>
<process label="Design & Code"/>
<process label="Testing / QA"/>
<process label="Documentation of product"/>
<process label="Global Release"/>
</processes>
<tasks>
<task start="02/04/2007" end="02/10/2007"/>
<task start="02/08/2007" end="02/19/2007"/>
<task start="02/19/2007" end="03/02/2007"/>
<task start="02/24/2007" end="03/02/2007"/>
<task start="03/02/2007" end="03/21/2007"/>
<task start="03/21/2007" end="04/06/2007"/>
<task start="04/06/2007" end="07/21/2007"/>
<task start="07/21/2007" end="08/19/2007"/>
<task start="07/28/2007" end="08/24/2007"/>
<task start="08/24/2007" end="08/27/2007"/>
</tasks>
</chart>
{
  "chart": {
    "dateformat": "mm/dd/yyyy",
    "caption": "Project Gantt",
    "subcaption": "From 1st Feb 2007 - 31st Aug 2007"
  },
  "categories": [
    {
      "category": [
        {
          "start": "02/01/2007",
          "end": "03/01/2007",
          "label": "Feb"
        },
        {
          "start": "03/01/2007",
          "end": "04/01/2007",
          "label": "Mar"
        },
        {
          "start": "04/01/2007",
          "end": "05/01/2007",
          "label": "Apr"
        },
        {
          "start": "05/01/2007",
          "end": "06/01/2007",
          "label": "May"
        },
        {
          "start": "06/01/2007",
          "end": "07/01/2007",
          "label": "Jun"
        },
        {
          "start": "07/01/2007",
          "end": "08/01/2007",
          "label": "Jul"
        },
        {
          "start": "08/01/2007",
          "end": "09/01/2007",
          "label": "Aug"
        }
      ]
    }
  ],
  "processes": {
    "fontsize": "12",
    "isbold": "1",
    "align": "right",
    "process": [
      {
        "label": "Identify Customers"
      },
      {
        "label": "Survey 50 Customers"
      },
      {
        "label": "Interpret Requirements"
      },
      {
        "label": "Study Competition"
      },
      {
        "label": "Documentation of features"
      },
      {
        "label": "Brainstorm concepts"
      },
      {
        "label": "Design & Code"
      },
      {
        "label": "Testing / QA"
      },
      {
        "label": "Documentation of product"
      },
      {
        "label": "Global Release"
      }
    ]
  },
  "tasks": {
    "task": [
      {
        "start": "02/04/2007",
        "end": "02/10/2007"
      },
      {
        "start": "02/08/2007",
        "end": "02/19/2007"
      },
      {
        "start": "02/19/2007",
        "end": "03/02/2007"
      },
      {
        "start": "02/24/2007",
        "end": "03/02/2007"
      },
      {
        "start": "03/02/2007",
        "end": "03/21/2007"
      },
      {
        "start": "03/21/2007",
        "end": "04/06/2007"
      },
      {
        "start": "04/06/2007",
        "end": "07/21/2007"
      },
      {
        "start": "07/21/2007",
        "end": "08/19/2007"
      },
      {
        "start": "07/28/2007",
        "end": "08/24/2007"
      },
      {
        "start": "08/24/2007",
        "end": "08/27/2007"
      }
    ]
  }
}
Back to top Back to Top

Chart Objects

Custom defined Styles can be applied to the chart objects listed below. The table contains the names of the chart objects, short descriptions, list of supported Styles and list of supported animation parameters.

Object Name Description Features Supported Animation Parameters Supported
BACKGROUND Background refers to the background for entire chart.
  • Animation
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
  • _x
  • _y
  • _xScale
  • _yScale
CANVAS The entire area inside which the Gantt chart is plotted.
  • Animation
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
  • _x
  • _y
  • _xScale
  • _yScale
CAPTION Caption of the chart.
  • Animation
  • Font
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
  • _x
  • _y
SUBCAPTION Sub-caption of the chart.
  • Animation
  • Font
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
  • _x
  • _y
TASKS All the task bars being shown on the chart.
  • Animation
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
  • _xScale
  • _yScale
TASKLABELS Labels of the task bar.
  • Animation
  • Font
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
  • _x
  • _y
TASKDATELABELS Date labels for each task bar (both start and end date)
  • Animation
  • Font
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
  • _x
  • _y
MILESTONES All the milestones plotted on the chart.
  • Animation
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
  • _x
  • _y
  • _xScale
  • _yScale
CONNECTORS All the connectors that have been drawn to connect different tasks.
  • Animation
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
TRENDLINES All the trend lines or trend zones drawn on the chart.
  • Animation
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
TRENDVALUES Display label of the trend lines or trend zones drawn on the chart.
  • Animation
  • Font
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
TOOLTIP Tooltip for the chart.
  • Font
 
LEGEND Legend for the chart.
  • Animation
  • Font
  • Shadow
  • Glow
  • Bevel
  • Blur
  • _alpha
Back to top Back to Top

<chart> element

Functional Attributes

These attributes let you control a variety of functional elements on the chart. For example, you can opt to show/hide data labels, data values, y-axis values. You can also set chart limits and extended properties.

Attribute Name Type Description
dateFormat mm/dd/yyyy or dd/mm/yyyy or yyyy/mm/dd This attribute helps you specify the input date format for all the dates in your XML. This is a mandatory attribute to specify and once specified, all the dates in your XML data should conform to the format specified herein.
outputDateFormat String You can also specify how the dates look on your Gantt chart using this attribute. This attribute takes the output date format as string. You can build your own output date format string as explained in the section "Configuring date formats".
ganttPaneDuration Number If you want your Gantt pane to scroll through a specified time line, you can use this attribute to set what timeline the pane will represent. For example, if you want your Gantt pane to show date only for 3 months and then scroll the rest, you can set this attribute as 3. More of this has been explained in the section "Enable scrolling".
ganttPaneDurationUnit String - y,m,d, h, mn or s If you've opted to scroll the Gantt pane, this attribute lets you choose the unit of your specified duration. More of this has been explained in the section "Enable scrolling".
showFullDataTable Boolean (0/1) Whether to show full names of the process labels and data columns in grid. If you set this as on, the labels will not wrap and always show in full. When required, a scroll bar will automatically appear for the entire grid.
ganttWidthPercent Number (10-100) You can opt to set the width of the Gantt view pane in percent using this attribute. The rest of the width will be taken by the grid. If the data grid takes lesser space, the chart will automatically adjust the Gantt pane to assume more width.
forceGanttWidthPercent Boolean (0/1) If you want the chart to never automatically adjust the Gantt width and stick to the percent width that you've specified, you can set this attribute to 1.
caption String Caption for the chart.
subCaption String Sub-caption for the chart.
showTaskStartDate Boolean For each task bar in the Gantt chart, you can show its respective start date on its left. To do so, set this attribute as 1.
showTaskEndDate Boolean For each task bar in the Gantt chart, you can show its end date value too by setting this attribute as 1.
showTaskLabels Boolean (0/1) Whether to show task labels for each task bar in the Gantt chart. The task labels show up only if they've been defined for the task.
showPercentLabel Boolean (0/1) If you've used the percentage task feature, you can opt to show the percent complete for each task as part of the task label by setting this attribute as 1.
showSlackAsFill Boolean If you've used the percentage task feature, you can opt to show the slack (percent of work not completed) as either a filled bar or empty bar. To draw as empty bars, set this attribute as 0.
slackFillColor Hex Color If you've opted to fill the slack bars with color, you can define the color code for the same here.
animation Boolean Whether to animate the chart while rendering? If you define this attribute as 0, even your custom defined Style animations will not work.
defaultAnimation Boolean Whether to use the default animations specified in the chart? This can be specifically useful when you want to disable the default animations and then define your own custom animations using Styles.
clickURL String URL Click URL for the entire chart. The entire chart can then act as a hotspot. This URL can be provided in FusionCharts Link format.
annRenderDelay Number (time in seconds) If you've defined any annotation groups to be rendered over the chart, using this attribute you can control the time duration after which they'll appear on the chart.
extendCategoryBg Boolean If you set this attribute as 1, the Gantt pane grid will take the same background and border properties as that of the last category (visual dateline) defined.
showPrintMenuItem Boolean (0/1) Whether to show "Print Chart" item in the context menu of the chart? Even if you opt to hide the item in context menu, you can still opt to invoke print() JavaScript method of the chart to print the same.
showAboutMenuItem Boolean (0/1) Setting this to 1 displays a custom context menu in the chart, which can be customized to show your text and can be linked to your URL. For e.g., you can set the context menu of the chart to include "About your company name" and then link to your company home page. By default, the chart shows "About FusionCharts" when right clicked.
aboutMenuItemLabel String The menu item label for the custom context menu item.
aboutMenuItemLink String Link for the custom context menu item. You can specify the link in FusionCharts link format to be able to open the same in new window, pop-ups, frames or as JavaScript links.
scrollToDate
Since v 3.3.1
Date (mm/dd/yy) Chart will automatically scroll to the given date at the time of rendering. This attribute will only work when ganttPaneDuration and ganttPaneDurationUnit attributes are set as per requirement.

This feature is supported by JavaScript Gantt chart only.

useVerticalScrolling
Since v 3.3.1
Boolean (0/1) Whether to display the vertical scroll bar or not. By default, the attribute is set to 1 and the vertical scroll bar appears depending on the hieght of the chart. More of this has been explained in the section "Enable scrolling".

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

Cosmetic properties

The following attributes let you configure chart cosmetics like background color, background alpha, canvas color & alpha etc.

Attribute Name Type Description
palette Number (1-5) Which pre-defined color palette to use?
paletteThemeColor Hex Code If you want your own palette derived from a particular hex color, you can specify the same here. All other colors on the chart will automatically derive from that palette.
bgColor Color This attribute sets the background color for the chart. You can set any hex color code as the value of this attribute. To specify a gradient as background color, separate the hex color codes of each color in the gradient using comma. Example: FF5904, FFFFFF. Remember to remove # and any spaces in between. For more details see Using Gradients.
bgAlpha Number (0-100) Sets the alpha (transparency) for the background. If you've opted for gradient background, you need to set a list of alpha(s) separated by comma. For more details see Using Gradients.
bgRatio String of numbers (0-100) If you've opted for a gradient background, this attribute lets you set the ratio of each color constituent. For more details see Using Gradients.
bgAngle Number (0-360) Angle of the background color, in case of a gradient. For more details see Using Gradients.
showBorder Boolean (0/1) Whether to show a border around the chart or not?
borderColor Color Code Border color of the chart.
borderThickness Number Border thickness of the chart.
borderAlpha Number (0-100) Border alpha of the chart.
bgImage

or

bgSWF - deprecated
String To place any image (JPG/PNG/GIF) or Flash movie (SWF) as background of the chart, enter the (path and) name of the background image or SWF file. It should be in the same domain as the chart.

Loading of Flash movie is deprecated and is not supported by JavaScript charts.

bgImageAlpha

or

bgSWFAlpha - deprecated
Number (0-100) Helps you specify the opacity for the loaded background image or Flash movie.

Loading of Flash movie is deprecated and is not supported by JavaScript charts.

bgImageDisplayMode
Since v3.2
String (stretch, tile, fit, fill, center, none) Helps you specify the mode in which the background image is to be displayed.
  • Stretch - expands the image to fit the entire chart area, without maintaining original image constraints
  • Tile - the image is repeated as a pattern on the entire chart area
  • Fit - fits the image proportionately on the chart area
  • Fill -proportionately fills the entire chart area with the image
  • Center - the image is positioned at the center of the chart area
  • None - Default mode. None of the above modes are applied
For more details click here.
bgImageVAlign
Since v3.2
String (top, middle, bottom) Helps you to vertically align the background image.
bgImageHAlign
Since v3.2
String (left, middle, right) Helps you to horizontally align the background image.
bgImageScale
Since v3.2
Number (0-300) Helps you magnify the background image.This attribute will only work when the attribute bgImageDisplayMode is set to none, center or tile.
canvasBgColor Color Code Sets Canvas background color. For Gradient effect, enter colors separated by comma.
canvasBgAlpha Number (0-100) Sets alpha for Canvas Background. For gradient, enter alpha list separated by comma.
canvasBgRatio String Helps you specify canvas background ratio for gradients.
canvasBgAngle Number (0-360) Helps you specify canvas background angle in case of gradient.
canvasBorderColor Color Code Lets you specify canvas border color.
canvasBorderThickness Number (pixels) Lets you specify canvas border thickness.
canvasBorderAlpha Number (0-100) Lets you control transparency of canvas border.
ganttLineColor Color Code Lets you specify the color in which the grid border for the Gantt pane view will be drawn.
ganttLineAlpha Number (0-100 ) Alpha for the grid border of Gantt view pane.
gridBorderColor Color Code Color for the data grid border.
gridBorderAlpha Number (0-100) Alpha for the data grid border.
gridResizeBarColor Color Code Color for the drag line that appears when resizing the data grid.
gridResizeBarThickness Number Thickness of the drag line that appears when resizing the data grid,
gridResizeBarAlpha Number (0-100) Alpha of the drag line that appears when resizing the data grid.
taskBarRoundRadius Number If you want your task bars to be rounded (when not using percent complete feature), you can set the radius of the round corner here. That'll result in all task bars having rounded corners.
taskBarFillMix String Gradient Formula This attribute lets you specify the gradient fill formula for the task bars. Please refer to the section Advanced Charting > Using Gradients for more details on this.
taskBarFillRatio String of ratios separated by comma If you're using gradient fill formula for the task bars, this attribute lets you specify the ratio for each color in the gradient. Please refer to the section Advanced Charting > Using Gradients for more details on this.
baseFont Font face name Global font face for all text on the chart. You can individually customize font properties of each element using their respective attributes or Styles.
baseFontSize Number Global font size for all text on the chart.
baseFontColor Color Code Global font color for all text on the chart.
showShadow Boolean (0/1) Whether to show shadow for the task bars?
logoURL String You can load an external logo (JPEG/PNG/SWF) on the chart once it has rendered. This attribute lets you specify the URL of the same. Owing to Flash Player security settings, you can only specify logos that are on the sub-domain as the SWF file of the chart.
logoPosition String ( TL, TR, BL, BR, CC ) Where to position the logo on the chart:
  • TL - Top-left
  • TR - Top-right
  • BR - Bottom right
  • BL - Bottom left
  • CC - Center of screen
logoAlpha Number (0-100) Once the logo has loaded on the chart, you can configure its opacity using this attribute.
logoScale Number (0-100) You can also change the size of externally loaded logo at run-time by specifying a value for this parameter.
logoLink String If you want to link the logo to an external URL, specify the link in this attribute. The link can be in FusionCharts link format, allowing you to link to new windows, pop-ups, frames etc.
manageResize
Since v 3.2
Boolean (0/1) Setting this attribute to 1, you can allow the chart to automatically resize itself when the parent container of the chart is resized.
useEllipsesWhenOverflow
Since v 3.2
Boolean (0/1) When enabled in AUTO mode, long data labels are truncated by adding ellipses to prevent them from overflowing the chart background. The default value is 1.
showHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the vertical and horizontal hover band for both the <categories> and <processes> elements. This atrribute overrides the value of showHoverEffect attribute.

This feature is supported by JavaScript Gantt chart only.

showHoverEffect
Since v 3.3.1
Boolean (0/1) When set to 0, disables all the hover bands and hover effects all over the chart. The value of this attribute is overridden by the value of showHoverBand, showProcessHoverBand and showCategoryHoverBand attributes.

This feature is supported by JavaScript Gantt chart only.

hoverBandColor
Since v 3.3.1
Hex Color Lets you set the hover band color of both the <categories> and <processes> elements.

This feature is supported by JavaScript Gantt chart only.

hoverBandAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover band for both the <categories> and <processes> elements.

This feature is supported by JavaScript Gantt chart only.

showCategoryHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the vertical color band on mouse hover for <categories> element? The value of this attribute overrides the value showHoverEffect attribute.

This feature is supported by JavaScript Gantt chart only.

categoryHoverBandColor
Since v 3.3.1
Hex Color Lets you set the hover band color for multiple <categories> element.

This feature is supported by JavaScript Gantt chart only.

categoryHoverBandAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover band for multiple <categories> element.

This feature is supported by JavaScript Gantt chart only.

showGanttPaneVerticalHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band of Gantt pane on mouse hover for multiple <categories> element? The value of this attribute overrides the value showHoverEffect attribute.

This feature is supported by JavaScript Gantt chart only.

showProcessHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the horizontal hover band for <processes> element on mouse hover? The value of this attribute overrides the value showHoverEffect attribute.

This feature is supported by JavaScript Gantt chart only.

processHoverBandColor
Since v 3.3.1
Hex Color Lets you set the hover band color for all <processes> element.

This feature is supported by JavaScript Gantt chart only.

processHoverBandAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover band for all <processes> element.

This feature is supported by JavaScript Gantt chart only.

showGanttPaneHorizontalHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the hover bands for <processes> element of Gantt pane on mouse hover. The value of this attribute overrides the value showHoverEffect attribute.

This feature is supported by JavaScript Gantt chart only.

showConnectorHoverEffect
Since v 3.3.1
Boolean (0/1) Whether to display the mouse hover effect on connector lines.

This feature is supported by JavaScript Gantt chart only.

connectorHoverColor
Since v 3.3.1
Color Code Lets you set the hover color of the connector lines.

This feature is supported by JavaScript Gantt chart only.

connectorHoverAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover color of the connector lines.

This feature is supported by JavaScript Gantt chart only.

connectorHoverThickness
Since v 3.3.1
Number Lets you set the thickness of the connector lines after the mouse cursor hover.

This feature is supported by JavaScript Gantt chart only.

showTaskHoverEffect
Since v 3.3.1
Boolean (0/1) Whether to use the mouse hover effect of task bars.

This feature is supported by JavaScript Gantt chart only.

taskHoverFillColor
Since v 3.3.1
Boolean (0/1) Lets you set the color of task fill on mouse hover.

This feature is supported by JavaScript Gantt chart only.

taskHoverFillAlpha
Since v 3.3.1
Boolean (0/1) Lets you set the transparency of the task fill on mouse hover.

This feature is supported by JavaScript Gantt chart only.

slackHoverFillColor
Since v 3.3.1
Number Lets you set the hover color of the task bar slack. This attribute is not applicable when showSlackAsFill is set to 0.

This feature is supported by JavaScript Gantt chart only.

slackHoverFillAlpha
Since v 3.3.1
Boolean (0/1) Lets you set the transparency of the hover color of the task bar slack fill. This attribute is not applicable when showSlackAsFill is set to 0.

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

Tooltip properties

These attributes let you control the tooltip. You can set the background color, border color, separator character and few other details.

Attribute Name Type Description
showToolTip Boolean (0/1) Whether to show tooltip for the chart?
toolTipBgColor Color Code Background color for the tooltip
toolTipBorderColor Color Code Border Color for the tooltip.
dateInToolTip Boolean (0/1) Whether to show starting and ending date for each task in tooltip?
showToolTipShadow Boolean (0/1) Whether to show shadow for tooltips.
Back to top Back to Top

Legend properties

The following attributes let you configure the legend properties:

Attribute Name Type Description
showLegend Boolean (0/1) Whether to show legend for the chart?
legendCaption String Text caption for the legend.
legendBorderColor Color Code Border Color for the legend.
legendBorderThickness Number Border thickness for the legend.
legendBorderAlpha Number (0-100) Border alpha for the legend.
legendBgColor Color Code Background color for the legend.
legendBgAlpha Number (0-100) Background alpha for the legend.
legendShadow Boolean (0/1) Whether to show a shadow for legend?
legendAllowDrag Boolean (0/1) The legend can be made drag-able by setting this attribute to 1. End viewers of the chart can drag the legend around on the chart.
legendScrollBgColor Color Code If you've too many items on the legend, a scroll bar shows up on the same. This attribute lets you configure the background color of the scroll bar.
legendScrollBarColor Color Code If you've too many items on the legend, a scroll bar shows up on the same. This attribute lets you configure the bar color of the scroll bar.
legendScrollBtnColor Color Code If you've too many items on the legend, a scroll bar shows up on the same. This attribute lets you configure the color of buttons of the scroll bar.
reverseLegend Boolean (0/1) You can reverse the ordering of datasets in the legend by setting this attribute to 1.
Back to top Back to Top

Scroll bar properties

The following attributes let you configure the scroll bar properties:

Attribute Name Type Description
scrollColor Color Code Color for the scroll bar.
scrollPadding Number (Pixels) Vertical padding between the scroll bar and chart canvas.
scrollHeight Number (Pixels) Height of scroll bar.
scrollBtnWidth Number (Pixels) Width of scroll buttons.
scrollBtnPadding Number (Pixels) Horizontal padding between the scroll bar and its buttons.
Back to top Back to Top

Chart Paddings & Margins

The following attributes help you control chart margins and paddings.

You can also define the chart margins. Chart Margins refer to the empty space left on the top, bottom, left and right of the chart.

It's not necessary for you to specify any padding/margin values. FusionWidgets XT automatically assumes the best values for the same, if you do not specify the same.

Attribute Name Type Description
chartLeftMargin Number (Pixels) Amount of empty space that you want to put on the left side of your chart. Nothing is rendered in this space.
chartRightMargin Number (Pixels) Amount of empty space that you want to put on the right side of your chart. Nothing is rendered in this space.
chartTopMargin Number (Pixels) Amount of empty space that you want to put on the top of your chart. Nothing is rendered in this space.
chartBottomMargin Number (Pixels) Amount of empty space that you want to put on the bottom of your chart. Nothing is rendered in this space.
taskDatePadding Number (Pixels) Horizontal padding between the task bars and start of date labels (if you've opted to show them for the chart).
captionPadding Number (Pixels) This attribute lets you control the space (in pixels) between the sub-caption and top of the chart canvas. If the sub-caption is not defined, it controls the space between caption and top of chart canvas. If neither caption, nor sub-caption is defined, this padding does not come into play.
legendPadding Number (Pixels) Padding of legend from bottom side of canvas.
Back to top Back to Top

<categories> element
Each <categories> element represents one visual timeline on the chart. The timeline divisions are controlled by child <category> elements of <categories> element.

The following attributes of <categories> element apply to all child <category> elements, unless explicitly specified for each <category> element.

Attribute Name Type Description
bgColor Color Code Background color for each horizontal visual date line.
bgAlpha Number (0-100) Background alpha for each horizontal visual date line.
font Font Face Font for this category.
fontSize Number Font size for this category.
fontColor Color Code Font color for this category.
isBold Boolean (0/1) Whether to render font as bold for this category?
isItalic Boolean (0/1) Whether to render font as italic for this category?
isUnderline Boolean (0/1) Whether to render font as underline for this category?
verticalPadding Number (pixels) Vertical padding for the category line - both top & bottom.
align left, center or right Horizontal alignment position of category labels.
vAlign top, middle or bottom Vertical alignment position of category labels.
showHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band on mouse hover.

This feature is supported by JavaScript Gantt chart only.

showGanttPaneHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band of Gantt pane on mouse hover.

This feature is supported by JavaScript Gantt chart only.

hoverBandColor
Since v 3.3.1
Color Code When you hover the mouse cursor over any category, you'll see a colored band moving with the mouse. This attribute lets you set the hover color of that band.

This feature is supported by JavaScript Gantt chart only.

hoverBandAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover band.

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

<category> element

Each <category> element distributes the time line into visual divisions. You can specify the following attributes for the same.

Attribute Name Type Description
start Date/Time in the formats specified Start date/time for this category. Needs to be specified in the date/time formats for the chart.
end Date/Time in the formats specified End date/time for this category. Needs to be specified in the date/time formats for the chart.
bgColor Color Code Background color for this category division.
bgAlpha Number (0-100) Background alpha for this category division.
label String Label for the category. You can specify any text label to be displayed as the category label.
link Link in FusionCharts format Each category label can be linked to an external URL. You need to provide the URL in FusionCharts Link format.
align left, center or right Horizontal alignment position of the label.
vAlign top, middle or bottom Vertical alignment position of the label.
isBold Boolean (0/1) Whether this label will appear as bold?
isItalic Boolean (0/1) Whether this label will appear as italic?
isUnderline Boolean (0/1) Whether this label will appear as underlined?
font Font face Font face for the label.
fontSize Font size Font size for the label.
fontColor Color Code Font color for the label.
showHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band on mouse hover.

This feature is supported by JavaScript Gantt chart only.

showGanttPaneHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band of Gantt pane on mouse hover.

This feature is supported by JavaScript Gantt chart only.

hoverBandColor
Since v 3.3.1
Color Code When you hover the mouse cursor over any category, you'll see a colored band moving with the mouse. This attribute lets you set the hover color of that band.

This feature is supported by JavaScript Gantt chart only.

hoverBandAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the color band.

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

<processes> element

All the processes for the chart are grouped under the <processes> element. Each process is represented by an individual <process> element.

The following attributes of <processes> element let you collectively specify cosmetic properties for each <process> element. You can also over-ride these properties by specifying the same for each <process> element.

Attribute Name Type Description
positionInGrid left or right Whether the process column appears as the left-most column of data grid or right-most?
width Number or percent Width of the process column in data table. You can either specify it as exact pixels (e.g. 150 or 200) or in percentage (25% or 30%)
The processes column can have a header, whose properties can be customized using the attributes below.
headertext String Header label for the processes column in data table.
headerFont Font face Font for the process header
headerFontSize Number Font size for the process header
headerFontColor Color Code Font color for the process header
headerIsBold Boolean (0/1) Whether process header should appear bold?
headerIsItalic Boolean (0/1) Whether process header should appear in italics?
headerIsUnderline Boolean (0/1) Whether process header should appear as underlined?
headerAlign left, center or right Horizontal alignment position of the header label.
headerVAlign top, middle or bottom Vertical alignment position of the header label.
headerBgColor Color Code Background color of the process header.
headerBgAlpha Number (0-100) Background alpha of the process header.
The following properties allow you to collectively specify cosmetics for all <process> elements, which can further be specified for each <process> element.
bgColor Color Code Background color for the process name column.
bgAlpha Number (0-100) Background alpha for the process name column.
font Font Face Font for process name.
fontSize Number Font size for process name.
fontColor Color Code Font color for process name.
isBold Boolean (0/1) Whether to show process names in bold?
isItalic Boolean (0/1) Whether to show process names in italics?
isUnderline Boolean (0/1) Whether to show process names as underline?
align left, center or right Horizontal alignment for all process names.
vAlign top, middle or bottom Vertical alignment for all process names.
showHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band on mouse hover.

This feature is supported by JavaScript Gantt chart only.

showGanttPaneHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band of Gantt pane on mouse hover.

This feature is supported by JavaScript Gantt chart only.

hoverBandColor
Since v 3.3.1
Color Code When you hover the mouse cursor over any process, you'll see a colored band moving with the mouse. This attribute lets you set the hover color of that band.

This feature is supported by JavaScript Gantt chart only.

hoverBandAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the color band.

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

<process> element

Each <process> element represents one process on the Gantt chart. You can show team members, projects or task list as a process - there's no restriction to that.

Attribute Name Type Description
label String The label for the process.
link Link in FusionCharts format Each process label can be linked to external links. You can specify the link for each process in FusionCharts link format as value of this attribute.
id String String ID for the process. Each process needs to have a unique identifier to enable cross linking with tasks.
font Font face Font face for this process label.
fontColor Color Code Font color for this process label.
fontSize Font Size Font size for this process label.
isBold Boolean (0/1) Whether to show this process name in bold?
isItalic Boolean (0/1) Whether to show this process name in italics?
isUnderline Boolean (0/1) Whether to show this process name as underline?
align left, center or right Horizontal alignment position for the process name.
vAlign top, middle or bottom Vertical alignment position for the process name.
bgColor Color Code Background color for the process name.
bgAlpha Number (0-100) Background alpha for the process name.
showHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band on mouse hover.

This feature is supported by JavaScript Gantt chart only.

showGanttPaneHoverBand
Since v 3.3.1
Boolean (0/1) Whether to show the color band of Gantt pane on mouse hover.

This feature is supported by JavaScript Gantt chart only.

hoverBandColor
Since v 3.3.1
Color Code When you hover the mouse cursor over any process, you'll see a colored band moving with the mouse. This attribute lets you set the hover color of that band.

This feature is supported by JavaScript Gantt chart only.

hoverBandAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the color band.

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

<tasks> element

The <tasks> element groups all the tasks that we've to show in the chart. Each task is represented by a <task> element which is a child of <tasks> element.

Attribute Name Type Description
showlabels Boolean (0/1) Whether to show the label for each task (if defined)?
showpercentlabel Boolean (0/1) If percent complete has been defined for each task, whether to show the same as part of label?
showstartdate Boolean (0/1) Whether to show start date for each task?
showenddate Boolean (0/1) Whether to show end date for each task?
font Font face Font for all the task labels.
fontcolor Color Code Font color for all the task labels.
fontsize Number Font size for all the task labels.
color Color Code Fill color for the task bars. This color is manipulated by the task fill gradient formula to attain the required gradient.
alpha Number (0-100) Alpha for the task bar fill.
showborder Boolean (0/1) Whether to show border for task bars?
bordercolor Color Code If border is to be shown for task bars, this attribute defines the color.
borderthickness Number If border is to be shown for task bars, this attribute defines the thickness.
borderalpha Number (0-100) If border is to be shown for task bars, this attribute defines the alpha.
showHoverEffect
Since v 3.3.1
Boolean (0/1) Whether to use the mouse hover effect?

This feature is supported by JavaScript Gantt chart only.

hoverFillColor
Since v 3.3.1
Color Code Lets you set the hover color of the task bars.

This feature is supported by JavaScript Gantt chart only.

hoverFillAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover color for the task bars.

This feature is supported by JavaScript Gantt chart only.

slackFillColor
Since v 3.3.1
Color Code Lets you set the color of the task bar slack.

This feature is supported by JavaScript Gantt chart only.

slackHoverFillColor
Since v 3.3.1
Number Lets you set the hover color of the task bar slack fill.

This feature is supported by JavaScript Gantt chart only.

slackHoverFillAlpha
Since v 3.3.1
Boolean (0/1) Lets you set the transparency of the hover color of the task bar slack fill.

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

<task> element

Each <task> element represents a task bar on the chart and can have the following properties:

Attribute Name Type Description
start Date/time in the formats specified Start date for the task in the date/time formats specified in XML.
end Date in the formats specified End date for the task in the date/time formats specified in XML.
id String identifier Each task can have its own unique ID. It is used for linking connectors and milestones.
processId String identifier You can relate each task to its process using the process ID, which can be specified here.
label String String label for the task.
link Link in FusionCharts format Link for the task bar (in FusionCharts link format)
percentComplete Number (0-100) Each task can be shown as incomplete task by specifying the percent completed here.
showAsGroup Boolean (0/1) Whether to render the task bar visually as a group?
animation Boolean (0/1) Whether to animate this particular bar?
font Font face Font for the task label.
fontColor Color Code Font color for the task label.
fontSize Number Font size for the task label.
color Color Code Fill color for the task bar. This color is manipulated by the task fill gradient formula to attain the required gradient.
alpha Number (0-100) Fill alpha for the task bar.
showBorder Boolean (0/1) Whether to show border for the task bar?
borderColor Color Code Border color for the task bar.
borderThickness Number Border thickness for the task bar.
borderAlpha Number (0-100) Border alpha for the task bar.
height In Pixels or Percent Height for the task bar either in pixels (e.g., 30 or 25) or in percent (e.g., 25% or 50%)
topPadding In Pixels or percent Padding required at the top of the task bar either in pixels or in percent.
showLabel Boolean (0/1) Whether to show the label for this task bar?
showPercentLabel Boolean (0/1) Whether to include percent complete in the label for this task bar?
showStartDate Boolean (0/1) Whether to show start date for the task bar?
showEndDate Boolean (0/1) Whether to show end date label for the task bar?
toolText String If you want to have custom tool text for each task bar, you can specify it here.
showHoverEffect
Since v 3.3.1
Boolean (0/1) Whether to use the mouse hover effect?

This feature is supported by JavaScript Gantt chart only.

hoverFillColor
Since v 3.3.1
Color Code Lets you set the hover color of individual task bar.

This feature is supported by JavaScript Gantt chart only.

hoverFillAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover color for individual task bar.

This feature is supported by JavaScript Gantt chart only.

slackHoverFillColor
Since v 3.3.1
Number Lets you set the hover color of slack fill for individual task bar.

This feature is supported by JavaScript Gantt chart only.

slackHoverFillAlpha
Since v 3.3.1
Boolean (0/1) Lets you set the transparency of the hover color of slack fill for individual task bar.

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

<datatable> element

The <datatable> element lets you add your own data to the data-grid of the chart.

The following attributes of <datatable> element help you collectively control the cosmetics of each cell within the table. You can, however, control the properties of individual cell using attributes of <datacolumn> element or individual <text> element.

Attribute Name Type Description
headerFont Font face Font face for all column headers in the data table.
headerFontSize Number Font size for all column headers in the data table.
headerFontColor Color Code Font color for all column headers in the data table.
headerIsBold Boolean (0/1) Whether header should appear bold for all column headers in the data table?
headerIsItalic Boolean (0/1) Whether header should appear in italics for all column headers in the data table?
headerIsUnderline Boolean (0/1) Whether header should appear in underline for all column headers in the data table?
headerAlign left, center or right Horizontal alignment position for all column headers in the data table.
headerVAlign top, middle or bottom Vertical alignment position for all column headers in the data table.
headerBgColor Color Code Background color for all column headers in the data table.
headerBgAlpha Number (0-100) Background alpha for all column headers in the data table.
The following attributes let you collectively specify the cosmetic properties for all the cells in data table.
bgColor Color Code Background color for all the cells in the data table.
bgAlpha Number (0-100) Background alpha for all the cells in the data table.
font Font face Font for all the cells in the data table.
fontColor Color Code Font color for all the cells in the data table.
fontSize Number Font size for all the cells in the data table.
isBold Boolean (0/1) Whether to show text in bold for all the cells in the data table?
isItalic Boolean (0/1) Whether to show text in italics for all the cells in the data table?
isUnderline Boolean (0/1) Whether to show text as underline for all the cells in the data table?
align left, center or right Horizontal alignment position for all the cells in the data table.
vAlign top, middle or bottom Vertical alignment position for all the cells in the data table.
Back to top Back to Top

<datacolumn> element

Each <datacolumn> element adds a column to the chart's data grid. It can have the following elements:

Attribute Name Type Description
headerText String Label for the header.
headerLink Link in FusionCharts format Link for the header.
headerFont Font face Font face for the column header.
headerFontSize Number Font size for the column header.
headerFontColor Color Code Font color for the column header.
headerIsBold Boolean (0/1) Whether header should appear bold for the column header?
headerIsItalic Boolean (0/1) Whether header should appear in italics for the column header?
headerIsUnderline Boolean (0/1) Whether header should appear in underline the column header?
headerAlign left, center or right Horizontal alignment position for the column header.
headerVAlign top, middle or bottom Vertical alignment position for the column header.
headerBgColor Color Code Background color for the column header.
headerBgAlpha Number (0-100) Background alpha for the column header.
The following attributes let you collectively specify the cosmetic properties for all the cells in this column.
width Number or percent Width of this column in number (100 or 200) or percent (25% or 45%)
bgColor Color Code Background color for all the cells in this data column.
bgAlpha Number (0-100) Background alpha for all the cells in this data column.
font Font face Font for all the cells in this data column.
fontColor Color Code Font color for all the cells in this data column.
fontSize Number Font size for all the cells in this data column.
isBold Boolean (0/1) Whether to show text in bold for all the cells in this data column?
isItalic Boolean (0/1) Whether to show text in italics for all the cells in this data column?
isUnderline Boolean (0/1) Whether to show text as underline for all the cells in this data column?
align left, center or right Horizontal alignment position for all the cells in this data column.
vAlign top, middle or bottom Vertical alignment position for all the cells in this data column.
Back to top Back to Top

<text> element

Each <text> element, child of <datacolumn> element, represents a single cell in the data column. It can have the following attributes:

Attribute Name Type Description
label String String label to be displayed in the cell.
link Link in FusionCharts format Link for the label.
bgColor Color Code Background color for the cell.
bgAlpha Number (0-100) Background alpha for the cell.
font Font face Font for the cell.
fontColor Color Code Font color for the cell.
fontSize Number Font size for the cell.
isBold Boolean (0/1) Whether to show text in bold?
isItalic Boolean (0/1) Whether to show text in italics?
isUnderline Boolean (0/1) Whether to show text as underline?
align left, center or right Horizontal alignment position of the label.
vAlign top, middle or bottom Vertical alignment position of the label.
Back to top Back to Top

<connectors> element

The following attributes specify the cosmetics for all the connectors collectively:

Attribute Name Type Description
color Color Code Color for the connector line.
alpha Number (0-100) Alpha of the connector lines.
thickness Number Thickness of the connector lines.
isDashed Boolean (0/1) Whether to plot the lines as dash?
hoverColor
Since v 3.3.1
Color Code Lets you set the hover color of the connector lines.

This feature is supported by JavaScript Gantt chart only.

hoverAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover color for the connector lines.

This feature is supported by JavaScript Gantt chart only.

hoverThickness
Since v 3.3.1
Number Lets you set the thickness of the hover effect for the connector lines.

This feature is supported by JavaScript Gantt chart only.

showHoverEffect
Since v 3.3.1
Boolean (0/1) Whether to use the mouse hover effect?

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

<connector> element

Each <connector> element represents a connector that connects two tasks. You can specify the following properties for it:

Attribute Name Type Description
fromTaskId String ID ID of the task which will act as the starting point for connector. You'll need to define IDs for each task before you can define connectors.
toTaskId String ID ID of the task which will act as the ending point for connector.
fromTaskConnectStart Boolean (0/1) Whether to connect left side of the starting task bar?
toTaskConnectStart Boolean (0/1) Whether to connect left side of the ending task bar?
color Color Code Color of the connector.
thickness Number Thickness of the connector.
alpha Number (0-100) Alpha of the connector line.
isDashed Boolean (0/1) Whether to show connector line as dashed?
hoverColor
Since v 3.3.1
Color Code Lets you set the hover color of individual connector line.

This feature is supported by JavaScript Gantt chart only.

hoverAlpha
Since v 3.3.1
Number (0-100) Lets you set the transparency of the hover color for individual connector line.

This feature is supported by JavaScript Gantt chart only.

hoverThickness
Since v 3.3.1
Number Lets you set the thickness of the hover effect of individual connector line.

This feature is supported by JavaScript Gantt chart only.

showHoverEffect
Since v 3.3.1
Boolean (0/1) Whether to use the mouse hover effect?

This feature is supported by JavaScript Gantt chart only.

Link
Since v 3.3.1
String Lets you set links for individual connector items.

This feature is supported by JavaScript Gantt chart only.

Back to top Back to Top

<milestones> --> <milestone> element

Milestones visually depict any crucial dates on the chart. You can create your own milestones on the chart based on date and task i.e., for a given task you can specify milestones on specific dates. You can also add tool text and link for the milestone. You can customize all the visual properties of the milestone including shape (star or polygon), size and colors. The following attributes help you to achieve these:

Attribute Name Type Description
date Date Date for the milestone in the specified date format.
taskId String ID ID of the task to which this milestone relates to. You must define task IDs before you can use milestones.
shape star or polygon Shape of the milestone.
numSides Number (3-15) Number of sides that the milestone should have.
startAngle Number (0-360) Starting angle for the star/polygon.
radius Number (2-15) Radius for the milestone (in pixels).
color Color Code Color for the milestone.
alpha Number (0-100) Alpha for the milestone.
borderColor Color Code Border color for the milestone.
borderThickness Number Border thickness for the milestone.
link Link in FusionCharts format Each milestone can be linked to external links. The link should be specified in FusionCharts link format.
toolText String Each milestone can have its own tool text, which you can specify here.
Back to top Back to Top

<trendlines> --> <line> element

Using the <trendLines> element (and children <line> elements), you can define trend lines on the chart.

Trend lines are horizontal lines spanning the chart canvas which aid in interpretation of data with respect to some pre-determined value. For example, if you are plotting sales data of current year, you might want to add previous year's average monthly sales as trend indicator for ease of comparison.

For each trend line on the chart, you need to define a <line> element under <trendLines> element as under:

<trendLines>
  <line startValue='895' color='FF0000' displayValue='Average' />
</trendLines>

You can control the cosmetic and functional properties of trend-lines using the following attributes:

Attribute Name Type Description
start Date/Time in the formats specified Start date/time for the trend line/zone.
end Date/Time in the formats specified End date for the trend line/zone. If you intend to draw a trend line instead of a trend zone, then you do not need to specify a value for this attribute.
color Color Code Color for the trend line/zone.
displayValue String If you want to display your custom value beneath the trend line, you can do so here. Example, you can show the trend line and label it as "Today".
thickness Number Thickness of the trend line.
isTrendZone Boolean (0/1) Option to set whether it will appear as a trend zone or a trend line.
alpha Number (0-100) Alpha of the trend line.
dashed Boolean (0/1) Whether to show the trend line as dashed?
dashLen Number (1-10) If it is to be shown as dashed, this attribute lets you define the length of each dash.
dashGap Number (1-10) If it is to be shown as dashed, this attribute lets you define the length of each dash gap.
Back to top Back to Top

<legend> --> <item> element

The properties used in the <item> element are mentioned below:

Attribute Name Type Description
label String Label for the legend item.
color Color Code Color code for the legend item.
Back to top Back to Top
 

The XML API for the following features have not been discussed here:

  • Exporting Chart: All the attributes pertinent to exporting of charts as images or PDFs are discussed in the Exporting as Image/PDF section.
  • Exporting Chart Data: All the attributes pertinent to exporting of chart data are discussed in the Exporting Chart Data section.
  • Styles - All the attributes pertinent to Styles are discussed in the Using Styles section.