Chart Attributes

Area 2D
Bar 2D
Bar 3D
Box and Whisker 2D
Bubble Chart
Candlestick Chart
Chord
Column 2D
Column 3D
Doughnut 2D
Doughnut 3D
Drag Node Chart
Drag-able Area 2D Chart
Drag-able Column 2D Chart
Drag-able Line 2D Chart
Error Bar Chart
Error Line 2D Chart
Error Scatter Chart
Funnel Chart
Gantt Chart
Heat Map Chart
Horizontal Bullet Graph
Horizontal LED
Inverse Y-axis Area Chart
Inverse Y-axis Column 2D Chart
Inverse Y-axis Line 2D Chart
Kagi Chart
Line 2D
Logarithmic Column 2D Chart
Logarithmic Line 2D Chart
Marimekko
Multi-axis Line Chart
Multi-level Pie Chart
Multi-series 2D Dual Y Combination Chart (Column + Line + Area + Spline)
Multi-series 2D Single Y Combination Chart (Column + Line + Area + Spline)
Multi-series 3D Dual Y Combination Chart (Column + Line + Area + Spline)
Multi-series 3D Single Y Combination Chart (Column + Line + Area + Spline)
Multi-series Area 2D
Multi-series Bar 2D
Multi-series Bar 3D
Multi-series Column 2D
Multi-series Column 3D
Multi-series Column 3D + Line Dual Y Axis
Multi-series Column 3D + Line Single Y-axis
Multi-series Line 2D
Multi-series Spline
Multi-series Spline Area
Multi-series Stacked Bar 2D
Multi-series Stacked Column 2D
Multi-series Stacked Column 2D + Line Dual Y Axis
Overlapped Column 2D
Overlapped Bar 2D
Pareto 2D
Pareto 3D
Pie 2D
Pie 3D
Pyramid Chart
Radar Chart
Radial Bar Chart
Real-time Angular
Real-time Area
Real-time Bulb
Real-time Column
Real-time Cylinder
Real-time Horizontal Linear
Real-time Line
Real-time Line (Dual Y)
Real-time Stacked Area
Real-time Stacked Column
Real-time Thermometer
Sankey Diagram
Scatter Chart
Scroll Area 2D
Scroll Bar 2D
Scroll Column 2D
Scroll Combination 2D (Dual Y)
Scroll Combination 2D (Single Y)
Scroll Line 2D
Scroll Multi-series Stacked Column 2D
Scroll Multi-series Stacked Column 2D + Line (Dual Y)
Scroll Stacked Bar 2D
Scroll Stacked Column 2D
Select-scatter Chart
Single-series Spline 2D
Single-series Spline Area 2D
Spark Column
Spark Line
Spark Win/Loss
Stacked 2D Column + Line Single Y-axis
Stacked 3D Column + Line Single Y-axis
Stacked Area 2D
Stacked Area 2D Line Dual Y-axis Chart
Stacked Bar 2D
Stacked Bar 3D
Stacked Column 2D
Stacked Column 2D Line Dual Y-axis Chart
Stacked Column 3D
Stacked Column 3D + Line Dual Y Axis
Step Line Charts
Sunburst
Tree Map Chart
Vertical Bullet Graph
Vertical LED
Waterfall / Cascade Chart
Zoom Line
Zoom Line Dual Y-axis
Zoom Scatter

json
xml

{
    "chart": {
        "caption": "Split of Top Products Sold",
        "subCaption": "Last Quarter",
        "basefontsize": "9",
        "pieFillAlpha": "60",
        "pieBorderThickness": "2",
        "hoverFillColor": "#cccccc",
        "pieBorderColor": "#ffffff",
        "showPercentInTooltip": "0",
        "numberPrefix": "$",
        "plotTooltext": "$label, $$valueK, $percentValue",
        "theme": "fusion"
    },
    "category": [
        {
            "label": "Sales by category",
            "color": "#ffffff",
            "value": "150",
            "category": [
                {
                    "label": "Food & {br}Beverages",
                    "color": "#f8bd19",
                    "value": "55.5",
                    "category": [
                        {
                            "label": "Breads",
                            "color": "#f8bd19",
                            "value": "11.1"
                        },
                        {
                            "label": "Juice",
                            "color": "#f8bd19",
                            "value": "27.75"
                        },
                        {
                            "label": "Noodles",
                            "color": "#f8bd19",
                            "value": "9.99"
                        },
                        {
                            "label": "Seafood",
                            "color": "#f8bd19",
                            "value": "6.66"
                        }
                    ]
                },
                {
                    "label": "Apparel &{br}Accessories",
                    "color": "#e44a00",
                    "value": "42",
                    "category": [
                        {
                            "label": "Sun Glasses",
                            "color": "#e44a00",
                            "value": "10.08"
                        },
                        {
                            "label": "Clothing",
                            "color": "#e44a00",
                            "value": "18.9"
                        },
                        {
                            "label": "Handbags",
                            "color": "#e44a00",
                            "value": "6.3"
                        },
                        {
                            "label": "Shoes",
                            "color": "#e44a00",
                            "value": "6.72"
                        }
                    ]
                },
                {
                    "label": "Baby {br}Products",
                    "color": "#008ee4",
                    "value": "22.5",
                    "category": [
                        {
                            "label": "Bath &{br}Grooming",
                            "color": "#008ee4",
                            "value": "9.45"
                        },
                        {
                            "label": "Feeding",
                            "color": "#008ee4",
                            "value": "6.3"
                        },
                        {
                            "label": "Diapers",
                            "color": "#008ee4",
                            "value": "6.75"
                        }
                    ]
                },
                {
                    "label": "Electronics",
                    "color": "#33bdda",
                    "value": "30",
                    "category": [
                        {
                            "label": "Laptops",
                            "color": "#33bdda",
                            "value": "8.1"
                        },
                        {
                            "label": "Televisions",
                            "color": "#33bdda",
                            "value": "10.5"
                        },
                        {
                            "label": "SmartPhones",
                            "color": "#33bdda",
                            "value": "11.4"
                        }
                    ]
                }
            ]
        }
    ]
}

<chart caption="Split of Top Products Sold" subcaption="Last Quarter" basefontsize="9" piefillalpha="60" pieborderthickness="2" hoverfillcolor="#cccccc" piebordercolor="#ffffff" showpercentintooltip="0" numberprefix="$" plottooltext="$label, $$valueK, $percentValue" theme="fusion">
    <category label="Sales by category" color="#ffffff" value="150">
        <category label="Food &amp; {br}Beverages" color="#f8bd19" value="55.5">
            <category label="Breads" color="#f8bd19" value="11.1" />
            <category label="Juice" color="#f8bd19" value="27.75" />
            <category label="Noodles" color="#f8bd19" value="9.99" />
            <category label="Seafood" color="#f8bd19" value="6.66" /></category>
        <category label="Apparel &amp;{br}Accessories" color="#e44a00" value="42">
            <category label="Sun Glasses" color="#e44a00" value="10.08" />
            <category label="Clothing" color="#e44a00" value="18.9" />
            <category label="Handbags" color="#e44a00" value="6.3" />
            <category label="Shoes" color="#e44a00" value="6.72" /></category>
        <category label="Baby {br}Products" color="#008ee4" value="22.5">
            <category label="Bath &amp;{br}Grooming" color="#008ee4" value="9.45" />
            <category label="Feeding" color="#008ee4" value="6.3" />
            <category label="Diapers" color="#008ee4" value="6.75" /></category>
        <category label="Electronics" color="#33bdda" value="30">
            <category label="Laptops" color="#33bdda" value="8.1" />
            <category label="Televisions" color="#33bdda" value="10.5" />
            <category label="SmartPhones" color="#33bdda" value="11.4" /></category>
    </category>
</chart>

Functional Attributes

These attributes let you control a variety of functional elements on the chart.

chart : {

animation : Boolean [+]

This attribute lets you set the configuration whether the chart should appear in an animated fashion. If you do not want to animate any part of the chart, set this as 0.

Range: 0/1

animationDuration : Number [+]

This attribute sets the animation duration of the chart. animationDuration attribute is applicable only if animation of the chart is enabled.

Default value: 1 sec

Range: In seconds

palette : Number [+]

Each chart has 5 pre-defined color palettes which you can choose from. Each palette renders the chart in a different color theme.

Range: 1-5

clickURL : String [+]

The entire chart can now act as a hotspot. Use this URL to define the hotspot link for the chart. The link can be specified in FusionCharts Link Format.

clickURLOverridesPlotLinks : Boolean [+] 3.7.0

Sets whether the clickURL attribute (that sets a link to which the user is directed when the chart is clicked) overrides the link attribute (that sets a link to which the user is directed when a data plot is clicked).

Default value: 0 (clickURL does not override link)

Range: 0/1

paletteColors : String [+]

While the palette attribute allows to select a palette theme that applies to chart background, canvas, font and tool-tips, it does not change the colors of data items (that is, column, line, pie etc.). Using paletteColors attribute, you can specify your custom list of hex colors for the data items. The list of colors have to be separated by comma. For example, "paletteColors": "#FF0000, #0372AB, #FF5904...". The chart will cycle through the list of specified colors and then render the data plot accordingly. To use the same set of colors throughout all your charts in a web application, you can store the list of palette colors in your application globally and then provide the same in each chart JSON.

Range: List of hex color codes separated by comma

showPrintMenuItem : Boolean [+]

When you right click on the chart it shows a context menu. This attribute allows you to show or hide the "Print" option in the context menu.

Range: 0/1

unescapeLinks : Boolean [+]

Internally the chart decodes a Url that you set as link. Before invoking the link it again encodes the Url. If you are passing multilingual characters via a Url or do not want this decode-encode mechanism to be handled by chart you can set,unescapeLinks='0'.

Range: 0/1

showLabels : Boolean [+]

Allows you to show or hide the labels on the chart.

Range: 0/1

showValues : Boolean [+] 3.2.1

Allows you to show or hide the values on the chart.

Range: 0/1

showValuesInTooltip : Boolean [+] 3.2.1

Allows you to show the values of the chart in the tooltip.

Range: 0/1

showPercentValues : Boolean [+] 3.2.1

Allows you to show the values as percentage on the chart.

Range: 0/1

showPercentInTooltip : Boolean [+] 3.2.1

Allows you to show the percentage values of the chart in tooltip.

Range: 0/1

hasRTLText : Number [+] 3.7.0

This attribute, when set to 1, indicates to the chart that the text (rendered on the chart) may contain RTL characters and the textual display has to be managed accordingly.

theme : String [+]

This attribute changes the theme of the chart. There are 7 types of themes which have been made according to the different color combinations.

Range: 'fusion', 'gammel', 'candy', 'ocean', 'zune', 'carbon', 'umber'

}

These attributes let you set and configure custom chart messages, using text as well as images. These attributes are supported in FusionCharts constructor (FusionCharts({ })).

FusionCharts : {

baseChartMessageFont : String [+] 3.5.0

This attribute allows to set a custom font for all chart messages.

baseChartMessageFontSize : Number [+] 3.5.0

This attribute allows to set a custom font size for all chart messages.

Range: In pixels

baseChartMessageColor : Color [+] 3.5.0

This attribute allows to set a custom font color for all chart messages.

Range: Hex Color Code

baseChartMessageImageHAlign : String [+] 3.7.0

This attribute allows to set a custom horizontal alignment for all images displayed as chart messages.

Default value: middle

Range: left, middle, right

baseChartMessageImageVAlign : String [+] 3.7.0

This attribute allows to set a custom vertical alignment for all images displayed as chart messages.

Default value: middle

Range: top, middle, bottom

baseChartMessageImageAlpha : Number [+] 3.7.0

This attribute allows to set a transparency for all images displayed as chart messages.

Default value: 100

Range: 0 - 100

baseChartMessageImageScale : Number [+] 3.7.0

This attribute allows to set a scale for magnifying all images displayed as chart messages.

Default value: 100

Range: 0-300

loadMessage : String [+] 3.7.0

This attribute allows to set the message to be displayed when a chart begins to load. To display an image as the chart message, prefix I- to the image URL.

loadMessageFont : String [+] 3.5.0

This attribute allows to set the font for the message displayed when a chart begins to load.

Range: Font Name

loadMessageFontSize : Number [+] 3.5.0

This attribute allows to set the font size for the message displayed when a chart begins to load.

Range: In pixels

loadMessageColor : Color [+] 3.5.0

This attribute allows to set the font color for the message displayed when a chart begins to load.

Range: Hex Color Code

loadMessageImageHAlign : String [+] 3.7.0

If an image is displayed as the chart loadMessage, this attribute allows to set a custom horizontal alignment for the image.

Default value: value assigned to the baseChartMessageImageHAlign attribute

Range: left, middle, right

loadMessageImageVAlign : String [+] 3.7.0

If an image is displayed as the chart loadMessage, this attribute allows to set a custom vertical alignment for the image.

Default value: value assigned to the baseChartMessageImageVAlign attribute

Range: top, middle, bottom

loadMessageImageAlpha : Number [+] 3.7.0

If an image is displayed as the chart loadMessage, this attribute allows to set the transparency of the image.

Default value: 100

Range: 0 - 100

loadMessageImageScale : Number [+] 3.7.0

If an image is displayed as the chart loadMessage, this attribute allows to set the scale for magnifying the image.

Default value: 100

Range: 0-300

typeNotSupportedMessage : String [+] 3.7.0

This attribute allows to set the message to be displayed when the specified chart type is not supported. To display an image as the chart message, prefix I- to the image URL.

typeNotSupportedMessageFont : String [+] 3.5.0

This attribute allows to set the font for the message displayed when the specified chart type is not supported.

Range: Font Name

typeNotSupportedMessageFontSize : Number [+] 3.5.0

This attribute allows to set the font size for the message displayed when the specified chart type is not supported.

Range: In pixels

typeNotSupportedMessageColor : Color [+] 3.5.0

This attribute allows to set the font color for the message displayed when the specified chart type is not supported.

Range: Hex Color Code

typeNotSupportedMessageImageHAlign : String [+] 3.7.0

If an image is displayed as the chart typeNotSupportedMessage, this attribute allows to set a custom horizontal alignment for the image.

Default value: value assigned to the baseChartMessageImageHAlign attribute

Range: left, middle, right

typeNotSupportedMessageImageVAlign : String [+] 3.7.0

If an image is displayed as the chart typeNotSupportedMessage, this attribute allows to set a custom vertical alignment for the image.

Default value: value assigned to the baseChartMessageImageVAlign attribute

Range: top, middle, bottom

typeNotSupportedMessageImageAlpha : Number [+] 3.7.0

If an image is displayed as the chart typeNotSupportedMessage, this attribute allows to set the transparency of the image.

Default value: 100

Range: 0 - 100

typeNotSupportedMessageImageScale : Number [+] 3.7.0

If an image is displayed as the chart typeNotSupportedMessage, this attribute allows to set the scale for magnifying the image.

Default value: 100

Range: 0-300

renderErrorMessage : String [+] 3.7.0

This attribute allows to set the message to be displayed if an error is encountered while rendering the chart. To display an image as the chart message, prefix I- to the image URL.

renderErrorMessageFont : String [+] 3.5.0

This attribute allows to set a font for the message displayed if an error is encountered while rendering the chart.

Range: Font Name

renderErrorMessageFontSize : Number [+] 3.5.0

This attribute allows to set the font size for the message displayed if an error is encountered while rendering the chart.

Range: In pixels

renderErrorMessageColor : Color [+] 3.5.0

This attribute allows to set the font color for the message displayed if an error is encountered while rendering the chart.

Range: Hex Color Code

renderErrorMessageImageHAlign : String [+] 3.7.0

If an image is displayed as the chart renderErrorMessage, this attribute allows to set a custom horizontal alignment for the image.

Default value: value assigned to the baseChartMessageImageHAlign attribute

Range: left, middle, right

renderErrorMessageImageVAlign : String [+] 3.7.0

If an image is displayed as the chart renderErrorMessage, this attribute allows to set a custom vertical alignment for the image.

Default value: value assigned to the baseChartMessageImageVAlign attribute

Range: top, middle, bottom

renderErrorMessageImageAlpha : Number [+] 3.7.0

If an image is displayed as the chart renderErrorMessage, this attribute allows to set the transparency of the image.

Default value: 100

Range: 0 - 100

renderErrorMessageImageScale : Number [+] 3.7.0

If an image is displayed as the chart renderErrorMessage, this attribute allows to set the scale for magnifying the image.

Default value: 100

Range: 0-300

dataLoadStartMessage : String [+] 3.7.0

This attribute allows to set the message to be displayed when chart data begins loading. To display an image as the chart message, prefix I- to the image URL.

dataLoadStartMessageFont : String [+] 3.5.0

This attribute allows to set a font for the message displayed when chart data begins loading.

Range: Font Name

dataLoadStartMessageFontSize : String [+] 3.5.0

This attribute allows to set the font size for the message displayed when chart data begins loading.

Range: In pixels

dataLoadStartMessageColor : Color [+] 3.5.0

This attribute allows to set the font color for the message displayed when chart data begins loading.

Range: Hex Color Code

dataLoadStartMessageImageHAlign : String [+] 3.7.0

If an image is displayed as the chart dataLoadStartMessage, this attribute allows to set a custom horizontal alignment for the image.

Default value: value assigned to the baseChartMessageImageHAlign attribute

Range: left, middle, right

dataLoadStartMessageImageVAlign : String [+] 3.7.0

If an image is displayed as the chart dataLoadStartMessage, this attribute allows to set a custom vertical alignment for the image.

Default value: value assigned to the baseChartMessageImageVAlign attribute

Range: top, middle, bottom

dataLoadStartMessageImageAlpha : Number [+] 3.7.0

If an image is displayed as the chart dataLoadStartMessage, this attribute allows to set the transparency of the image.

Default value: 100

Range: 0 - 100

dataLoadStartMessageImageScale : Number [+] 3.7.0

If an image is displayed as the chart dataLoadStartMessage, this attribute allows to set the scale for magnifying the image.

Default value: 100

Range: 0-300

dataEmptyMessage : String [+] 3.7.0

This attribute allows to set the message to be displayed if the data loaded for a chart is empty. To display an image as the chart message, prefix I- to the image URL.

dataEmptyMessageFont : String [+] 3.5.0

This attribute allows to set the font for the message displayed if the data loaded for a chart is empty

Range: Font Name

dataEmptyMessageFontSize : Number [+] 3.5.0

This attribute allows to set the font size for the message displayed if the data loaded for a chart is empty.

Range: In pixels

dataEmptyMessageColor : Color [+] 3.5.0

This attribute allows to set the font color for the message displayed if the data loaded for a chart is empty.

Range: Hex Color Code

dataEmptyMessageImageHAlign : String [+] 3.7.0

If an image is displayed as the chart dataEmptyMessage, this attribute allows to set a custom horizontal alignment for the image.

Default value: value assigned to the baseChartMessageImageHAlign attribute

Range: left, middle, right

dataEmptyMessageImageVAlign : String [+] 3.7.0

If an image is displayed as the chart dataEmptyMessage, this attribute allows to set a custom vertical alignment for the image.

Default value: value assigned to the baseChartMessageImageVAlign attribute

Range: top, middle, bottom

dataEmptyMessageImageAlpha : Number [+] 3.7.0

If an image is displayed as the chart dataEmptyMessage, this attribute allows to set the transparency of the image.

Default value: 100

Range: 0 - 100

dataEmptyMessageImageScale : Number [+] 3.7.0

If an image is displayed as the chart dataEmptyMessage, this attribute allows to set the scale for magnifying the image.

Default value: 100

Range: 0-300

dataLoadErrorMessage : String [+] 3.7.0

This attribute allows to set the message to be displayed if an error is encountered while loading chart data. To display an image as the chart message, prefix I- to the image URL.

dataLoadErrorMessageFont : String [+] 3.5.0

This attribute allows to set a font for the message displayed if an error is encountered while loading chart data.

Range: Font Name

dataLoadErrorMessageFontSize : Number [+] 3.5.0

This attribute allows to set the font size for the message displayed if an error is encountered while loading chart data.

Range: In pixels

dataLoadErrorMessageColor : Color [+] 3.5.0

This attribute allows to set the font color for the message displayed if an error is encountered while loading chart data.

Range: Hex Color Code

dataLoadErrorMessageImageHAlign : String [+] 3.7.0

If an image is displayed as the chart dataLoadErrorMessage, this attribute allows to set a custom horizontal alignment for the image.

Default value: value assigned to the baseChartMessageImageHAlign attribute

Range: left, middle, right

dataLoadErrorMessageImageVAlign : String [+] 3.7.0

If an image is displayed as the chart dataLoadErrorMessage, this attribute allows to set a custom vertical alignment for the image.

Default value: value assigned to the baseChartMessageImageVAlign attribute

Range: top, middle, bottom

dataLoadErrorMessageImageAlpha : Number [+] 3.7.0

If an image is displayed as the chart dataLoadErrorMessage, this attribute allows to set the transparency of the image.

Default value: 100

Range: 0 - 100

dataLoadErrorMessageImageScale : Number [+] 3.7.0

If an image is displayed as the chart dataLoadErrorMessage, this attribute allows to set the scale for magnifying the image.

Default value: 100

Range: 0-300

dataInvalidMessage : String [+] 3.7.0

This attribute allows to set the message to be displayed if the data to be loaded for the chart is invalid. To display an image as the chart message, prefix I- to the image URL.

dataInvalidMessageFont : String [+] 3.5.0

This attribute allows to set the font for the message displayed if the specified chart data is invalid.

Range: Font Name

dataInvalidMessageFontSize : Number [+] 3.5.0

This attribute allows to set the font size for the message displayed if the specified chart data is invalid.

Range: In pixels

dataInvalidMessageColor : Color [+] 3.5.0

This attribute allows to set the font color for the message displayed if the specified chart data is invalid.

Range: Hex Color Code

dataInvalidMessageImageHAlign : String [+] 3.7.0

If an image is displayed as the chart dataInvalidMessage, this attribute allows to set a custom horizontal alignment for the image.

Default value: value assigned to the baseChartMessageImageHAlign attribute

Range: left, middle, right

dataInvalidMessageImageVAlign : String [+] 3.7.0

If an image is displayed as the chart dataInvalidMessage, this attribute allows to set a custom vertical alignment for the image.

Default value: value assigned to the baseChartMessageImageVAlign attribute

Range: top, middle, bottom

dataInvalidMessageImageAlpha : Number [+] 3.7.0

If an image is displayed as the chart dataInvalidMessage, this attribute allows to set the transparency of the image.

Default value: 100

Range: 0 - 100

dataInvalidMessageImageScale : Number [+] 3.7.0

If an image is displayed as the chart dataInvalidMessage, this attribute allows to set the scale for magnifying the image.

Default value: 100

Range: 0-300

}

Chart Titles and Axis Names

Using these attributes, you can set the caption & sub-caption of the chart.

chart : {

caption : String [+]

Caption of the chart.

subCaption : String [+]

Sub-caption of the chart.

}

Chart Caption Cosmetics

These attributes let you configure the cosmetics of chart caption and sub-caption.

chart : {

captionAlignment : String [+]

Sets horizontal alignment of caption

Range: "left", "center", "right"

captionOnTop : Boolean [+]

Whether caption should be on top of the data plot area

Range: 0/1

captionFontSize : Number [+]

Sets the caption font size in pixels. Besides pixels (px) values can also be defined in rem, %, em, and vw.

Range: 6 - 72

subCaptionFontSize : Number [+]

Sets the sub-caption font size (in pixels). Besides pixels (px) values can also be defined in rem, %, em, and vw.

Range: 6 - 72

captionFont : String [+]

Sets the caption font family

Range: Font Name

subCaptionFont : String [+]

Sets the sub-caption font family

Range: Font Name

captionFontColor : Color [+]

Sets the caption font color

Range: Hex Color Code

subCaptionFontColor : Color [+]

Sets the sub-caption font color

Range: Hex Color Code

captionFontBold : Boolean [+]

Whether the caption font should be displayed in bold

Range: 0/1

subCaptionFontBold : Boolean [+]

Whether the sub caption font should be displayed in bold

Range: 0/1

alignCaptionWithCanvas : Boolean [+]

Whether the caption is aligned with the canvas. Else, it will be aligned with the entire chart area

Range: 0/1

captionHorizontalPadding : Number [+]

If caption is not centre aligned, lets you configure the padding (in pixels) from either edge. Will be ignored if caption is centre aligned.

Range: In Pixels

}

Chart Cosmetics

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

chart : {

showBorder : Boolean [+]

Whether to show a border around the chart or not.

Range: 0/1

borderColor : Color [+]

Border color of the chart.

Range: Hex Color Code

borderThickness : Number [+]

Border thickness of the chart.

Range: In Pixels

borderAlpha : Number [+]

Border alpha of the chart.

Range: 0 - 100

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.

Range: Hex Color Code

bgAlpha : Number [+]

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.

Range: 0 - 100

bgRatio : Number [+]

If you've opted for a gradient background, this attribute lets you set the ratio of each color constituent.

Range: 0 - 100

bgAngle : Number [+]

Angle of the background color, in case of a gradient.

Range: 0-360

bgImage : String [+] 3.2.

To place any image (JPG/PNG/GIF) as background of the chart, enter the (path and) name of the background image. It should be in the same domain as the chart.

bgImageAlpha : Number [+] 3.2.

This attribute specifies the opacity for the loaded background image.

Range: 0 - 100

bgImageDisplayMode : String [+] 3.2.1

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.

Range: stretch, tile, fit, fill, center, none

bgImageValign : String [+] 3.2.1

Helps you to vertically align the background image.

Range: left, center, right

bgImageHalign : String [+] 3.2.1

Helps you to horizontally align the background image.

Range: left, center, right

bgImageScale : Number [+] 3.2.1

Helps you magnify the background image.This attribute will only work when the attribute bgImageDisplayMode is set to none, center, or tile.

Range: 0-300

logoURL : String [+]

You can load an external logo (JPEG/PNG) to your chart, this attribute lets you specify the URL. Due to cross domain security restrictions it is advised to use a logo from the same domain name as your charts.

Range: URL

logoLeftMargin : Number [+]

This attribute helps you set the amount of empty space that you want to put on the left side of your logo image. Nothing is rendered in this space.

Range: In Pixels

logoTopMargin : Number [+]

This attribute helps you set the amount of empty space that you want to put on top of your logo image. Nothing is rendered in this space.

Range: In Pixels

logoPosition : String [+]

Where to position the logo on the chart: TL - Top-left TR - Top-right BR - Bottom right BL - Bottom left CC - Center of screen

Range: TL, TR, BL, BR, CC

logoAlpha : Number [+]

Once the logo has loaded on the chart, you can configure its opacity using this attribute.

Range: 0 - 100

logoScale : Number [+]

You can also change the scale of an externally loaded logo at run-time by specifying a value for this parameter.

Range: 0-300

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.

Range: URL

}

Data Plot Cosmetics

These attributes let you configure how your plot would appear on the chart.

chart : {

showPlotBorder : Boolean [+]

Whether the pie border would show up. This attribute is used to show or hide the plot border and it is configurable at the chart instance, data plot, and data-series levels.

Range: 0/1

plotBorderColor : Color [+]

Color for pie border. This attribute is used to specify the color for the plot border at the chart instance level.

Range: Hex Color Code

plotBorderThickness : Number [+]

Thickness for pie border. This attribute is used to specify the thickness for the plot border at chart instance, data plot, and data-series levels.

Range: 0-5

plotBorderAlpha : Number [+]

Alpha for pie border. This attribute is used to specify the opacity for the plot border at the chart instance level, data plot, and data-series levels.

Range: 0 - 100

plotFillAlpha : Number [+]

This attribute lets you set the fill alpha for plot. If you've opted to fill the plot (column, area etc.) as gradient, this attribute lets you set the fill alpha for gradient.

Range: 0 - 100

showShadow : Boolean [+]

Whether to apply the shadow effect for pie.

Range: 0/1

shadowColor : Color [+]

Lets you set a color of the shadow for pie.

Range: Hex Color Code

shadowAlpha : Number [+]

Lets you set alpha of the shadow for pie.

Range: 0 - 100

plotFillColor : Color [+]

Fill color for all the pies.

Range: Hex Color Code

pieborderthickness : Number [+]

Lets you set the thinkness of the pie border.

Range: In Pixels

piefillalpha : Number [+]

Fill color for all the pies.

Range: 0 - 100

}

Data Value Cosmetics

These attributes let you configure font, background and border cosmetics, of value text-field that appear for each data plot.

chart : {

valueFont : String [+]

Sets the font of the values in the chart

Range: Font Name

valueFontColor : Color [+]

Specifies the value font color

Range: Hex Color Code

valueFontSize : Number [+]

Specifies the value font size. Besides pixels (px) values can also be defined in rem, %, em, and vw.

Range: 6 - 72

valueFontBold : Boolean [+]

Whether value font should be bold

Range: 0/1

valueFontItalic : Boolean [+]

Whether value font should be italicized

Range: 0/1

valueBgColor : Color [+]

Sets the background color for value text

Range: Hex Color Code

valueBorderColor : Color [+]

Sets the border color around the value text

Range: Hex Color Code

valueAlpha : Number [+]

Sets the value alpha including font and background

Range: 0 - 100

valueFontAlpha : Number [+]

Sets the value font alpha

Range: 0 - 100

valueBgAlpha : Number [+]

Sets the value background alpha

Range: 0 - 100

valueBorderAlpha : Number [+]

Sets the value border alpha

Range: 0 - 100

valueBorderThickness : Number [+]

Sets the value border thickness

Range: In Pixels

valueBorderPadding : Number [+]

Sets the padding between the value and its surrounding border

Range: In Pixels

valueBorderRadius : Number [+]

Sets the value border radius

Range: In Pixels

valueBorderDashed : Boolean [+]

Whether the border around the data values should be rendered using dashed lines.

Default value: 0 (border rendered using straight lines)

Range: 0/1

valueBorderDashLen : Number [+]

Sets the length of each dash when the border around the data values is rendered using dashed lines.

Range: In pixels

valueBorderDashGap : Number [+]

Sets the gap between two consecutive dashes when the border around the data values is rendered using dashed lines.

Range: In pixels

textOutline : Boolean [+] 3.14.0

Set this attribute to 1 to draw a border on the data value text.

Default value: 0

Range: 0/1

}

Pie / Doughnut Properties

The following attributes let you control various functionalities of pie.

chart : {

pieRadius : Number [+]

This attribute lets you explicitly set the outer radius of the chart. The chart automatically calculates the best fit pie radius for the chart. This attribute is useful if you want to enforce one of your own values.

Range: In Pixels

innerRadius : Number [+] 3.13.0

This attribute lets you explicitly set the inner radius of the chart. This attribute is useful if you want to enforce one of your own values.

Range: In Pixels

pieBorderColor : Hex code [+]

Set the border color of the pie. By default, it is set to 'FFFFFF'.

Range:

totalAngle : Number [+] 3.11.0

This attribute sets the total angle of the arcs.

Default value: 360

Range: 0 - 360

centerAngle : Number [+] 3.11.0

If an imaginary line bisect the pie chart, the angle that line makes with the base might be defined as the center angle for it.

When you set totalAngle less than 360, you can set different positions for the plot using centerAngle

Range: 0 - 360

originX : Number [+] 3.11.0

This attribute sets the x-coordinate for the center of the plot.

Range: In pixels

originY : Number [+] 3.11.0

This attribute sets the y-coordinate for the center of the plot.

Range: In pixels

}

Smart Labels & Lines

In FusionCharts XT, the Multi-level Pie charts can now have smart labels. Smart labels are data connector lines which connect the pie slices to their respective labels without over-lapping even in cases where there are lots of labels congested. You can configure the smart labels properties using the attributes below..

chart : {

autoRotateLabels : Boolean [+]

Automatically rotates data labels to avoid overlapping.

Range: 0/1

skipOverlapLabels : Boolean [+]

Whenever there is an overlap of labels this property skips them to avoid the congestion of data labels.

Range: 0/1

useEllipsesWhenOverflow : Boolean [+]

Automatically converts text labels on the axis to ellipsis in order to accomodate to the availablle space. This property is 'true' by default.

Range: 0/1

}

Number Formatting

PowerCharts XT offers you a lot of options to format your numbers on the chart. Using the attributes below, you can control a myriad of options like: Formatting of commas and decimals Number prefixes and suffixes Decimal places to which the numbers would round to Scaling of numbers based on a user defined scale Custom number input formats

chart : {

formatNumber : Boolean [+]

This configuration determines whether the numbers displayed on the chart will be formatted using commas, e.g., 40,000 if 'formatNumber': '1'; and 40000 if 'formatNumber': '0';.

Range: 0/1

formatNumberScale : Boolean [+]

Configuration whether to add K (thousands) and M (millions) to a number after truncating and rounding it - e.g., if formatNumberScale is set to 1, 1043 will become 1.04K (with decimals set to 2 places). Same with numbers in millions - an M will be added at the end.

Range: 0/1

defaultNumberScale : String [+]

The default unit of the numbers that you're providing to the chart.

numberScaleUnit : String [+]

Unit of each block of the scale.

numberScaleValue : String [+]

Range of the various blocks that constitute the scale.

forceNumberScale : Boolean [+] 3.9.0

If a data value is less than the lowest given number is the number scale, this attribute forces the lower value of the numberScaleUnit to be applied to that data value. This attribute works only when “formatNumberScale”: “1” and the defaultNumberScale attribute is not defined.

For example, if “numberScaleUnit”: “K, M”, “numberScaleValue”: “1000, 1000”, and “forceNumberScale”: “1”, a data value of 400 will be rendered as 0.40K.

Range: 0/1

scaleRecursively : Boolean [+] 3.2.2 - SR3

Whether recursive scaling should be applied.

Range: 0/1

maxScaleRecursion : Number [+] 3.2.2 - SR3

How many recursions to complete during recursive scaling? -1 completes the entire set of recursion.

scaleSeparator : String [+] 3.2.2 - SR3

What character to use to separate the scales that are generated after recursion?

numberPrefix : String [+]

Using this attribute, you could add prefix to all the numbers visible on the graph. For example, to represent all dollars figure on the chart, you could specify this attribute to $ to show like $40000, $50000.

Range: Character

numberSuffix : String [+]

Using this attribute, you could add a suffix to all the numbers visible on the graph. For example, to represent all figures quantified as per annum on the chart, you could specify this attribute to '/a' to show like 40000/a, 50000/a.

Range: Character

decimalSeparator : String [+]

This attribute helps you specify the character to be used as the decimal separator in a number.

Range: Character

thousandSeparator : String [+]

This attribute helps you specify the character to be used as the thousands separator in a number.

Range: Character

thousandSeparatorPosition : Number [+] 3.2.2 - SR3

This option helps you specify the position of the thousand separator.

Range:

inDecimalSeparator : String [+]

In some countries, commas are used as decimal separators and dots as thousand separators. In XML, if you specify such values, it will give an error while converting to number. So, FusionCharts XT accepts the input decimal and thousand separator from user, so that it can convert it accordingly into the required format. This attribute lets you input the decimal separator.

Range: Character

inThousandSeparator : String [+]

Range: Character

decimals : Number [+]

Number of decimal places to which all numbers on the chart will be rounded to.

Range: 0-10

forceDecimals : Boolean [+]

Whether to add 0 padding at the end of decimal numbers. For example, if you set decimals as 2 and a number is 23.4. If forceDecimals is set to 1, FusionCharts XT will convert the number to 23.40 (note the extra 0 at the end).

Range: 0/1

}

Font Properties

Using the attributes below, you can define the generic font properties for all the text on the chart. These attributes allow you a high level control over font properties. If you intend to specify font properties for individual chart elements (like caption, sub-caption etc.), you need to use the Styles feature of PowerCharts XT. Using Styles, you can also specify advanced font properties like Bold, Italics, HTML Mode etc.

chart : {

baseFont : String [+]

This attribute lets you set the font face (family) of all the text (data labels, values etc.) on chart. If you specify the outCnvBaseFont attribute also, then this attribute controls only the font face of text within the chart canvas bounds.

Range: Font Name

baseFontSize : Number [+]

This attribute sets the base font size of the chart, that is, all the values and the names in the chart which lie on the canvas will be displayed using the font size provided here. Besides pixels (px) values can also be defined in rem, %, em, and vw.

Range: 6 - 72

baseFontColor : Color [+]

This attribute sets the base font color of the chart, that is, all the values and the names in the chart which lie on the canvas will be displayed using the font color provided here.

Range: Hex Color Code

}

Tool-tip

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

chart : {

showToolTip : Boolean [+]

Whether to show tool tip on chart.

Range: 0/1

toolTipBgColor : Color [+]

Background color for tool tip.

Range: Hex Color Code

toolTipColor : Color [+]

Font color for the tool-tip.

Range: Hex Color Code

toolTipBorderColor : Color [+]

Border color for tool tip.

Range: Hex Color Code

tooltipBorderAlpha : Number [+]

Sets the border transparency for tool tip.

Range: 0 - 100

toolTipSepChar : String [+]

The character specified as the value of this attribute separates the name and value displayed in tool tip.

showToolTipShadow : Boolean [+]

Whether to show shadow for tool-tips on the chart.

Range: 0/1

plottooltext : String [+]

Specify custom text for the tooltip

You can either specify a constant string as the tooltip text or you can use variable values from the data level by prefixing a $ to the attribute name, for example, $name, $value.

}

Using this set of attributes, you can customize the toolbar on the chart. The advantage of having a toolbar is that it manages all the UI action elements (context menus, checkboxes, buttons) centrally. This provides a clean, uniform look and a better, more meaningful and logical grouping.

chart : {

toolbarPosition : String [+] 3.11.3

Where to position the toolbar on the chart: TL - Top-left TR - Top-right BR - Bottom right BL - Bottom left CC - Center of screen

Range: TL, TR, BL, BR, CC

toolbarX : Number [+] 3.11.3

Sets the toolbox position on the chart with respect to x-axis.

toolbarY : Number [+] 3.11.3

Sets the toolbox position on the chart with respect to y-axis.

toolbarHAlign : String [+] 3.11.3

Sets the horizontal alignment of the toolbar on the chart.

Range: Left, Right

toolbarVAlign : String [+] 3.11.3

Sets the vertical alignment of the toolbar on the chart

Range: Top, Bottom

toolbarButtonColor : Color [+]

Sets the color of the toolbar buttons.

Range: Any (color code without the # prefix)

showToolBarButtonTooltext : Boolean [+]

Enables/disables display of tooltips for toolbar buttons.

Range: 0/1

toolbarButtonScale : Number [+]

You can change the scale of the toolbar by specifying a value for this attribute.

}

Attributes for Exporting Charts

These attributes allow you to control the saving of chart as image, SVG or XLSX.

chart : {

exportEnabled : Boolean [+]

Whether the chart will allow exporting to images, PDFs, SVG, XLSX or CSV format.

Default value: 0

Range: 0/1

exportAction : String [+]

In case of server-side exporting, the action specifies whether the exported image will be sent back to client as download, or whether it'll be saved on the server.

Default value: download

Range: 'save' or 'download'

exportHandler : String [+]

In case of server side exporting, this refers to the path of the server-side export handler (the ready-to-use scripts that we provide).

exportFormats : String [+]

Lets you configure what output formats to allow for export of chart, in the export context menu, and also customize the label for each menu item. The attribute value should be a pipe (|) delimited separated key-value pair. Example: exportFormats: 'PNG=Export as High Quality Image|JPG|PDF=Export as PDF File'

exportMode : String [+] 3.12.1

This attributes sets the modes of export. To enable client-side exporting, set this attribute to client.

Default value: auto.

Note: Starting v3.12.1, the exportMode attribute replaces the exportAtClientSide attribute. However, you don’t need to make any changes to the existing setup because, the FusionCharts library comes with the proper mapping already provided.

exportShowMenuItem : Boolean [+]

Whether the menu items related to export (e.g., Save as JPEG etc.) will appear in the context menu of chart.

Range: 0/1

exportTargetWindow : String [+]

In case of server-side exporting and when using download as action, this lefts you configure whether the return image, PDF, SVG or XLSX will open in same window (as an attachment for download), or whether it will open in a new window.

Default value: _self

Range: '_self' or '_blank'

exportFileName : String [+]

Using this attribute you can specify the name (excluding the extension) of the output (export) file.

}

Data Plot Hover Effects

If you wish to show an effect on the data plot when the user hovers his mouse over the data plot, these attributes let you configure the cosmetics of the hover for all data plots in the chart.

chart : {

useHoverColor : Boolean [+]

Whether to use the hover fill color for the pies.

Range: 0/1

hoverFillColor : Color [+]

The color which should be used as fill during hover.

Range: Hex Color Code

hoverFillAlpha : Number [+]

Specifies the transparency of the data plots when hovered.

Range: 1 - 100

}

Highlight Effect

If you wish to show a hightlight effect on the nodes (from parent node to child node and vice versa) when the user hovers his mouse over the parent node, these attributes lets you highlight the hovered node and all its children till the leaves.

chart : {

highlightParentPieSlices : Boolean [+]

This attribute sets the direction of highlighting plots when hovered. The default value of this attribute is 1, by which the plots are highlighted from the current node to its parent node. When this attribute is set to 0, all the leaf node will be highlighted from the current hovered node.

Range: 0/1

highlightChildPieSlices : Boolean [+]

This attribute sets the direction of highlighting plots when hovered. The default value of this attribute is 0, by which the plots are highlighted from the current node to its leaf node. When this attribute is set to 1, the direction of the highlight gets reversed, i.e., all the leaf node will be highlighted from the current hovered node.

Range: 0/1

}

Chart Padding & Margins

The following attributes help you control chart margins and paddings.

chart : {

captionPadding : Number [+]

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.

Range: In Pixels

chartLeftMargin : Number [+]

Amount of empty space that you want to put on the left side of your chart. Nothing is rendered in this space.

Range: In Pixels

chartRightMargin : Number [+]

Amount of empty space that you want to put on the right side of your chart. Nothing is rendered in this space.

Range: In Pixels

chartTopMargin : Number [+]

Amount of empty space that you want to put on the top of your chart. Nothing is rendered in this space.

Range: In Pixels

chartBottomMargin : Number [+]

Amount of empty space that you want to put at the bottom of your chart. Nothing is rendered in this space.

Range: In Pixels

}

The category Object

For a multi-level pie chart, the category object is used to define product categories that will be shown on the chart. For defining sub-categories, the category object for the sub-category is nested within the category object of the main category.

category : {

alpha : Number [+]

Alpha for the pie.

Range: 0 - 100

color : Color [+]

Color for the pie

Range: Hex Color Code

label : String [+]

Display value for the pie.

Note: The label attribute replaces the name attribute. Previously, either one of the attributes could be used to set the label. Support for the name attribute has been discontinued since v3.10.0.

link : String [+]

Link for the pie.

toolText : String [+]

The tooltip defined in the category object appears only when the mouse cursor is hovered over the individual slices. However, this will not appear when the cursor is moved over the data labels (except for a situation when long labels are automatically truncated with ellipses. In this situation, if the mouse cursor is hovered over a truncated label, the tooltip will appear with the full label). In case you want to set a short label and show the full label in tooltip, define the full label using this attribute within the category object. The tooltip with the full label will appear only when the mouse is hovered on the particular slice.

value : Number [+]

If you do not want a symmetrical distribution for all the pies, you can allot numeric values to individual pies. This can be done using the value attribute of each category. You will need to define the value for all the categories (pies) then. The sweep angle of the pie would depend on its value. If you just want a symmetrical multi-level pie chart, you can ignore the value.

Range: Numeric Value

showLabel : Boolean [+] 3.13.5

Allows you to show or hide the label for a specific category on the chart.

Range: 0/1

showValue : Boolean [+] 3.13.5

Allows you to show or hide the value for a specific category on the chart.

Range: 0/1

}

Products

Developer

Important Links

Chart Attributes

Chart Atributes

Functional Attributes

Chart Titles and Axis Names

Chart Caption Cosmetics

Chart Cosmetics

Data Plot Cosmetics

Data Value Cosmetics

Pie / Doughnut Properties

Smart Labels & Lines

Number Formatting

Font Properties

Tool-tip

Attributes for Exporting Charts

Data Plot Hover Effects

Highlight Effect

Chart Padding & Margins

The category Object

Chart Attributes

Chart Atributes

Functional Attributes

Chart Message-related Attributes

Chart Titles and Axis Names

Chart Caption Cosmetics

Chart Cosmetics

Data Plot Cosmetics

Data Value Cosmetics

Pie / Doughnut Properties

Smart Labels & Lines

Number Formatting

Font Properties

Tool-tip

Toolbar Attributes

Attributes for Exporting Charts

Data Plot Hover Effects

Highlight Effect

Chart Padding & Margins

The category Object