API Docs for: 3.8.0
Show:

PieSeries Class

Module: charts-base
Parent Module: charts

PieSeries visualizes data as a circular chart divided into wedges which represent data as a percentage of a whole.

Methods

_addHotspot

(
  • cfg
  • seriesIndex
  • index
)
private

Adds an interactive map when rendering in canvas.

Parameters:

  • cfg Object

    Object containing data used to draw the hotspot

  • seriesIndex Number

    Index of series in the seriesCollection.

  • index Number

    Index of the marker using the hotspot.

_categoryAxisChangeHandler

(
  • e
)
private

Event handler for the categoryAxisChange event.

Parameters:

_categoryDataChangeHandler

(
  • event
)
private

Event handler for categoryDataChange event.

Parameters:

_createMarker

(
  • styles
  • order
  • index
)
private

Creates a shape to be used as a marker.

Parameters:

  • styles Object

    Hash of style properties.

  • order Number

    Order of the series.

  • index Number

    Index within the series associated with the marker.

Returns:

Shape

_createMarkerCache

() private

Creates a cache of markers for reuse.

_getDefaultColor

(
  • index
  • type
)
protected

Colors used if style colors are not specified

Parameters:

  • index Number

    Index indicating the series order.

  • type String

    Indicates which type of object needs the color.

Returns:

String

_getPlotDefaults

() private

Gets the default style values for the markers.

Returns:

Object

_redraw

() private

Provided by the charts module.

Defined in charts/js/PieChartLegend.js:2

Redraws the chart instance.

_setMap

() private

Creates or updates the image map when rendered with canvas.

_valueAxisChangeHandler

(
  • e
)
private

Event handler for the valueAxisChange event.

Parameters:

_valueDataChangeHandler

(
  • event
)
private

Event handler for valueDataChange event.

Parameters:

addListeners

() private

Adds event listeners.

draw

() protected

Draws the series. Overrides the base implementation.

drawPlots

() protected

Draws the markers

updateMarkerState

(
  • type
  • i
)
protected

Resizes and positions markers based on a mouse interaction.

Parameters:

  • type String

    state of the marker

  • i Number

    index of the marker

validate

() private

Draws the series.

Properties

_categoryDisplayName

Unknown private

Storage for categoryDisplayName attribute.

_defaultBorderColors

Array protected

Collection of default colors used for marker borders in a series when not specified by user.

_defaultFillColors

Array protected

Collection of default colors used for marker fills in a series when not specified by user.

_defaultLineColors

Array protected

Collection of default colors used for lines in a series when not specified by user.

_defaultSliceColors

Array protected

Collection of default colors used for area fills, histogram fills and pie fills in a series when not specified by user.

_image

HTMLElement private

Image used for image map when rendered with canvas.

_map

HTMLElement private

Image map used for interactivity when rendered with canvas.

_valueDisplayName

Unknown private

Storage for valueDisplayName attribute.

GUID

String private

Constant used to generate unique id.

Attributes

categoryKey

String

Indicates which array to from the hash of value arrays in the category Axis instance.

Fires event 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

Legend

Provided by the charts module.

Defined in charts/js/PieChartLegend.js:123

The legend for the chart.

Fires event Change

Fires when the value for the configuration attribute `` 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

order

Number

Order of this instance of this type.

Fires event orderChange

Fires when the value for the configuration attribute order 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

graph

Graph

Reference to the Graph in which the series is drawn into.

Fires event 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

categoryAxis

Axis

Reference to the Axis instance used for assigning category values to the graph.

Fires event categoryAxisChange

Fires when the value for the configuration attribute categoryAxis 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

categoryAxis

Axis

Reference to the Axis instance used for assigning series values to the graph.

Fires event categoryAxisChange

Fires when the value for the configuration attribute categoryAxis 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

type

String

Read-only attribute indicating the type of series.

Default: pie

Fires event 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

valueKey

String

Indicates which array to from the hash of value arrays in the value Axis instance.

Fires event valueKeyChange

Fires when the value for the configuration attribute valueKey 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

categoryDisplayName

String

Name used for for displaying category data

Fires event categoryDisplayNameChange

Fires when the value for the configuration attribute categoryDisplayName 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

valueDisplayName

String

Name used for for displaying value data

Fires event valueDisplayNameChange

Fires when the value for the configuration attribute valueDisplayName 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

slices

Array private

Fires event slicesChange

Fires when the value for the configuration attribute slices 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

styles

Object

Style properties used for drawing markers. This attribute is inherited from MarkerSeries. Below are the default values:

fill
A hash containing the following values:
colors
An array of colors to be used for the marker fills. The color for each marker is retrieved from the array below:
["#66007f", "#a86f41", "#295454", "#996ab2", "#e8cdb7", "#90bdbd","#000000","#c3b8ca", "#968373", "#678585"]
alphas
An array of alpha references (Number from 0 to 1) indicating the opacity of each marker fill. The default value is [1].
border
A hash containing the following values:
color
An array of colors to be used for the marker borders. The color for each marker is retrieved from the array below:
["#205096", "#b38206", "#000000", "#94001e", "#9d6fa0", "#e55b00", "#5e85c9", "#adab9e", "#6ac291", "#006457"]
alpha
Number from 0 to 1 indicating the opacity of the marker border. The default value is 1.
weight
Number indicating the width of the border. The default value is 1.
over
hash containing styles for markers when highlighted by a mouseover event. The default values for each style is null. When an over style is not set, the non-over value will be used. For example, the default value for marker.over.fill.color is equivalent to marker.fill.color.

Fires event stylesChange

Fires when the value for the configuration attribute styles 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.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.