The PieChart class creates a pie chart
PieChart
_addAxes
Adds axes to the chart.
_addSeries
Renders the Graph.
_addTooltip
Adds a tooltip to the dom.
_buildSeriesKeys
dataProvider
Constructs seriesKeys if not explicitly specified.
dataProvider
Array
The dataProvider for the chart.
Array
_dataProviderChangeHandler
e
Event handler for dataProviderChange.
e
Object
Event object.
_getAllKeys
dp
Returns all the keys contained in a dataProvider
.
dp
Array
Collection of objects to be parsed.
Object
_getAriaMessage
key
Returns the appropriate message based on the key press.
key
Number
The keycode that was pressed.
String
_getAxisClass
t
Helper method that returns the axis class that a key references.
t
String
The type of axis.
Axis
_getDefaultAxes
Generates and returns a key-indexed object containing Axis
instances or objects used to create Axis
instances.
Object
_getGraph
Default value function for the Graph
attribute.
Graph
_getSeriesCollection
Calculates and returns a seriesCollection
.
Array
_getTooltip
Default getter for tooltip
attribute.
Object
_groupMarkersChangeHandler
e
Handles groupMarkers change event.
e
Object
Event object.
_markerEventDispatcher
e
Event handler for marker events.
e
Object
Event object.
_parseAxes
val
Creates Axis
instances.
val
Object
Object containing Axis
instances or objects in which to construct Axis
instances.
Object
_parseSeriesAxes
c
Parse and sets the axes for the chart.
c
Array
A collection PieSeries
instance.
_planarLabelFunction
categoryAxis
valueItems
index
seriesArray
seriesIndex
Formats tooltip text when interactionType
is planar
.
categoryAxis
Axis
Reference to the categoryAxis of the chart.
valueItems
Array
Array of objects for each series that has a data point in the coordinate plane of the event. Each object contains the following data:
index
Number
The index of the item within its series.
seriesArray
Array
Array of series instances for each value item.
seriesIndex
Number
The index of the series in the seriesCollection
.
_redraw
Redraws the chart instance.
_setAriaElements
cb
Creates an aria live-region
, aria-label
and aria-describedby
for the Chart.
cb
Node
Reference to the Chart's contentBox
attribute.
_setDataValues
val
Setter method for dataProvider
attribute.
val
Array
Array to be set as dataProvider
.
Array
_setOffscreen
Sets a node offscreen for use as aria-description or aria-live-regin.
Node
_setText
label
val
Updates the content of text field. This method writes a value into a text field using
appendChild
. If the value is a String
, it is converted to a TextNode
first.
label
HTMLElement
label to be updated
val
String
value with which to update the label
_showTooltip
msg
x
y
Shows a tooltip
_tooltipChangeHandler
e
Event handler for the tooltipChange.
e
Object
Event object.
_tooltipLabelFunction
categoryItem
valueItem
itemIndex
series
Formats tooltip text for a pie chart.
categoryItem
Object
An object containing the following:
valueItem
Object
An object containing the following:
itemIndex
Number
The index of the item within the series.
series
CartesianSeries
The PieSeries
instance of the item.
_updateTooltip
val
Updates the tooltip attribute.
val
Object
Object containing properties for the tooltip.
Object
_wereSeriesKeysExplicitlySet
Utility method to determine if seriesKeys
was explicitly provided
(for example during construction, or set by the user), as opposed to
being derived from the dataProvider for example.
boolean true if the seriesKeys
attribute was explicitly set.
bindUI
destructor
Destructor implementation for the PieChart class.
getAxisByKey
val
Returns an Axis
instance by key reference. If the axis was explicitly set through the axes
attribute,
the key will be the same as the key used in the axes
object. For default axes, the key for
the category axis is the value of the categoryKey
(category
). For the value axis, the default
key is values
.
val
String
Key reference used to look up the axis.
Axis
getCategoryAxis
Returns the category axis for the chart.
Axis
getSeries
val
Returns a series instance by index or key value.
val
Object
CartesianSeries
getSeriesItem
series
index
Returns an object literal containing a categoryItem and a valueItem for a given series index.
Object
hideTooltip
Hides the default tooltip
initializer
renderUI
syncUI
toggleTooltip
e
Event listener for toggling the tooltip. If a tooltip is visible, hide it. If not, it will create and show a tooltip based on the event object.
e
Object
Event object.
_setSeriesCollection
Setter method for seriesCollection
attribute.
val
Array
Array of either CartesianSeries
instances or objects containing series attribute key value pairs.
ariaDescription
Sets the aria description for the chart.
ariaDescriptionChange
Fires when the value for the configuration attribute ariaDescription
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
ariaLabel
Sets the aria-label
for the chart.
ariaLabelChange
Fires when the value for the configuration attribute ariaLabel
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
axes
Axes to appear in the chart.
axesChange
Fires when the value for the configuration attribute axes
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
axesCollection
Reference to all the axes in the chart.
axesCollectionChange
Fires when the value for the configuration attribute axesCollection
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
categoryKey
The key value used for the chart's category axis.
Default: category
categoryKeyChange
Fires when the value for the configuration attribute categoryKey
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
categoryType
Indicates the type of axis to use for the category axis.
CategoryAxis
.Default: category
categoryTypeChange
Fires when the value for the configuration attribute categoryType
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
dataProvider
Data used to generate the chart.
dataProviderChange
Fires when the value for the configuration attribute dataProvider
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
graph
Reference to graph instance.
graphChange
Fires when the value for the configuration attribute graph
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
groupMarkers
Indicates whether or not markers for a series will be grouped and rendered in a single complex shape instance.
groupMarkersChange
Fires when the value for the configuration attribute groupMarkers
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
interactionType
Indicates the the type of interactions that will fire events.
Default: marker
interactionTypeChange
Fires when the value for the configuration attribute interactionType
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
seriesCollection
Collection of series to appear on the chart. This can be an array of Series instances or object literals used to describe a Series instance.
seriesCollectionChange
Fires when the value for the configuration attribute seriesCollection
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
seriesKeys
A collection of keys that map to the series axes. If no keys are set, they will be generated automatically depending on the data structure passed into the chart.
seriesKeysChange
Fires when the value for the configuration attribute seriesKeys
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
tooltip
Reference to the default tooltip available for the chart.
Contains the following properties:
CartesianSeries
instance of the item.seriesCollection
.HTMLElement
which is written into the DOM using appendChild
. If you override this method and choose
to return an html string, you will also need to override the tooltip's setTextFunction
method to accept an html string.
CategoryAxis
Reference to the categoryAxis of the chart.
seriesCollection
.HTMLElement
which is written into the DOM using appendChild
. If you override this method and choose
to return an html string, you will also need to override the tooltip's setTextFunction
method to accept an html string.
planarLabelFunction
or markerLabelFunction
into the
the tooltip node. Has the following signature:
HTMLElement
that the content is to be added.String
or HTMLElement
. If an HTML string is used,
it will be rendered as a string.tooltipChange
Fires when the value for the configuration attribute tooltip
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
type
Type of chart when there is no series collection specified.
typeChange
Fires when the value for the configuration attribute type
is
changed. You can listen for the event using the on
method if you
wish to be notified before the attribute's value has changed, or
using the after
method if you wish to be notified after the
attribute's value has changed.
e
EventFacade
markerEvent:click
Broadcasts when interactionType
is set to marker
and a series marker has received a click event.
e
EventFacade
Event facade with the following additional properties:
Axis
.Axis
.order
of the marker's series.markerEvent:mousedown
Broadcasts when interactionType
is set to marker
and a series marker has received a mousedown event.
e
EventFacade
Event facade with the following additional properties:
Axis
.Axis
.order
of the marker's series.markerEvent:mouseout
Broadcasts when interactionType
is set to marker
and a series marker has received a mouseout event.
e
EventFacade
Event facade with the following additional properties:
Axis
.Axis
.order
of the marker's series.markerEvent:mouseover
Broadcasts when interactionType
is set to marker
and a series marker has received a mouseover event.
e
EventFacade
Event facade with the following additional properties:
Axis
.Axis
.order
of the marker's series.markerEvent:mouseup
Broadcasts when interactionType
is set to marker
and a series marker has received a mouseup event.
e
EventFacade
Event facade with the following additional properties:
Axis
.Axis
.order
of the marker's series.