Class PlotOptionsMapbubble
- All Implemented Interfaces:
Serializable
- Version:
- $Id: $Id
- Author:
- Vaadin
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionGetter for the fieldallAreas.Getter for the fieldallowPointSelect.Getter for the fieldanimation.Getter for the fieldanimationLimit.Getter for the fieldborderColor.Getter for the fieldborderWidth.getColor()Getter for the fieldcolor.Getter for the fieldcolorAxis.Getter for the fieldcursor.Getter for the fielddataLabels.Getter for the fielddisplayNegative.Getter for the fieldenableMouseTracking.getMapType.Getter for the fieldnegativeColor.Getter for the fieldselected.Getter for the fieldshadow.Getter for the fieldshowCheckbox.Getter for the fieldshowInLegend.Getter for the fieldsizeBy.Getter for the fieldsizeByAbsoluteValue.Getter for the fieldstates.Getter for the fieldstickyTracking.Getter for the fieldtooltip.Getter for the fieldvisible.Getter for the fieldzIndex.getZMax()Getter for the fieldzMax.getZMin()Getter for the fieldzMin.Getter for the fieldzThreshold.voidsetAllAreas(Boolean allAreas) Whether all areas of the map defined inmapDatashould be rendered.voidsetAllowPointSelect(Boolean allowPointSelect) Allow this series' points to be selected by clicking on the shapes.voidsetAnimation(Boolean animation) Enable or disable the initial animation when a series is displayed.voidsetAnimationLimit(Number animationLimit) For some series, there is a limit that shuts down initial animation by default when the total number of points in the chart is too high.voidsetBorderColor(Color borderColor) The border color of the map areas.voidsetBorderWidth(Number borderWidth) The border width of each map area.voidThe main color of the series.voidsetColorAxis(ColorAxis colorAxis) Set this option tofalseto prevent a series from connecting to the global color axis.voidYou can set the cursor to "pointer" if you have click events attached to the series, to signal to the user that the points and lines can be clicked.voidsetDataLabels(DataLabels dataLabels) Setter for the fielddataLabels.voidsetDisplayNegative(Boolean displayNegative) Whether to display negative sized bubbles.voidsetEnableMouseTracking(Boolean enableMouseTracking) Enable or disable the mouse tracking for a specific series.voidsetNegativeColor(Color negativeColor) When a point's Z value is below the zThreshold setting, this color is used.voidsetSelected(Boolean selected) Whether to select the series initially.voidWhether to apply a drop shadow to the shapes.voidsetShowCheckbox(Boolean showCheckbox) If true, and the series has a unique legend item, a checkbox is displayed next to the legend item to allow selecting the series.voidsetShowInLegend(Boolean showInLegend) Whether to display this particular series or series type in the legend.voidWhether the bubble's value should be represented by the area or the width of the bubble.voidsetSizeByAbsoluteValue(Boolean sizeByAbsoluteValue) When this is true, the absolute value of z determines the size of the bubble.voidA wrapper object for all the series options in specific states.voidsetStickyTracking(Boolean stickyTracking) Sticky tracking of mouse events.voidsetTooltip(SeriesTooltip tooltip) A configuration object for the tooltip rendering of each single series.voidsetVisible(Boolean visible) Set the initial visibility of the series.voidDefine the z index of the series.voidThe minimum for the Z value range.voidThe minimum for the Z value range.voidsetZThreshold(Number zThreshold) When displayNegative isfalse, bubbles with lower Z values are skipped.
-
Constructor Details
-
PlotOptionsMapbubble
public PlotOptionsMapbubble()Constructor for PlotOptionsMapbubble.
-
-
Method Details
-
getMapType
getMapType.
- Overrides:
getMapTypein classAbstractPlotOptions- Returns:
- a
MapTypeobject.
-
getAllAreas
Getter for the field
allAreas.- Returns:
- a
Booleanobject. - See Also:
-
setAllAreas
Whether all areas of the map defined inmapDatashould be rendered. Iftrue, areas which don't correspond to a data point, are rendered asnullpoints. Iffalse, those areas are skipped.Defaults to: true
- Parameters:
allAreas- aBooleanobject.
-
getAllowPointSelect
Getter for the field
allowPointSelect.- Returns:
- a
Booleanobject. - See Also:
-
setAllowPointSelect
Allow this series' points to be selected by clicking on the shapes. Selected points can be read through the Chart.getSelectedPoints() method.Defaults to: false
- Parameters:
allowPointSelect- aBooleanobject.
-
getAnimation
Getter for the field
animation.- Returns:
- a
Booleanobject. - See Also:
-
setAnimation
Enable or disable the initial animation when a series is displayed. The animation can also be set as a configuration object. Please note that this option only applies to the initial animation of the series itself. For other animations, see chart.animation and the animation parameter under the API methods. The following properties are supported:
- duration
- The duration of the animation in milliseconds.
- easing
- A string reference to an easing function set on the
Mathobject. See the easing demo.
Due to poor performance, animation is disabled in old IE browsers for map series, but enabled on mapbubble series.
Defaults to: false
- Parameters:
animation- aBooleanobject.
-
getAnimationLimit
Getter for the field
animationLimit.- Returns:
- a
Numberobject. - See Also:
-
setAnimationLimit
For some series, there is a limit that shuts down initial animation by default when the total number of points in the chart is too high. For example, for a column chart and its derivatives, animation doesn't run if there is more than 250 points totally. To disable this cap, setanimationLimittoInfinity.- Parameters:
animationLimit- aNumberobject.
-
getBorderColor
Getter for the field
borderColor.- Returns:
- a
Colorobject. - See Also:
-
setBorderColor
The border color of the map areas.Defaults to: silver
- Parameters:
borderColor- aColorobject.
-
getBorderWidth
Getter for the field
borderWidth.- Returns:
- a
Numberobject. - See Also:
-
setBorderWidth
The border width of each map area.Defaults to: 1
- Parameters:
borderWidth- aNumberobject.
-
getColor
Getter for the field
color.- Returns:
- a
Colorobject. - See Also:
-
setColor
The main color of the series. This color affects both the fill and the stroke of the bubble. For enhanced control, usemarkeroptions.- Parameters:
color- aColorobject.
-
getColorAxis
Getter for the field
colorAxis.- Returns:
- a
ColorAxisobject. - See Also:
-
setColorAxis
Set this option tofalseto prevent a series from connecting to the global color axis. This will cause the series to have its own legend item.Defaults to: undefined
- Parameters:
colorAxis- aColorAxisobject.
-
getCursor
Getter for the field
cursor.- Returns:
- a
Cursorobject. - See Also:
-
setCursor
You can set the cursor to "pointer" if you have click events attached to the series, to signal to the user that the points and lines can be clicked.- Parameters:
cursor- aCursorobject.
-
getDataLabels
Getter for the field
dataLabels.- Returns:
- a
DataLabelsobject. - See Also:
-
setDataLabels
Setter for the field
dataLabels.- Parameters:
dataLabels- aDataLabelsobject.
-
getDisplayNegative
Getter for the field
displayNegative.- Returns:
- a
Booleanobject. - See Also:
-
setDisplayNegative
Whether to display negative sized bubbles. The threshold is given by the zThreshold option, and negative bubbles can be visualized by setting negativeColor.Defaults to: true
- Parameters:
displayNegative- aBooleanobject.
-
getEnableMouseTracking
Getter for the field
enableMouseTracking.- Returns:
- a
Booleanobject. - See Also:
-
setEnableMouseTracking
Enable or disable the mouse tracking for a specific series. This includes point tooltips and click events on graphs and points. For large datasets it improves performance.Defaults to: true
- Parameters:
enableMouseTracking- aBooleanobject.
-
getNegativeColor
Getter for the field
negativeColor.- Returns:
- a
Colorobject. - See Also:
-
setNegativeColor
When a point's Z value is below the zThreshold setting, this color is used.Defaults to: null
- Parameters:
negativeColor- aColorobject.
-
getSelected
Getter for the field
selected.- Returns:
- a
Booleanobject. - See Also:
-
setSelected
Whether to select the series initially. IfshowCheckboxis true, the checkbox next to the series name will be checked for a selected series.Defaults to: false
- Parameters:
selected- aBooleanobject.
-
getShadow
Getter for the field
shadow.- Returns:
- a
Booleanobject. - See Also:
-
setShadow
Whether to apply a drop shadow to the shapes. The shadow can be an object configuration containingcolor,offsetX,offsetY,opacityandwidth.Defaults to: false
- Parameters:
shadow- aBooleanobject.
-
getShowCheckbox
Getter for the field
showCheckbox.- Returns:
- a
Booleanobject. - See Also:
-
setShowCheckbox
If true, and the series has a unique legend item, a checkbox is displayed next to the legend item to allow selecting the series. The state of the checkbox is determined by theselectedoption. Note that if a colorAxis is defined, the color axis is represented in the legend, not the series.Defaults to: false
- Parameters:
showCheckbox- aBooleanobject.
-
getShowInLegend
Getter for the field
showInLegend.- Returns:
- a
Booleanobject. - See Also:
-
setShowInLegend
Whether to display this particular series or series type in the legend. Note that if a colorAxis is defined, the color axis is represented in the legend, not the series.Defaults to: true
- Parameters:
showInLegend- aBooleanobject.
-
getSizeBy
Getter for the field
sizeBy.- Returns:
- a
Stringobject. - See Also:
-
setSizeBy
Whether the bubble's value should be represented by the area or the width of the bubble. The default,area, corresponds best to the human perception of the size of each bubble.Defaults to: area
- Parameters:
sizeBy- aStringobject.
-
getSizeByAbsoluteValue
Getter for the field
sizeByAbsoluteValue.- Returns:
- a
Booleanobject. - See Also:
-
setSizeByAbsoluteValue
When this is true, the absolute value of z determines the size of the bubble. This means that with the defaultzThresholdof 0, a bubble of value -1 will have the same size as a bubble of value 1, while a bubble of value 0 will have a smaller size according tominSize.Defaults to: false
- Parameters:
sizeByAbsoluteValue- aBooleanobject.
-
getStates
Getter for the field
states.- Returns:
- a
Statesobject. - See Also:
-
setStates
A wrapper object for all the series options in specific states.- Parameters:
states- aStatesobject.
-
getStickyTracking
Getter for the field
stickyTracking.- Returns:
- a
Booleanobject. - See Also:
-
setStickyTracking
Sticky tracking of mouse events. When true, themouseOutevent on a series isn't triggered until the mouse moves over another series, or out of the plot area. When false, themouseOutevent on a series is triggered when the mouse leaves the area around the series' graph or markers. This also implies the tooltip. WhenstickyTrackingis false andtooltip.sharedis false, the tooltip will be hidden when moving the mouse between series.Defaults to: false
- Parameters:
stickyTracking- aBooleanobject.
-
getTooltip
Getter for the field
tooltip.- Returns:
- a
SeriesTooltipobject. - See Also:
-
setTooltip
A configuration object for the tooltip rendering of each single series. Properties are inherited from tooltip, but only the following properties can be defined on a series level.- Parameters:
tooltip- aSeriesTooltipobject.
-
getVisible
Getter for the field
visible.- Returns:
- a
Booleanobject. - See Also:
-
setVisible
Set the initial visibility of the series.Defaults to: true
- Parameters:
visible- aBooleanobject.
-
getZIndex
Getter for the field
zIndex.- Returns:
- a
Numberobject. - See Also:
-
setZIndex
Define the z index of the series.- Parameters:
zIndex- aNumberobject.
-
getZMax
Getter for the field
zMax.- Returns:
- a
Numberobject. - See Also:
-
setZMax
The minimum for the Z value range. Defaults to the highest Z value in the data.Defaults to: null
- Parameters:
zMax- aNumberobject.
-
getZMin
Getter for the field
zMin.- Returns:
- a
Numberobject. - See Also:
-
setZMin
The minimum for the Z value range. Defaults to the lowest Z value in the data.Defaults to: null
- Parameters:
zMin- aNumberobject.
-
getZThreshold
Getter for the field
zThreshold.- Returns:
- a
Numberobject. - See Also:
-
setZThreshold
When displayNegative isfalse, bubbles with lower Z values are skipped. WhendisplayNegativeistrueand a negativeColor is given, points with lower Z is colored.Defaults to: 0
- Parameters:
zThreshold- aNumberobject.
-