Events

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.

defaultPrevented

boolean

[+]

Boolean attribute that indicates whether the default action of the event was defaultPrevented; 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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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]{% linkTo tutorials/advanced-charting/drill-down/linkedcharts.md %} 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.

defaultPrevented

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.

detached

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.

data :{
level

string

[+]

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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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)

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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)

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
level

string

[+]

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

}
}
dataObj (Deprecated) :{
level

string

[+]

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

}

printReadyStateChange (Deprecated API)

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.

defaultPrevented

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.

detached

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.

data :{
ready

boolean

[+]

Ready flag

bypass

boolean

[+]

Bypass flag

}
}
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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)

}
}
dataObj (Deprecated) :{
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 beforedataload 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.

defaultPrevented

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.

detached

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.

data :{
url

string

[+]

URL to fetch the source data

dataFormat

FusionCharts~dataFormats

[+]

Format of the source data (json or xml)

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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

}

beforedataload

Triggered when the data is updated to a chart. This hook can be used by the theme manager to update the chart data.

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.

defaultPrevented

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.

detached

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.

data :{
data

object

[+]

Chart data

}
}

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.

defaultPrevented

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.

detached

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.

data :{
data

string or object

[+]

Chart data, in the [data format]dataFormats 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

}
}
dataObj (Deprecated) :{
data

string or object

[+]

Chart data, in the [data format]dataFormats 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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
data

string or object

[+]

Chart data, in the [data format]dataFormats 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

}
}
dataObj (Deprecated) :{
data

string or object

[+]

Chart data, in the [data format]dataFormats 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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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)

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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)

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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)

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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.

link

string

[+]

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.

}
}
dataObj (Deprecated) :{
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.

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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.

link

string

[+]

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.

}
}
dataObj (Deprecated) :{
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.

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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.

link

string

[+]

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.

}
}
dataObj (Deprecated) :{
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.

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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 );

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
startingAngle

number

[+]

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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

centerLabelText

string

[+]

Text displayed as the center label

}
}
dataObj (Deprecated) :{
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

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.

defaultPrevented

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.

detached

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.

data :{
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

centerLabelText

string

[+]

Text displayed as the center label

}
}
dataObj (Deprecated) :{
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

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.

defaultPrevented

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.

detached

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.

data :{
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

centerLabelText

string

[+]

Text displayed as the center label

}
}
dataObj (Deprecated) :{
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

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.

defaultPrevented

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.

detached

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.

data :{
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

centerLabelText

string

[+]

Text displayed as the center label

}
}
dataObj (Deprecated) :{
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

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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

}

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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

}

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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

}

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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

}

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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)

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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)

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

logoLink

string

[+]

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

}
}
dataObj (Deprecated) :{
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

logoLink

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

logoLink

string

[+]

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

}
}
dataObj (Deprecated) :{
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

logoLink

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

logoLink

string

[+]

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

}
}
dataObj (Deprecated) :{
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

logoLink

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

logoLink

string

[+]

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

}
}
dataObj (Deprecated) :{
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

logoLink

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

logoLink

string

[+]

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

}
}
dataObj (Deprecated) :{
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

logoLink

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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.

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

defaultPrevented

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.

detached

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.

defaultPrevented

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.

detached

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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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

}

dataLabelRollOver

Triggered when the mouse pointer is rolled over the tick labels of x-axis or y-axis.

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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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

}

dataLabelRollOut

Triggered when the mouse pointer is rolled out from the tick labels of x-axis or y-axis.

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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
scrollPosition

number

[+]

Position of the scroll, when you start scrolling.

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
prevScrollPosition

number

[+]

Position of the scroll when you started scrolling

scrollPosition

number

[+]

Position of the scroll when you finish scrolling

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
scrollPosition

number

[+]

Position of the scroll when you finish scrolling

}
}
dataObj (Deprecated) :{
ScrollPosition

number

[+]

Position of the scroll when you finish scrolling

}

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.

defaultPrevented

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.

detached

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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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.

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

defaultPrevented

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.

detached

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.

data :{
data

string

[+]

XML string with the complete chart data in the current state

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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.

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
data

string

[+]

Chart data as XML string

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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

}
}
dataObj (Deprecated) :{
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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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. Example : Rectangle, Circle, Polygon

width

number

[+]

Sets the width of the added node only if the shape of the added node is rectangle.

height

number

[+]

Sets the height of the added node only if the shape of the added node is rectangle.

radius

number

[+]

Sets the radius of the added node only if the shape of the added node is either circle or polygon.

sides

number

[+]

Specifies the number of sides configured for the added node only if the shape of the added node is polygon.

label

string

[+]

Text label for the added node

toolText

string

[+]

Text rendered when the mouse pointer is hovered over the added node

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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. Example : Rectangle, Circle, Polygon

width

number

[+]

Sets the width of the updated node only if the shape of the updated node is rectangle.

height

number

[+]

Sets the height of the updated node only if the shape of the updated node is rectangle.

radius

number

[+]

Sets the radius of the updated node only if the shape of the updated node is either circle or polygon.

sides

number

[+]

Specifies the number of sides configured for the updated node only if the shape of the updated node is polygon.

label

string

[+]

Text label for the updated node

toolText

string

[+]

Text rendered when the mouse pointer is hovered over the updated node

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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. Example : Rectangle, Circle, Polygon

width

number

[+]

Sets the width of the deleted node only if the shape of the deleted node is rectangle.

height

number

[+]

Sets the height of the deleted node only if the shape of the deleted node is rectangle.

radius

number

[+]

Sets the radius of the deleted node only if the shape of the deleted node is either circle or polygon.

sides

number

[+]

Specifies the number of sides configured for the deleted node only if the shape of the deleted node is polygon.

label

string

[+]

Text label for the deleted node

toolText

string

[+]

Text rendered when the mouse pointer is hovered over the deleted node

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

link

string

[+]

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

}
}
dataObj (Deprecated) :{
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

link

string

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

link

URL

[+]

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.

}
}
dataObj (Deprecated) :{
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

link

URL

[+]

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.

defaultPrevented

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.

detached

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.

data :{
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

link

URL

[+]

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.

}
}
dataObj (Deprecated) :{
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

link

URL

[+]

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 even