Demos

Beginner's Guide

Charts / Gauges / Maps Guide

Customizing Charts

API

Integrating With Your Stack

Help

Loading

FusionCharts exposes various events throughout the lifetime of a chart. Event listeners can be attached to these events to tap into the chart’s lifecycle (such as loading data into the chart, before rendering the chart and so on) and perform certain actions. These events are listed below.

ready static event

This event is fired when the FusionCharts library is ready to be used. By the time this event is raised, the browser’s DOM is ready to be interacted with, which corresponds to the DOMContentLoaded event of browsers. In older browsers, where DOMContentLoaded is not fired, the ready event corresponds to the load event of the page. In case the FusionCharts library is included in the page when the DOMContentLoaded event is already fired (i.e. the script is loaded asyncronously using AJAX or by using script deferring methods) the ready event is still fired to ensure integrity of all the listeners.

In many ways the nature of this event is similar to the jQuery(document).ready function of the jQuery library and the Ext.onReady function of the ExtJS library. One should interact with the FusionCharts framework (i.e. create new charts, set options, etc.) only after this event has been fired. This event also helps you to neatly write your code in separate script files and in the page <head> thus keeping scripts from being a part of your page <body>.

An alternate (and shorthand) method to subscribing the ready event is to use the ready function. One advantage that the ready function has over the ready event is that the event is fired only once during the life-cycle of a page while functions passed to the ready function are executed even when attached after the ready event has been fired.

This is a framework level event and as such can be only listened via the FusionCharts object on the FusionCharts class alone. It will not be fired if it is subscribed from individual chart instances.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
version

: array

[+]

FusionCharts framework version returned in the form of an array, equivalent to the array version

now

: boolean

[+]

Boolean attribute to indicate whether the event was triggered at the instant of the window.ondomcontentloaded event (window.onload for older browsers) or whether the window was already loaded and the event was fired to maintain integrity

}

Example

<html>
<head>
<script type="text/javascript" src="/fusioncharts/js/fusioncharts.js"></script>
<script type="text/javascript">
// Render a chart within a chart container `div` element.
FusionCharts.addEventListener('ready', function () {
    var chart = new FusionCharts({
        type: 'column2d',
        renderAt: 'chart-container-div',
        dataFormat: 'json',
        dataSource: {
            chart: {
                caption: "Quarterly sales summary",
                numberPrefix: "$"
            }
            data: [
                { label: "Q1", value: "213345"},
                { label: "Q2", value: "192672"},
                { label: "Q3", value: "201238"},
                { label: "Q4", value: "209881"},
            ]
        }
    });
    // Since we are in the `ready` block, the `chart-container-div`
    // element should be available by now.
    chart.render();
});
</script>
<body>
    <div id="chart-container-div">Chart loads here...</div>
</body>
</html>

beforeInitialize static event

This pre-initialization event is triggered every time a new instance of the FusionCharts object is created. It then triggers a number of modules that need to be setup on every instance of FusionCharts; the event can be used to perform any actions required to be completed before the initialization of each chart.

Because this event is triggered upon instantiating a new FusionCharts object, it is virtually impossible to listen to this event by adding an event listener to the chart. By the time the event listener is attached (using the addEventListener() method), the event is already fired.

However, there are alternate ways that can be used to listen to this event. You can listen to the FusionCharts global events, using the addEventListener static method before even creating a new instance. (The required instance can be identified by the id of the chart using eventObject.sender.id.) You can also pass the event listener as a parameter of the FusionCharts constructor.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
type

: string

[+]

Type of chart rendered

renderAt

: string

[+]

Id of the HTML DOM element within which the chart is rendered

width

: number

[+]

Chart width

height

: number

[+]

Chart height

dataFormat

: string

[+]

Type of data (json, jsonurl, xml, xmlurl) passed to the chart object

dataSource

: object

[+]

Object containing the source data for the chart

events

: object

[+]

Object containing details of all events configured for the chart

}

Example

// Listening using global events
FusionCharts.addEventListener('beforeInitialize', function (opts) {
    // Prints id of the chart being rendered
    console.log("Chart with id " + opts.sender.id + " is about to be initialized.");
 });

// Pass event listener in the FusionCharts constructor
var mychart = new FusionCharts({
    "type": "column2d",
    "dataFormat": "json",
    "dataSource": {
         ...
    },
    // Attach event handlers
    "events": {
        // Attach to beforeInitialize
        "beforeInitialize": function () {
            console.log("Initializing mychart...");
        }
    }
});

initialized static event

Triggered when a new instance of the FusionCharts constructor is created.

Initialization does not indicate that the chart has rendered; it only indicates that the JavaScript object instance (new FusionCharts()) is created and is ready to be operated upon.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
type

: string

[+]

Type of chart

renderAt

: string

[+]

Id of the HTML DOM element within which the chart is rendered

width

: number

[+]

Chart width

height

: number

[+]

Chart height

dataFormat

: string

[+]

Type of data (json, jsonurl, xml, xmlurl) passed to the chart object

dataSource

: object

[+]

Object containing the source data for the chart

events

: string

[+]

Object containing details of all events configured for the chart

}

Example

// Listening using global events
FusionCharts.addEventListener('initialized', function (opts) {
    // Prints id of the chart that has initialized
    console.log("Chart with id " + opts.sender.id + " has been initialized.");
 });

// Pass event listener in the FusionCharts constructor
var mychart = new FusionCharts({
    "type": "column2d",
    "dataFormat": "json",
    "dataSource": {
         ...
    },
    // Attach event handlers
    "events": {
        // Attach to beforeInitialize
        "initialized": function () {
            console.log("Initialized mychart...");
        }
    }
});

beforeLinkedItemOpen

Triggered just before a linked item in a LinkedChart is rendered, after the parent link is clicked. It is triggered before the instance of the drill-down chart is instantiated.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
level

: string

[+]

Level of the linked chart in to the parent chart (starts from 0)

}

linkedItemOpened

Triggered when a linked chart is rendered, after the parent link is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
item

: string

[+]

JavaScript object instance of the linked chart opened

level

: string

[+]

Level of the linked chart in to the parent chart (starts from 0)

}

beforeLinkedItemClose

Triggered just before a linked chart is closed.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
item

: string

[+]

JavaScript object instance of the linked chart closed

level

: string

[+]

Level of the linked chart in to the parent chart (starts from 0)

}

linkedItemClosed

Triggered when a linked chart is closed to go back to its parent chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
level

: string

[+]

Level of the linked chart in to the parent chart (starts from 0)

}

printReadyStateChange

Used to notify the status of the print manager. Triggered when the print manager starts processing all charts to be printed and again when all charts are ready for managed printing.

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
ready

: boolean

[+]

Ready flag

bypass

: boolean

[+]

Bypass flag

}

dataLoadRequestCompleted

Triggered when chart data is successfully loaded from a URL (instead of a static JSON or XML file from the system).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
source

: string

[+]

Nature of the data load request. Presently, its value is XMLHttpRequest.

url

: string

[+]

URL of the data source

dataFormat

: FusionCharts~dataFormats

[+]

Format of the source data (json or xml)

silent

: boolean

[+]

true if silent instructions are saved to arguments

successcallback

: boolean

[+]

Function called once the event is fired

dataSource

: object

[+]

Object containing the source data for the chart

xmlHttpRequestObject

: object

[+]

Object that fetches the data

}

dataLoadError

Triggered if an error is encountered while loading data from the specified URL to the chart object.

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
url

: string

[+]

URL to fetch the source data

dataFormat

: FusionCharts~dataFormats

[+]

Format of the source data (json or xml)

error

: object

[+]

Error object passed to the event for debugging the JavaScript errors encountered

httpStatus

: number

[+]

Parameter to identify server communication issues (for example, 404 status is returned if the URL is not found)

}

dataLoadCancelled

Triggered when the default behavior of the dataLoadRequested event is cancelled using the eventObj.preventDefault() method. Subsequently, all AJAX requests are aborted.

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
url

: string

[+]

URL to fetch the source data

dataFormat

: FusionCharts~dataFormats

[+]

Format of the source data (json or xml)

}

dataLoadRequestCancelled

Triggered when the default behavior of the dataLoadRequested event is cancelled by calling the eventObj.preventDefault() method. The event is internally fired if the data source is a local path or the URL fails internal security checks.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
source

: string

[+]

Nature of the data load request. Presently, its value is XMLHttpRequest.

url

: string

[+]

URL of the data source

dataFormat

: FusionCharts~dataFormats

[+]

Format of the source data (json or xml)

silent

: boolean

[+]

true if silent instructions are saved to arguments

config

: function

[+]

Function called once the event is fired

successcallback

: boolean

[+]

Function called once the event is fired

}

dataUpdated

Triggered when chart data is updated and the chart is redrawn, after the drawComplete event.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
data

: string or object

[+]

Chart data, in the data format used

format

: FusionCharts~dataFormats

[+]

Format in which chart data is finally passed to the chart

dataSource

: object

[+]

Object containing the source data for the chart

dataFormat

: FusionCharts~dataFormats

[+]

Format of the source data

silent

: boolean

[+]

true if silent instructions are saved to arguments

}

dataUpdateCancelled

Triggered when the default behavior of the beforeDataUpdate event is cancelled by calling the eventObj.preventDefault() method.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
data

: string or object

[+]

Chart data

format

: FusionCharts~dataFormats

[+]

Format in which the data was to be passed on for rendering

dataSource

: string

[+]

Source data, as specified using data setter functions like setChartData()

dataFormat

: FusionCharts~dataFormats

[+]

Format of the source data (json or xml)

error

: object

[+]

Error object passed to the event for debugging the JavaScript errors encountered

}

dataLoadRequested

Triggered when chart data is loaded from a URL instead of a static JSON or XML file from the system.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
source

: string

[+]

Nature of the data load request. Presently, its value is XMLHttpRequest.

url

: string

[+]

URL of the data source

dataFormat

: FusionCharts~dataFormats

[+]

Format of the source data (json or xml)

silent

: boolean

[+]

true if silent instructions are saved to arguments

callback

: boolean

[+]

Function called once the event is fired

}

beforeDataUpdate

Triggered just before chart data is passed to the chart. It is useful if any operations have to be performed on the data before it is applied to the chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
data

: string or object

[+]

Chart data, in the data format used

format

: FusionCharts~dataFormats

[+]

Format in which chart data is finally passed to the chart

dataSource

: object

[+]

Object containing the source data for the chart

dataFormat

: FusionCharts~dataFormats

[+]

Format of the source data

silent

: boolean

[+]

true if silent instructions are saved to arguments

}

Example

// Show data of a single-series column chart in an
// ascending sorted order.
FusionCharts.ready(function () {
    var chart = new FusionCharts({
        type: "column2d",
        renderAt: "chart-container"
    });

    // Add the data handler to intercept incoming
    // data and sort it.
    chart.addEventListener("beforeDataUpdate", function (event, args) {
        var data = args.data,
            values;

        // If incoming data is not JSON then convert it to JSON
        if (args.format !== 'json') {
            data = FusionCharts.transcodeData(data, args.format, 'json');
        }

        // Get hold of the data array
        values = data.data;
        if (values && values.length) { // Check whether data exists
            // Sort the data by passing a comparison function to the
            // sort function of the array of values.
            values.sort(function (a, b) {
                 return (a && a.value) - (b && b.value);
            });
        }

        // Convert data back to original format in case it wasn't
        // originally JSON
        if (args.format !== 'json') {
            data = FusionCharts.transcodeData(data, 'json', args.format);
        }

        // Replace the data with updated data.
        args.data = data;
    });
});

realTimeUpdateComplete

Triggered every time a real-time chart completes updating, using the dataStreamURL attribute or through user-interaction (using the edit mode of the real-time angular and linear gauges).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
data

: string

[+]

Chart data as XML or JSON string

updateObject

: object

[+]

Updated chart object

prevData

: string

[+]

Data value before the update

source

: string

[+]

Source of data load request, presently set to xmlHttpRequest

URL

: string

[+]

URL of the data source

}

chartCleared

Triggered when the complete chart canvas is cleared by calling the clearChart() method or by clicking the context menu in real-time charts.

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

slicingEnd

Triggered when a pie or a doughnut slice completes slicing out/slicing in.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
slicedState

: boolean

[+]

State of the slice before the event was triggered; true if the slice was already sliced out, false if the slice was sliced in

data

: string

[+]

The plot data from the chart to slice.

dataIndex

: number

[+]

Index of the data plot in the order of its definition in the dataset

}

slicingStart

Triggered when a pie or a doughnut slice begins slicing out/slicing in.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
slicedState

: boolean

[+]

State of the slice before the event was triggered; true if the slice was already sliced out, false if the slice was sliced in

data

: string

[+]

Source data for the slice

dataIndex

: number

[+]

Index of the data plot, in the order of its definition in the dataset

}

entityRollOut

Triggered when the mouse pointer is rolled out from over an entity on a map.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
value

: number

[+]

Entity value

label

: string

[+]

Entity label

shortLabel

: string

[+]

Short name for the entity

originalId

: string

[+]

Entity ID stored in the map definition file

id

: string

[+]

User-assigned entity ID (if not applicable, the value is the original ID)

}

entityRollOver

Triggered when the mouse pointer is rolled over an entity on a map.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
value

: number

[+]

Entity value

label

: string

[+]

Entity label

shortLabel

: string

[+]

Short name for the entity

originalId

: string

[+]

Entity ID stored in the map definition file

id

: string

[+]

User-assigned entity ID (if not applicable, the value is the original ID)

}

entityClick

Triggered when an entity on a map is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
value

: number

[+]

Entity value

label

: string

[+]

Entity label

shortLabel

: string

[+]

Short name for the entity

originalId

: string

[+]

Entity ID stored in the map definition file

id

: string

[+]

User-assigned entity ID (if not applicable, the value is the original ID)

}

Example

FusionCharts.ready(function () {
    var map = new FusionCharts({
        type: 'maps/world',
        renderAt: 'map-container-div',

        events: {
            entityClick: function (event, args) {
                console.log(args.label + 'clicked');
            }
        }
    });
});

connectorRollOver

This event is applicable to the connector element of the Gantt chart and the maps. It is triggered when the mouse pointer is rolled over a connector connecting the tasks (on a Gantt chart) or the markers (on a map).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

Applicable only to the Gantt chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

Applicable only to the Gantt chart

pageX

: number

[+]

y-coordinate of the pointer, relative to the page

Applicable only to the Gantt chart

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

Applicable only to the Gantt chart.

fromTaskId

: string

[+]

ID of the source task for the connector

Applicable only to the Gantt chart.

toTaskId

: string

[+]

ID of the destination task for the connector

Applicable only to the Gantt chart.

fromTaskConnectStart

: boolean

[+]

Position of the connector on the source task bar. Set to 1 if the connector starts from the left edge of the task bar, set to 0 if it starts from the right edge.

Applicable only to the Gantt chart.

toTaskConnectStart

: boolean

[+]

Position of the connector on the destination task bar. Set to 1 if the connector ends at the left edge of the task bar, set to 0 if it ends at the right edge.

Applicable only to the Gantt chart.

URL to which the user will be redirected, if the connector is clicked

Applicable only to the Gantt chart.

sourceType

: string

[+]

Type of the element that triggered the event. For the connectorRollOver event, it will be connector.

Applicable only to the Gantt chart.

fromMarkerId

: string

[+]

ID of the source marker for the connector

Applicable only to maps.

toMarkerId

: string

[+]

ID of the destination marker for the connector

Applicable only to maps.

label

: string

[+]

Connector label, specified using the label attribute

Applicable only to maps.

}

connectorRollOut

This event is applicable to the connector element of the Gantt chart and the maps. It is triggered when the mouse pointer is rolled out from over a connector connecting the tasks (on a Gantt chart) or the markers (on a map).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

Applicable only to the Gantt chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

Applicable only to the Gantt chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

Applicable only to the Gantt chart

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

Applicable only to the Gantt chart.

fromTaskId

: string

[+]

ID of the source task for the connector

Applicable only to the Gantt chart.

toTaskId

: string

[+]

ID of the destination task for the connector

Applicable only to the Gantt chart.

fromTaskConnectStart

: boolean

[+]

Position of the connector on the source task bar. Set to 1 if the connector starts from the left edge of the task bar, set to 0 if it starts from the right edge.

Applicable only to the Gantt chart.

toTaskConnectStart

: boolean

[+]

Position of the connector on the destination task bar. Set to 1 if the connector ends at the left edge of the task bar, set to 0 if it ends at the right edge.

Applicable only to the Gantt chart.

URL to which the user will be redirected, if the connector is clicked

Applicable only to the Gantt chart.

sourceType

: string

[+]

Type of the element that triggered the event. For the connectorRollOut event, it will be connector.

Applicable only to the Gantt chart.

fromMarkerId

: string

[+]

ID of the source marker for the connector

Applicable only to maps.

toMarkerId

: string

[+]

ID of the destination marker for the connector

Applicable only to maps.

label

: string

[+]

Connector label, specified using the label attribute

Applicable only to maps.

}

connectorClick

This event is applicable to the connector element of the Gantt chart and the maps. It is triggered when a connector connecting the tasks (on a Gantt chart) or the markers (on a map) is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

Applicable only to the Gantt chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

Applicable only to the Gantt chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

Applicable only to the Gantt chart

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

Applicable only to the Gantt chart.

fromTaskId

: string

[+]

ID of the source task for the connector

Applicable only to the Gantt chart.

toTaskId

: string

[+]

ID of the destination task for the connector

Applicable only to the Gantt chart.

fromTaskConnectStart

: boolean

[+]

Position of the connector on the source task bar. Set to 1 if the connector starts from the left edge of the task bar, set to 0 if it starts from the right edge.

Applicable only to the Gantt chart.

toTaskConnectStart

: boolean

[+]

Position of the connector on the destination task bar. Set to 1 if the connector ends at the left edge of the task bar, set to 0 if it ends at the right edge.

Applicable only to the Gantt chart.

URL to which the user will be redirected, if the connector is clicked

Applicable only to the Gantt chart.

sourceType

: string

[+]

Type of the element that triggered the event. For the connectorClick event, it will be connector.

Applicable only to the Gantt chart.

fromMarkerId

: string

[+]

ID of the source marker for the connector

Applicable only to maps.

toMarkerId

: string

[+]

ID of the destination marker for the connector

Applicable only to maps.

label

: string

[+]

Connector label, specified using the label attribute

Applicable only to maps.

}

Example

//declaring the fusioncharts object.
    var myMap = new FusionCharts( "Maps/FCMap_World.swf", "myMapId", "400", "300", "0" );
    //setting the data source.
    myMap.setXMLUrl("Data.xml");
    //rendering the chart in the associated Div.
    myMap.render("mapContainer");

    //function to perform the necessary action on capturing the connectorClicked event.
    //alert the user with the from and to marker id's.
    function listenerEvent(eventObject, argumentsObject){
        alert( "From marker ID: "+ argumentsObject.fromMarkerId + ",
                        To marker ID: " + argumentsObject.toMarkerId);
    }

    //listening to the connector click event
    FusionCharts("myMapId").addEventListener ("connectorClicked" , listenerEvent );

markerRollOver

Triggered when the mouse pointer is rolled over a marker on a map.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
label

: string

[+]

Marker label

x

: number

[+]

Original x-coordinate of the marker

y

: number

[+]

Original y-coordinate of the marker

scaledX

: number

[+]

Scaled x-coordinate of the marker

scaledY

: number

[+]

Scaled y-coordinate of the marker

chartX

: number

[+]

x-coordinate of the marker in to the top-left corner of the map canvas

chartY

: number

[+]

y-coordinate of the marker in to the top-left corner of the map canvas

}

Example

//declaring the FusionCharts object.
var myMap = new FusionCharts( "Maps/FCMap_World.swf", "myMapId", "400", "300", "0" );
//passing the data to the object in *XML* format.
myMap.setXMLUrl("Data.xml");
//rendering the chart in the map container.
myMap.render("mapContainer");

//the function which gets executed when the MarkerRollOver event is captured.
function myChartListener(eventObject, argumentsObject){
    alert([
        "ID: ", argumentsObject.id, "; Label: ", argumentsObject.label,
        "; x: ", argumentsObject.x, ", y: ", argumentsObject.x,
        "; scaledX: ", argumentsObject.scaledX, ", scaledY: ", argumentsObject.scaledY,
        "; chartX: ", argumentsObject.chartX, ", chartY: ", argumentsObject.chartY
    ].join(""));
}

//listening to the markerRollOver event.
FusionCharts("myMapId").addEventListener ("markerRollOver" , myChartListener );

markerRollOut

Triggered when the mouse pointer is rolled out from over a marker on a map.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
label

: string

[+]

Marker label

x

: number

[+]

Original x-coordinate of the marker

y

: number

[+]

Original y-coordinate of the marker

scaledX

: number

[+]

Scaled x-coordinate of the marker

scaledY

: number

[+]

Scaled y-coordinate of the marker

chartX

: number

[+]

x-coordinate of the marker in to the top-left corner of the map canvas

chartY

: number

[+]

y-coordinate of the marker in to the top-left corner of the map canvas

}

Example

//declaring the Fusion Charts object.
var myMap = new FusionCharts( "Maps/FCMap_World.swf", "myMapId", "400", "300", "0" );
//passing the data to the object in *XML* format.
myMap.setXMLUrl("Data.xml");
//rendering the chart in the map container.
myMap.render("mapContainer");

//the function which gets executed when the MarkerRollOut event is captured.
function myChartListener(eventObject, argumentsObject){
    alert([
        "ID: ", argumentsObject.id, "; Label: ", argumentsObject.label,
        "; x: ", argumentsObject.x, ", y: ", argumentsObject.x,
        "; scaledX: ", argumentsObject.scaledX, ", scaledY: ", argumentsObject.scaledY,
        "; chartX: ", argumentsObject.chartX, ", chartY: ", argumentsObject.chartY
    ].join(""));
}

//listening to the markerRollOut event.
FusionCharts("myMapId").addEventListener ("markerRollOut" , myChartListener );

markerClick

Triggered when a marker on a map is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
label

: string

[+]

Marker label

x

: number

[+]

Original x-coordinate of the marker

y

: number

[+]

Original y-coordinate of the marker

scaledX

: number

[+]

Scaled x-coordinate of the marker

scaledY

: number

[+]

Scaled y-coordinate of the marker

chartX

: number

[+]

x-coordinate of the marker in to the top-left corner of the map canvas

chartY

: number

[+]

y-coordinate of the marker in to the top-left corner of the map canvas

}

Example

//declaring the Fusion Charts object.
var myMap = new FusionCharts( "Maps/FCMap_World.swf", "myMapId", "400", "300", "0" );
//passing the data to the object in *XML* format.
myMap.setXMLUrl("Data.xml");
//rendering the chart in the map container.
myMap.render("mapContainer");

//the function which gets executed when the MarkerClick event is captured.
function myChartListener(eventObject, argumentsObject){
    alert([
        "ID: ", argumentsObject.id, "; Label: ", argumentsObject.label,
        "; x: ", argumentsObject.x, ", y: ", argumentsObject.x,
        "; scaledX: ", argumentsObject.scaledX, ", scaledY: ", argumentsObject.scaledY,
        "; chartX: ", argumentsObject.chartX, ", chartY: ", argumentsObject.chartY
    ].join(""));
}

//listening to the markerClicked event.
FusionCharts("myMapId").addEventListener ("markerClicked" , myChartListener );

pageNavigated

This event is fired on page change in SSGrid chart.

Parameters

data

: object

[+]

Contains data of the sought page, with color, displayValue, originalText, value and y position for each data points.

pageId

: number

[+]

Tells the index of the sought page.

rotationEnd

Triggered when a pie/doughnut chart completes rotating.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
startingAngle

: number

[+]

Measure of the angle from which the pie/doughnut chart starts rotating

changeInAngle

: number

[+]

Difference between the angle measures at the start and at the end of rotation

}

rotationStart

Triggered when a pie/doughnut chart starts rotating.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
startingAngle

: number

[+]

Measure of the angle from which the pie/doughnut chart starts rotating

}

centerLabelRollover

Triggered every time the mouse pointer is rolled over the center label of the doughnut chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

container

: DOMElement

[+]

DOM element used to render the chart

pixelWidth

: number

[+]

Width of the DOM element, in pixels, used to render the chart

pixelHeight

: number

[+]

Height of the DOM element, in pixels, used to render the chart

id

: string

[+]

Chart ID

renderer

: string

[+]

Rendering engine used (javascript or flash)

centerLabelText

: string

[+]

Text displayed as the center label

}

centerLabelRollout

Triggered every time the mouse pointer is rolled out of the center label of the doughnut chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

container

: DOMElement

[+]

DOM element used to render the chart

pixelWidth

: number

[+]

Width of the DOM element, in pixels, used to render the chart

pixelHeight

: number

[+]

Height of the DOM element, in pixels, used to render the chart

id

: string

[+]

Chart ID

renderer

: string

[+]

Rendering engine used (javascript or flash)

centerLabelText

: string

[+]

Text displayed as the center label

}

centerLabelClick

Triggered every time the center label of the doughnut chart is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

container

: DOMElement

[+]

DOM element used to render the chart

pixelWidth

: number

[+]

Width of the DOM element, in pixels, used to render the chart

pixelHeight

: number

[+]

Height of the DOM element, in pixels, used to render the chart

id

: string

[+]

Chart ID

renderer

: string

[+]

Rendering engine used (javascript or flash)

centerLabelText

: string

[+]

Text displayed as the center label

}

centerLabelChanged

Triggered every time the text within the center label of the doughnut chart changes.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

container

: DOMElement

[+]

DOM element used to render the chart

pixelWidth

: number

[+]

Width of the DOM element, in pixels, used to render the chart

pixelHeight

: number

[+]

Height of the DOM element, in pixels, used to render the chart

id

: string

[+]

Chart ID

renderer

: string

[+]

Rendering engine used (javascript or flash)

centerLabelText

: string

[+]

Text displayed as the center label

}

chartClick

Triggered every time a chart is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

container

: DOMElement

[+]

DOM element used to render the chart

pixelWidth

: number

[+]

Width of the DOM element, in pixels, used to render the chart

pixelHeight

: number

[+]

Height of the DOM element, in pixels, used to render the chart

id

: string

[+]

Chart ID

renderer

: string

[+]

Rendering engine used (javascript or flash)

}

Example

FusionCharts.ready(function () {
    var chart = new FusionCharts({
        type: 'column2d',
        dataFormat: 'jsonurl',
        dataSource: 'chart-data.json',
        renderAt: 'chart-container-div',

        events: {
            chartClick: function (eventObj, argsObj) {
                console.log('Chart clicked at ' + argsObj.chartX + ',' + argsObj.chartY);
            }
        }
    });

    chart.render();
});

chartMouseMove

Triggered when the mouse pointer is moved over a chart. The event arguments pass useful information related to pointer location, relative to the chart and the page, that can be used for positioning elements like annotations or integrating charts with custom tooltip libraries.

By default, a chart does not trigger this event until is enabled to do so. To enable this event for a chart, set the enableChartMouseMoveEvent attribute to 1.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

container

: DOMElement

[+]

DOM element used to render the chart

pixelWidth

: number

[+]

Width of the DOM element, in pixels, used to render the chart

pixelHeight

: number

[+]

Height of the DOM element, in pixels, used to render the chart

id

: string

[+]

Chart ID

renderer

: string

[+]

Rendering engine used (javascript or flash)

}

chartRollOver

Triggered every time the mouse pointer is rolled over a chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

container

: DOMElement

[+]

DOM element used to render the chart

pixelWidth

: number

[+]

Width of the DOM element, in pixels, used to render the chart

pixelHeight

: number

[+]

Height of the DOM element, in pixels, used to render the chart

id

: string

[+]

Chart ID

renderer

: string

[+]

Rendering engine used (javascript or flash)

}

Example

// Create a chart and display the caption of the chart over which the mouse has been hovered. The
// event is attached to the FusionCharts global `addEventListener` function so that it is fired for
// all charts rendered on that page Once this event listener has been attached, any chart rendered on
// page will cause a console log when hovered or tapped.
FusionCharts.addEventListener('chartRollOver', function (event) {
    var chart = event.sender, // access the chart that raised this event
        caption = chart && chart.getChartAttribute('caption'); // get the chart caption

    // Output the caption in JavaScript console
    console.log('Mouse entered on the chart with caption: ' + caption);
});

chartRollOut

Triggered every time the mouse pointer is rolled out from over a chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

container

: DOMElement

[+]

DOM element used to render the chart

pixelWidth

: number

[+]

Width of the DOM element, in pixels, used to render the chart

pixelHeight

: number

[+]

Height of the DOM element, in pixels, used to render the chart

id

: string

[+]

Chart ID

renderer

: string

[+]

Rendering engine used (javascript or flash)

}

Example

// Create a chart and display the caption of the chart over which the mouse has been hovered. The
// event is attached to the FusionCharts global `addEventListener` function so that it is fired for
// all charts rendered on that page Once this event listener has been attached, any chart rendered on
// page will cause a console log when hovered out or tapped away.
FusionCharts.addEventListener('chartRollOut', function (event) {
    var chart = event.sender, // access the chart that raised this event
        caption = chart && chart.getChartAttribute('caption'); // get the chart caption

    // Output the caption in JavaScript console
    console.log('Mouse left the chart with caption: ' + caption);
});

backgroundLoaded

Triggered when the background image for a chart (specified using the bgImage attribute) is loaded.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
url

: string

[+]

URL of the background image

bgImageAlpha

: string

[+]

Transparency of the image

bgImageDisplayMode

: string

[+]

Display mode set for the image

bgImageVAlign

: string

[+]

Vertical alignment of the image

bgImageHAlign

: string

[+]

Horizontal alignment of the image

imageWidth

: string

[+]

Image width

imageHeight

: string

[+]

Image height

}

backgroundLoadError

Triggered when there is an error in loading the background image for a chart (specified using the bgImage attribute).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
url

: string

[+]

URL of the background image

bgImageAlpha

: string

[+]

Transparency of the image

bgImageDisplayMode

: string

[+]

Display mode set for the image

bgImageVAlign

: string

[+]

Vertical alignment of the image

bgImageHAlign

: string

[+]

Horizontal alignment of the image

imageWidth

: string

[+]

Image width

imageHeight

: string

[+]

Image height

error

: object

[+]

Error object passed to the event for debugging the JavaScript errors encountered

}

legendItemClicked

Triggered when a legend item is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

Chart ID

chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

datasetName

: string

[+]

Dataset to which the data plot belongs

dataIndex

: number

[+]

Index of the data plot, in the order of its definition in the dataset

visible

: boolean

[+]

Visibility status of the legend item (true if shown, false if hidden)

preventDefaults

: function

}

legendItemRollover

Triggered when the mouse pointer is rolled over a legend item.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

Chart ID

chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

datasetName

: string

[+]

Dataset to which the data plot belongs

dataIndex

: number

[+]

Index of the data plot, in the order of its definition in the dataset

visible

: boolean

[+]

Visibility status of the legend item (true if shown, false if hidden)

}

legendItemRollout

Triggered when the mouse pointer is rolled out from over a legend item.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

Chart ID

chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

datasetName

: string

[+]

Dataset to which the data plot belongs

dataIndex

: number

[+]

Index of the data plot, in the order of its definition in the dataset

visible

: boolean

[+]

Visibility status of the legend item (true if shown, false if hidden)

}

logoRollover

Triggered when the mouse pointer is rolled over a logo on a chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

logoURL

: string

[+]

URL of the logo image

logoAlpha

: number

[+]

Transparency set for the logo

logoPosition

: string

[+]

Logo position (tr, tl, br, bl)

logoScale

: number

[+]

Logo image scaling value

URL to which the user will be redirected, if the logo is clicked

}

logoRollout

Triggered when the mouse pointer is rolled out from over a logo on a chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

logoURL

: string

[+]

URL of the logo image

logoAlpha

: number

[+]

Transparency set for the logo

logoPosition

: string

[+]

Logo position (tr, tl, br, bl)

logoScale

: number

[+]

Logo image scaling value

URL to which the user will be redirected, if the logo is clicked

}

logoClick

Triggered when the logo on a chart is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

logoURL

: string

[+]

URL of the logo image

logoAlpha

: number

[+]

Transparency set for the logo

logoPosition

: string

[+]

Logo position (tr, tl, br, bl)

logoScale

: number

[+]

Logo image scaling value

URL to which the user will be redirected, if the logo is clicked

}

logoLoaded

Triggered when the logo is loaded on a chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
logoURL

: string

[+]

URL of the logo image

logoAlpha

: number

[+]

Transparency set for the logo

logoPosition

: string

[+]

Logo position (tr, tl, br, bl)

logoScale

: number

[+]

Logo image scaling value

URL to which the user will be redirected, if the logo is clicked

}

logoLoadError

Triggered when the logo cannot be loaded on a chart because of an error.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
logoURL

: string

[+]

URL of the logo image

logoAlpha

: number

[+]

Transparency set for the logo

logoPosition

: string

[+]

Logo position (tr, tl, br, bl)

logoScale

: number

[+]

Logo image scaling value

URL to which the user will be redirected, if the logo is clicked

error

: object

[+]

Error object passed to the event for debugging the JavaScript errors encountered

}

beforeExport

Triggered just before the exporting process of a chart begins, through the export context menu or when the exportChart() method is called programmatically.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
buttons

: object

[+]

Object containing the status of buttons on the chart

bgColor

: string

[+]

Background color of the exported chart

bgAlpha

: number

[+]

Transparency set for the exported chart

exportaction

: string

[+]

Action for exporting image/PDF. Set to download, if the exported image will be sent back to the client as a download, set to save if it will be saved on the server.

exportfilename

: string

[+]

Name (with extension) for the exported image/PDF

exporthandler

: string

[+]

Path of the server-side export handler

exportformat

: string

[+]

Format in which the chart is exported (jpg, png, pdf)

exportparameters

: string

[+]

Additional parameters sent by the chart (defined using the exportParameters chart attribute)

exporttargetwindow

: string

[+]

In case of server-side exporting and when using download as action, this shows whether the exported image/PDF will opened in the same window (as an attachment for download), or it will open in a new window.

Applicable only for server-side exporting.

exportcallback

: string

[+]

Callback function executed after the chart is exported

exportwithimages

: boolean

[+]

Boolean attribute that indicates if the chart had external images that were also exported

exportformats

: object

[+]

Object containing all the export formats available

}

exported

Triggered when a chart exports successfully.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
DOMId

: string

[+]

ID of the chart exported

height

: number

[+]

Chart height

width

: number

[+]

Chart width

fileName

: string

[+]

Name of the exported file and the path where it is saved

statusCode

: boolean

[+]

Success status code of the export. Set to 1 if the export is successful, set to 0 if it fails.

statusMessage

: string

[+]

Message indicating success or failure

notice

: string

[+]

Message indicating that the chart was previously exported in the same format. In this case, a suffix for the file is internally generated and added to the filename.

Configure your code to show the properties and their values for the dataObj parameter in the console. You can then see the suffix that is generated internally.

}

exportCancelled

Triggered when the default behavior of the beforeExport event is cancelled by calling the eventObj.preventDefault() method.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
buttons

: string

[+]

Chart data as XML string

bgColor

: string

[+]

Background color of the exported chart

bgAlpha

: number

[+]

Transparency set for the exported chart

exportaction

: string

[+]

Action for exporting image/PDF. Set to download, if the exported image will be sent back to the client as a download, set to save if it will be saved on the server.

exportfilename

: string

[+]

Name (with extension) for the exported image/PDF

exporthandler

: string

[+]

Path of the server-side export handler

exportformat

: string

[+]

Format in which the chart is exported (jpg, png, pdf)

exportparameters

: string

[+]

Additional parameters sent by the chart (defined using the exportParameters chart attribute)

exporttargetwindow

: string

[+]

In case of server-side exporting and when using download as action, this shows whether the exported image/PDF will open in the same window (as an attachment for download), or it will open in a new window.

Applicable only for server-side exporting.

exportcallback

: string

[+]

Callback function executed after the chart is exported

exportwithimages

: boolean

[+]

Boolean attribute to indicate if the chart had external images that were also exported

exportformats

: object

[+]

Object containing all the export formats available

}

beforePrint

Triggered before the printing process for a chart begins, after the print() method is called on the chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

printComplete

Triggered when the user confirms or cancels printing through the browser’s print dialog box.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

printCancelled

Triggered when the default behavior of the beforePrint event is cancelled by calling the eventObj.preventDefault() method.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

dataLabelClick

Triggered every time the x-axis label of a data plot is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

text

: string

[+]

Label text

dataIndex

: number

[+]

Index of the data plot, in order of its definition in the source data

URL to which the user will be redirected, if the data label is clicked

}

dataLabelRollOver

Triggered when the mouse pointer is rolled over the x-axis label of a data plot.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

text

: string

[+]

Label text

dataIndex

: number

[+]

Index of the data plot, in order of its definition in the source data

URL to which the user will be redirected, if the data label is clicked

}

dataLabelRollOut

Triggered when the mouse pointer is rolled out from over the x-axis label of a data plot.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

text

: string

[+]

Label text

dataIndex

: number

[+]

Index of the data plot, in order of its definition in the source data

URL to which the user will be redirected, if the data label is clicked

}

scrollStart

Triggered when you begin scrolling through a chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
scrollPosition

: number

[+]

Position of the scroll, when you start scrolling.

}

scrollEnd

Triggered when a chart completes scrolling.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
prevScrollPosition

: number

[+]

Position of the scroll when you started scrolling

scrollPosition

: number

[+]

Position of the scroll when you finish scrolling

}

onScroll

Triggered while scrolling through a zoom-line chart or scroll charts.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

zoomReset

Triggered every time a zoom-line/zoom-scatter chart is reset to its original values (when the zooming history is cleared).

Try It Yourself! (zoom-line chart)

Try It Yourself! (zoom-scatter chart)

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

zoomedOut

Triggered every time a zoom-line/zoom-scatter chart is zoomed out.

Try It Yourself! (zoom-line chart)

Try It Yourself! (zoom-scatter chart)

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
level

: number

[+]

Zooming level. Starting at 1, the value increments as the user further zooms in for the same subset of data and decrements when the user zooms out.

startIndex

: number

[+]

Data index of the first item in the zoomed out view

startLabel

: string

[+]

Data label of the first item in the zoomed out view

endIndex

: number

[+]

Data index of the last item in the zoomed out view

endLabel

: string

[+]

Data label of the last item in the zoomed out view

}

zoomedIn

Triggered every time a zoom-line/zoom-scatter chart is zoomed in.

Try It Yourself! (zoom-line chart)

Try It Yourself! (zoom-scatter chart)

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
level

: number

[+]

Zooming level. Starting at 1, the value increments as the user further zooms in for the same subset of data and decrements when the user zooms out.

startIndex

: number

[+]

Data index of the first item in the zoomed in view

startLabel

: string

[+]

Data label of the first item in the zoomed in view

endIndex

: number

[+]

Data index of the last item in the zoomed in view

endLabel

: string

[+]

Data label of the last item in the zoomed in view

}

zoomed

Triggered every time a zoom-line/zoom-scatter chart is zoomed in or zoomed out.

Try It Yourself! (zoom-line chart)

Try It Yourself! (zoom-scatter chart)

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
level

: number

[+]

Zooming level. Starting at 1, the value increments as the user further zooms in for the same subset of data and decrements when the user zooms out.

startIndex

: number

[+]

Data index of the starting item in the zoomed view

startLabel

: string

[+]

Data label of the starting item in the zoomed view

endIndex

: number

[+]

Data index of the starting item in the zoomed view

endLabel

: string

[+]

Data label of the ending item in the zoomed view

}

zoomModeChanged

Triggered every time a zoom-line/zoom-scatter chart switches between the pin mode and the zoom mode.

Try It Yourself! (zoom-line chart)

Try It Yourself! (zoom-scatter chart)

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
pinModeActive

: boolean

[+]

Active viewing mode of the zoom line chart. Set to true if the chart is in pin mode, set to false if the chart is in zoom mode.

}

pinned

Triggered in the pin mode of a zoom-line chart, when the user performs data selection to pin a range.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
startIndex

: number

[+]

Data index of the first item in the zoomed in view of the pin mode

startLabel

: string

[+]

Data label of the first item in the zoomed in view of the pin mode

endIndex

: number

[+]

Data index of the last item in the zoomed in view of the pin mode

endLabel

: string

[+]

Data label of the last item in the zoomed in view of the pin mode

}

dataRestored

Triggered when all data plots on the interactive charts (select-scatter, drag-node, and drag-able charts) are restored to their original values (by clicking the Restore button).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

beforeDataSubmit

Triggered when the Submit button on interactive charts (select-scatter, drag-node, and drag-able charts) is clicked, after the data values are updated by the user.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
data

: string

[+]

XML string with the complete chart data in the current state

}

dataSubmitError

Triggered when there is an ajax error in sending the POST request with the user-submitted data in interactive charts (select-scatter, drag-node, and dragable charts).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
data

: string

[+]

Chart data as XML string

url

: string

[+]

URL to which the data is sent as HTTP POST request

httpStatus

: number

[+]

Status code of the ajax POST request

statusText

: string

[+]

Ajax error message

xhrObject

: object

[+]

XMLHttpRequest object that takes care of sending the XML chart data. In case of an error, this object is undefined.

}

dataSubmitted

Triggered when the ajax POST request for sending user-submitted data in interactive charts (select-scatter, drag-node, and dragable charts) to the URL is successfully completed.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
data

: string

[+]

Chart data as XML string

url

: string

[+]

URL to which the data is sent as HTTP POST request

response

: string

[+]

Response returned by the web server to which the HTTP POST request was submitted

xhrObject

: object

[+]

XMLHttpRequest object that takes care of sending the XML chart data

}

dataSubmitCancelled

Triggered when the default behavior of the beforeDataSubmit event is cancelled by calling the eventObj. preventDefault() method.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
data

: string

[+]

Chart data as XML string

}

Example

FusionCharts.addEventListener('beforeDataSubmit', function(eventObject, parameterObject) {
  eventObject.preventDefault();
}

chartUpdated

Triggered every time the data on any of the interactive charts (select-scatter, drag-node, and the dragable charts) is updated by user interaction.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

Chart ID

sourceEvent

: string

[+]

Event that caused the chartUpdated event to be triggered. For example, in a drag-node chart, if a node was dragged to shift its position, the source event will be dataplotDragEnd.

sourceType

: string

[+]

Type of element that triggered this event

chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

index

: number

[+]

Index of the updated data plot, in the order of its definition in the source data

datasetIndex

: number

[+]

Index of the dataset, to which the updated data plot belongs, in the order of its definition in the source data

datasetName

: number

[+]

Name of the dataset, to which the updated data plot belongs

x

: number

[+]

x-coordinate of the updated data plot

Applicable only to the drag-node chart.

y

: number

[+]

y-coordinate of the updated data plot

Applicable only to the drag-node chart.

shape

: string

[+]

Shape of the updated data plot

Applicable only to the drag-node chart.

width

: number

[+]

Width of the updated data plot

Applicable only to the drag-node chart.

height

: number

[+]

Height of the updated data plot

Applicable only to the drag-node chart.

radius

: number

[+]

Radius of the updated data plot

Applicable only to the drag-node chart.

sides

: number

[+]

Number of sides the shape of the updated data plot has

Applicable only to the drag-node chart.

label

: string

[+]

Data label of the updated data plot

toolText

: string

[+]

Tooltip text for the updated data plot

}

nodeAdded

Triggered when a new node is added to the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

Node ID

dataIndex

: number

[+]

Index of the added node, in sequence in the order of the pre-defined nodes in the source data

datasetIndex

: number

[+]

Index of the dataset to which the new node is added

datasetName

: number

[+]

Name of the dataset to which the new node is added

URL to which the user will be redirected, if the node is clicked

x

: number

[+]

x-coordinate of the added node

y

: number

[+]

y-coordinate of the added node

shape

: string

[+]

Shape of the added node

width

: number

[+]

Width of the added node

height

: number

[+]

Height of the added node

radius

: number

[+]

Radius of the added node

sides

: number

[+]

Number of sides configured for the added node

label

: string

[+]

Text label for the added node

toolText

: string

[+]

Text rendered when the mouse pointer is hovered over the added node

}

nodeUpdated

Triggered when a node on the drag-node chart is updated.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

Node ID

dataIndex

: number

[+]

Index of the updated node, in the order of its definition

datasetIndex

: number

[+]

Index of the dataset to which the updated node belongs

datasetName

: number

[+]

Name of the dataset to which the updated node belongs

URL to which the user will be redirected, if the node is clicked

x

: number

[+]

x-coordinate of the updated node

y

: number

[+]

y-coordinate of the updated node

shape

: string

[+]

Shape of the updated node

width

: number

[+]

Width of the updated node

height

: number

[+]

Height of the updated node

radius

: number

[+]

Radius of the updated node

sides

: number

[+]

Number of sides of the updated node

label

: string

[+]

Text label for the updated node

toolText

: string

[+]

Text rendered when the mouse pointer is hovered over the updated node

}

nodeDeleted

Triggered when a node on the drag-node chart is deleted.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

Node ID

dataIndex

: number

[+]

Index of the deleted node, in the order of its definition

datasetIndex

: number

[+]

Index of the dataset to which the deleted node belongs

datasetName

: number

[+]

Name of the dataset to which the deleted node belongs

URL to which the user will be redirected, if the node is clicked

x

: number

[+]

x-coordinate of the deleted node

y

: number

[+]

y-coordinate of the deleted node

shape

: string

[+]

Shape of the deleted node

width

: number

[+]

Width of the deleted node

height

: number

[+]

Height of the deleted node

radius

: number

[+]

Radius of the deleted node

sides

: number

[+]

Number of sides of the deleted node

label

: string

[+]

Text label for the deleted node

toolText

: string

[+]

Text rendered when the mouse pointer is hovered over the deleted node

}

connectorAdded

Triggered when a new connector is added to the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: number

[+]

Connector ID

arrowAtStart

: boolean

[+]

Whether the connector has an arrow that points towards the source node

arrowAtEnd

: boolean

[+]

Whether the connector has an arrow that points towards the destination node

fromNodeId

: number

[+]

Index number or the node ID of the source node

toNodeId

: number

[+]

Index number or the node ID of the destination node

label

: string

[+]

Text label of the connector

URL to which the user will be redirected, if the connector is clicked

}

connectorUpdated

Triggered when a connector on the drag-node chart is updated.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: number

[+]

Connector ID

arrowAtStart

: boolean

[+]

Whether the connector has an arrow that points towards the source node

arrowAtEnd

: boolean

[+]

Whether the connector has an arrow that points towards the destination node

fromNodeId

: number

[+]

Index number or the node ID of the source node

toNodeId

: number

[+]

Index number or the node ID of the destination node

label

: string

[+]

Text label of the connector

URL to which the user will be redirected, if the connector is clicked

}

connectorDeleted

Triggered when a connector is deleted from the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: number

[+]

Connector ID

arrowAtStart

: boolean

[+]

Whether the connector has an arrow that points towards the source node

arrowAtEnd

: boolean

[+]

Whether the connector has an arrow that points towards the destination node

fromNodeId

: number

[+]

Index number or the node ID of the source node

toNodeId

: number

[+]

Index number or the node ID of the destination node

label

: string

[+]

Text label of the connector

URL to which the user will be redirected, if the connector is clicked

}

labelAdded

Triggered when a new label is added on the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
x

: number

[+]

x-coordinate of the label node, scaled as per the axis of the chart

y

: number

[+]

y-coordinate of the label node, scaled as per the axis of the chart

text

: string

[+]

Label text

allowDrag

: boolean

[+]

Whether the label can be dragged or no

URL to which the user will be redirected, if the label is clicked

sourceType

: string

[+]

Type of the element that triggered the event. For the labelAdded event, this will be labelnode.

}

labelDeleted

Triggered when a label is deleted from the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
x

: number

[+]

x-coordinate of the label node, scaled as per the axis of the chart

y

: number

[+]

y-coordinate of the label node, scaled as per the axis of the chart

text

: string

[+]

Label text

allowDrag

: boolean

[+]

Whether the label can be dragged or no

URL to which the user will be redirected, if the label is clicked

sourceType

: string

[+]

Type of the element that triggered the event. For the labelDeleted event, this will be labelnode.

}

selectionRemoved

Triggered when the selection box, drawn on a select-scatter chart, is removed.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

ID of the selection box

data

: object

[+]

Subset of the data selected using the selection box

selectionTop

: number

[+]

Distance between the top edges of the selection box and the chart

selectionLeft

: number

[+]

Distance between the left edges of the selection box and the chart

selectionWidth

: number

[+]

Width of the selection box

selectionHeight

: number

[+]

Height of the selection box

startXVAlue

: number

[+]

Value of the starting position of the selection box, in the canvas x-axis

startYVAlue

: number

[+]

Value of the starting position of the selection box, in the canvas y-axis

endXValue

: number

[+]

Value of the ending position of the selection box, in the canvas x-axis

endYValue

: number

[+]

Value of the ending position of the selection box, in the canvas y-axis

}

selectionStart

Triggered when you start drawing a selection box on a select-scatter/zoom-scatter chart.

Try It Yourself! (select-scatter chart)

Try It Yourself! (zoom-scatter chart)

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

selectionTop

: number

[+]

Distance between the top edges of the selection box and the chart

selectionLeft

: number

[+]

Distance between the left edges of the selection box and the chart

selectionWidth

: number

[+]

Width of the selection box (0 for this event, because it is triggered before you finish drawing the box)

selectionHeight

: number

[+]

Height of the selection box (0 for this event, because it is triggered before you finish drawing the box)

startXVAlue

: number

[+]

Value of the starting position of the selection box, in the canvas x-axis

startYVAlue

: number

[+]

Value of the starting position of the selection box, in the canvas y-axis

}

selectionEnd

Triggered when you complete drawing a selection box on a select-scatter/zoom-scatter chart.

Try It Yourself! (select-scatter chart)

Try It Yourself! (zoom-scatter chart)

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

selectionTop

: number

[+]

Distance between the top edges of the selection box and the chart

selectionLeft

: number

[+]

Distance between the left edges of the selection box and the chart

selectionWidth

: number

[+]

Width of the selection box

selectionHeight

: number

[+]

Height of the selection box

startXVAlue

: number

[+]

Value of the starting position of the selection box, in the canvas x-axis

startYVAlue

: number

[+]

Value of the starting position of the selection box, in the canvas y-axis

endXValue

: number

[+]

Value of the ending position of the selection box, in the canvas x-axis

endYValue

: number

[+]

Value of the ending position of the selection box, in the canvas y-axis

}

labelClick

Triggered when a label on the drag-node chart is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

x

: number

[+]

x-coordinate of the label node, scaled as per the axis of the chart

y

: number

[+]

y-coordinate of the label node, scaled as per the axis of the chart

text

: string

[+]

Label text

allowDrag

: boolean

[+]

Whether the label can be dragged or no

URL to which the user will be redirected to, if the label is when clicked

sourceType

: string

[+]

Type of the element that triggered the event. For the labelClick event, this will be labelnode.

}

labelRollOver

Triggered when the mouse pointer is rolled over a label on the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

x

: number

[+]

x-coordinate of the label node, scaled as per the axis of the chart

y

: number

[+]

y-coordinate of the label node, scaled as per the axis of the chart

text

: string

[+]

Label text

allowDrag

: boolean

[+]

Whether the label can be dragged or no

URL to which the user will be redirected, if the label is clicked

sourceType

: string

[+]

Type of the element that triggered the event. For the labelRollOver event, this will be labelnode.

}

labelRollOut

Triggered when the mouse pointer is rolled out of a label on the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

x

: number

[+]

x-coordinate of the label node, scaled as per the axis of the chart

y

: number

[+]

y-coordinate of the label node, scaled as per the axis of the chart

text

: string

[+]

Label text

allowDrag

: boolean

[+]

Whether the label can be dragged or no

URL to which the user will be redirected to, if the label is clicked

sourceType

: string

[+]

Type of the element that triggered the event. For the labelRollOut event, this will be labelnode.

}

labelDragStart

Triggered when you start dragging a label on the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

x

: number

[+]

x-coordinate of the label node, scaled as per the axis of the chart

y

: number

[+]

y-coordinate of the label node, scaled as per the axis of the chart

text

: string

[+]

Label text

allowDrag

: boolean

[+]

Whether the label can be dragged or no

URL to which the user will be redirected, if the label is clicked

sourceType

: string

[+]

Type of the element that triggered the event. For the labelDragStart event, this will be labelnode.

}

labelDragEnd

Triggered when you finish dragging a label on the drag-node chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

x

: number

[+]

x-coordinate of the label node, scaled as per the axis of the chart

y

: number

[+]

y-coordinate of the label node, scaled as per the axis of the chart

text

: string

[+]

Label text

allowDrag

: boolean

[+]

Whether the label can be dragged or no

URL to which the user will be redirected, if the label is clicked

sourceType

: string

[+]

Type of the element that triggered the event. For the labelDragEnd event, this will be labelnode.

}

dataplotDragStart

Triggered when you start dragging the data plots of the drag-able charts (the drag-node, drag-column, drag-line, and drag-area charts).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
datasetIndex

: number

[+]

Position of the dataset in the order of its definition in the source data

datasetName

: string

[+]

Dataset to which the data plot belongs

dataIndex

: number

[+]

Index of the data plot in the order of its definition in the dataset

startValue

: number

[+]

Value of the data plot before it is dragged

Applicable only to the drag-column, drag-line, and drag-area charts

}

dataplotDragEnd

Triggered when you complete dragging the data plots of the drag-able charts (the drag-node, drag-column, drag-line, and drag-area charts).

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
datasetIndex

: number

[+]

Position of the dataset in the order of its definition in the source data

datasetName

: string

[+]

Dataset to which the data plot belongs

dataIndex

: number

[+]

Index of the data plot in the order of its definition in the dataset

startValue

: number

[+]

Value of the data plot before it is dragged

Applicable only to the drag-column, drag-line, and drag-area charts

endValue

: number

[+]

Value of the data plot after it is dragged

Applicable only to the drag-column, drag-line, and drag-area charts

}

processClick

Triggered when a process in the Gantt chart is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

id

: string

[+]

Process ID

label

: string

[+]

Process label

isHeader

: boolean

[+]

Set to true if the event was triggered by the process header

align

: string

[+]

Horizontal alignment of the process label

vAlign

: string

[+]

Vertical alignment of the process label

URL to which the user will be redirected, if the process is clicked

}

processRollOver

Triggered when the mouse pointer is rolled over a process on the Gantt chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

id

: string

[+]

Process ID

label

: string

[+]

Process label

isHeader

: boolean

[+]

true if the event was triggered by the process header

align

: string

[+]

Horizontal alignment of the process label

vAlign

: string

[+]

Vertical alignment of the process label

URL to which the user will be redirected, if the process is clicked

}

processRollOut

Triggered when the mouse pointer is rolled out from over a process on the Gantt chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

id

: string

[+]

Process ID

label

: string

[+]

Process label

isHeader

: boolean

[+]

true if the event was triggered by the process header

align

: string

[+]

Horizontal alignment of the process label

vAlign

: string

[+]

Vertical alignment of the process label

URL to which the user will be redirected, if the process is clicked

}

categoryClick

Triggered when a category on the Gantt chart is clicked.

Try It Yourself!’}

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
align

: string

[+]

Horizontal alignment of the category label

vAlign

: string

[+]

Vertical alignment of the category label

chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

URL to which the user will be redirected, if the category is clicked

text

: string

[+]

Category label text

}

categoryRollOver

Triggered when the mouse pointer is rolled over a category on the Gantt chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
align

: string

[+]

Horizontal alignment of the category label

vAlign

: string

[+]

Vertical alignment of the category label

chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

URL to which the user will be redirected, if the category is clicked

text

: string

[+]

Category label text

}

categoryRollOut

Triggered when the mouse pointer is rolled out of a category on the Gantt chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
align

: string

[+]

Horizontal alignment of the category label

vAlign

: string

[+]

Vertical alignment of the category label

chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

URL to which the user will be redirected, if the category is clicked

text

: string

[+]

Category label text

}

milestoneClick

Triggered when a milestone on a Gantt chart is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

taskId

: string

[+]

Id of the task to which the milestone belongs

date

: string

[+]

Milestone date

numSides

: string

[+]

Number of sides defined for the milestone shape

radius

: string

[+]

Radius of the milestone shape

toolText

: string

[+]

Text displayed when the mouse pointer is hovered over the milestone

URL to which the user will be redirected, if the milestone is clicked

}

milestoneRollOver

Triggered when the mouse pointer is rolled over a milestone on a Gantt chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

y-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

taskId

: string

[+]

Id of the task to which the milestone belongs

date

: string

[+]

Milestone date

numSides

: string

[+]

Number of sides defined for the milestone shape

radius

: string

[+]

Radius of the milestone shape

toolText

: string

[+]

Text displayed when the mouse pointer is hovered over the milestone

URL to which the user will be redirected, if the milestone is clicked

}

milestoneRollOut

Triggered when the mouse pointer is rolled out from over a milestone on a Gantt chart.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
chartX

: number

[+]

x-coordinate of the pointer, relative to the chart

chartY

: number

[+]

y-coordinate of the pointer, relative to the chart

pageX

: number

[+]

x-coordinate of the pointer, relative to the page

pageY

: number

[+]

y-coordinate of the pointer, relative to the page

taskId

: string

[+]

Id of the task to which the milestone belongs

date

: string

[+]

Milestone date

numSides

: string

[+]

Number of sides defined for the milestone shape

radius

: string

[+]

Radius of the milestone shape

toolText

: string

[+]

Text displayed when the mouse pointer is hovered over the milestone

URL to which the user will be redirected, if the milestone is clicked

}

chartTypeChanged

Triggered when the chart type is explicitly changed by calling the chartType() method on a chart.

This event is not fired when a chart is rendered using the static render() method or the chart type is set for the first time (the type is not provided to the constructor on the first render) using the chartType() method. If the chart type provided as the parameter to the chartType() method is the same as the current chart type, again, this event will not be triggered. Similarly, the event is not triggered if the new chart type is invalid.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
previousType

: string

[+]

Original chart type

newType

: string

[+]

New chart type

}

overlayButtonClick

Triggered when the overlay back button on a linked chart is clicked.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
id

: string

[+]

ID of the overlay button

show

: boolean

[+]

Visibility status of the overlay button (true if shown, false if not)

message

: string

[+]

Text rendered on the overlay button

fontColor

: string

[+]

Font color of the text rendered on the overlay button

bgColor

: string

[+]

Background color of the overlay button

borderColor

: string

[+]

Border color for the overlay button

}

loaded

Triggered when the chart has finished downloading itself in the client environment. It indicates that the all the resources required to render the chart are ready and that the chart can be drawn. This event can be used to hide any loader components that you might have on your page.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
type

: string

[+]

Type of chart rendered

renderer

: string

[+]

Rendering engine used (javascript or flash)

}

rendered

Triggered when the chart completes drawing, after the render() method is called. The chart renders if the data provided is correct; otherwise, an error message from the list given here is rendered. A call to this event is made only once, even if new data may be supplied later. It can be used to invoke any further JavaScript methods on the chart or change chart data.

If chart animation is enabled, this event is triggered before the animation process. In case you need to perform any action after the animation has completed, you will need to add an appropriate time delay in this event handler, using setTimeout.

The default animation duration is 1000ms (one second). The animation duration can be customized using the animationDuration chart attribute.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
renderer

: string

[+]

Rendering engine used (javascript or flash)

}

drawComplete

Triggered when the chart draws for the first time or is redrawn because of a data update, resize, change of chart message, or change of chart type.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
drawCount

: number

[+]

Number of times the chart is drawn/redrawn

renderer

: string

[+]

Rendering engine used (javascript or flash)

width

: number or percent

[+]

Chart width, in pixels or percentage

height

: number or percent

[+]

Chart height, in pixels or percentage

displayingMessage

: boolean

}

renderComplete

Triggered every time a chart is rendered using the render() method, the chartType() method, or the setChartData() method. It is also triggered every time chart data is successfully updated, which triggers a re-render internally.

The difference between this event and the rendered event is that the rendered event is triggered only when the .render() method is called.

The renderComplete event can be triggered without triggering the beforeRender event during data update.

If chart animation is enabled, this event is triggered before the animation process. In case you need to perform any action after the animation has completed, you will need to add an appropriate time delay in this event handler, using setTimeout.

The default animation duration is 1000ms (one second). The animation duration can be customized using the animationDuration chart attribute.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
renderer

: string

[+]

Rendering engine used (javascript or flash)

width

: number

[+]

Chart width

height

: number

[+]

Chart height

drawCount

: number

[+]

Number of times the chart is drawn/redrawn

displayingMessage

: boolean

[+]

Boolean attribute indicating whether a message is configured for the chart

}

dataInvalid

Triggered when there is no chart data or data with parsing or fetching (from the server) errors is submitted to the chart.

Maps, real-time charts, and some gauges do not require initial data to begin with. In that case, this event is not triggered.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
error

: object

[+]

Error object passed to the event for debugging the JavaScript errors encountered

}

dataXMLInvalid

Triggered if the chart data (passed to the chart object either by URL or as a string) is not in a usable format.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

dataLoaded

Triggered when the data for a chart (passed by url or as a string) is loaded to the chart object. It ensures that the data passed is valid and the chart can be rendered.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

noDataToDisplay

Triggered when no data is passed to the chart. It can be used to show an error message or take a corrective measure.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}

legendPointerDragStart

Triggered when the user starts dragging the legend pointer of a gradient legend, in the heatmap chart and maps.

Try It Yourself!

Parameters

eventObj
: {
eventType

: string

[+]

Type (name) of the event triggered

eventId

: number

[+]

Unique ID associated with the event. Internally, it is an incrementing counter that can also be used to verify the order in which the event was triggered.

sender

: FusionCharts

[+]

Instance of the FusionCharts object that fired this event. Events that are fired by the framework (and not by individual charts) have the framework as this property.

cancelled

: boolean

[+]

Boolean attribute that indicates whether an event’s propagation was cancelled; set to true when eventObj.stopPropagation() is called.

stopPropagation

: function

[+]

Function called from within a listener to prevent subsequent listeners from being executed.

prevented

: boolean

[+]

Boolean attribute that indicates whether the default action of the event was prevented; set to true when eventObj.preventDefault() is called.

preventDefault

: function

[+]

Function to prevent the default action of an event. For example, if the eventObj.preventDefault() function is called for the beforeResize event, the chart will not be resized and the resizeCancelled event will be triggered.

detach

: boolean

[+]

Boolean attribute that indicates whether a listener has been detached and will no longer be executed; set to true when eventObj.detachHandler() is called

detachHandler

: function

[+]

Function to allow the listener to remove itself rather than being called externally by the removeEventListener() method. It is useful for one-time event listening or for special situations when the event is no longer required to be listened when it has been triggered with a specific condition.

}
dataObj
: {
pointerIndex

: number

[+]

Index of the pointer dragged (0 for the starting pointer and 1 for the ending pointer)

pointers

: object

[+]

Object containing the start and end value of the scale

legendPointerWidth

: number or percent

[+]

Width, in pixels or percentage, of the pointer dragged

legendPointerHeight

: number or percent

[+]

Height, in pixels or percentage, of the pointer dragged

}