com.vaadin.flow.component.charts.model.
Class PlotOptionsFunnel
- java.lang.Object
-
- com.vaadin.flow.component.charts.model.AbstractConfigurationObject
-
- com.vaadin.flow.component.charts.model.AbstractPlotOptions
-
- com.vaadin.flow.component.charts.model.PyramidOptions
-
- com.vaadin.flow.component.charts.model.PlotOptionsFunnel
-
All Implemented Interfaces:
public class PlotOptionsFunnel extends PyramidOptions
Funnel charts are a type of chart often used to visualize stages in a sales project, where the top are the initial stages with the most clients. It requires that the
modules/funnel.js
file is loaded.See Also:
-
-
Constructor Summary
Constructors Constructor and Description PlotOptionsFunnel()
-
Method Summary
All Methods Modifier and Type Method and Description void
addColor(Color color)
Adds color to the colors array
void
addKey(String key)
Adds key to the keys array
void
addZone(Zones zone)
Adds zone to the zones array
Boolean
getAllowPointSelect()
Number
getAnimationLimit()
String[]
getCenter()
ChartType
getChartType()
String
getClassName()
Number
getColorIndex()
Color[]
getColors()
Cursor
getCursor()
DataLabelsFunnel
getDataLabels()
Number
getDepth()
String
getDescription()
Boolean
getEnableMouseTracking()
Boolean
getExposeElementToA11y()
Dimension
getFindNearestPointBy()
Boolean
getGetExtremesFromAll()
String
getHeight()
String[]
getKeys()
String
getLinkedTo()
Number
getMinSize()
String
getNeckHeight()
String
getNeckWidth()
String
getPointDescriptionFormatter()
Boolean
getReversed()
Boolean
getSelected()
Boolean
getShadow()
Boolean
getShowInLegend()
Boolean
getSkipKeyboardNavigation()
Number
getSlicedOffset()
States
getStates()
Boolean
getStickyTracking()
SeriesTooltip
getTooltip()
Boolean
getVisible()
String
getWidth()
ZoneAxis
getZoneAxis()
Zones[]
getZones()
void
removeColor(Color color)
Removes first occurrence of color in colors array
void
removeKey(String key)
Removes first occurrence of key in keys array
void
removeZone(Zones zone)
Removes first occurrence of zone in zones array
void
setAllowPointSelect(Boolean allowPointSelect)
Allow this series' points to be selected by clicking on the markers, bars or pie slices.
void
setAnimationLimit(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.
void
setCenter(String[] center)
The center of the series.
void
setCenter(String x, String y)
void
setClassName(String className)
A class name to apply to the series' graphical elements.
void
setColorIndex(Number colorIndex)
Styled mode only.
void
setColors(Color... colors)
A series specific or series type specific color set to use instead of the global colors.
void
setCursor(Cursor cursor)
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.
void
setDataLabels(DataLabelsFunnel dataLabels)
Specific data labels configuration for a series type
void
setDepth(Number depth)
The thickness of a 3D pie.
void
setDescription(String description)
Requires Accessibility module
void
setEnableMouseTracking(Boolean enableMouseTracking)
Enable or disable the mouse tracking for a specific series.
void
setExposeElementToA11y(Boolean exposeElementToA11y)
By default, series are exposed to screen readers as regions.
void
setFindNearestPointBy(Dimension findNearestPointBy)
Determines whether the series should look for the nearest point in both dimensions or just the x-dimension when hovering the series.
void
setGetExtremesFromAll(Boolean getExtremesFromAll)
Whether to use the Y extremes of the total chart width or only the zoomed area when zooming in on parts of the X axis.
void
setHeight(String height)
The height of the funnel or pyramid.
void
setKeys(String... keys)
An array specifying which option maps to which key in the data point array.
void
setLinkedTo(String linkedTo)
The id of another series to link to.
void
setMinSize(Number minSize)
The minimum size for a pie in response to auto margins.
void
setNeckHeight(String neckHeight)
The height of the neck, the lower part of the funnel.
void
setNeckWidth(String neckWidth)
The width of the neck, the lower part of the funnel.
void
setPointDescriptionFormatter(String _fn_pointDescriptionFormatter)
void
setReversed(Boolean reversed)
A reversed funnel has the widest area down.
void
setSelected(Boolean selected)
Whether to select the series initially.
void
setShadow(Boolean shadow)
Whether to apply a drop shadow to the graph line.
void
setShowInLegend(Boolean showInLegend)
Whether to display this particular series or series type in the legend.
void
setSkipKeyboardNavigation(Boolean skipKeyboardNavigation)
If set to
True
, the accessibility module will skip past the points in this series for keyboard navigation.void
setSlicedOffset(Number slicedOffset)
If a point is sliced, moved out from the center, how many pixels should it be moved?.
void
setStates(States states)
A wrapper object for all the series options in specific states.
void
setStickyTracking(Boolean stickyTracking)
Sticky tracking of mouse events.
void
setTooltip(SeriesTooltip tooltip)
A configuration object for the tooltip rendering of each single series.
void
setVisible(Boolean visible)
Set the initial visibility of the series.
void
setWidth(String width)
The width of the funnel compared to the width of the plot area, or the pixel width if it is a number.
void
setZoneAxis(ZoneAxis zoneAxis)
Defines the Axis on which the zones are applied.
void
setZones(Zones... zones)
An array defining zones within a series.
-
-
-
Method Detail
-
getChartType
public ChartType getChartType()
Specified by:
getChartType
in classPyramidOptions
-
getAllowPointSelect
public Boolean getAllowPointSelect()
Specified by:
getAllowPointSelect
in classPyramidOptions
See Also:
-
setAllowPointSelect
public void setAllowPointSelect(Boolean allowPointSelect)
Allow this series' points to be selected by clicking on the markers, bars or pie slices.
Defaults to: false
Specified by:
setAllowPointSelect
in classPyramidOptions
-
getAnimationLimit
public Number getAnimationLimit()
Specified by:
getAnimationLimit
in classPyramidOptions
See Also:
-
setAnimationLimit
public void setAnimationLimit(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. 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, set
animationLimit
toInfinity
.Specified by:
setAnimationLimit
in classPyramidOptions
-
setCenter
public void setCenter(String[] center)
The center of the series. By default, it is centered in the middle of the plot area, so it fills the plot area height.
Defaults to: ["50%", "50%"]
Specified by:
setCenter
in classPyramidOptions
-
getClassName
public String getClassName()
Specified by:
getClassName
in classPyramidOptions
See Also:
-
setClassName
public void setClassName(String className)
A class name to apply to the series' graphical elements.
Specified by:
setClassName
in classPyramidOptions
-
getColorIndex
public Number getColorIndex()
Specified by:
getColorIndex
in classPyramidOptions
See Also:
-
setColorIndex
public void setColorIndex(Number colorIndex)
Styled mode only. A specific color index to use for the series, so its graphic representations are given the class name
highcharts-color-{n}
.Specified by:
setColorIndex
in classPyramidOptions
-
getColors
public Color[] getColors()
See Also:
-
setColors
public void setColors(Color... colors)
A series specific or series type specific color set to use instead of the global colors.
-
addColor
public void addColor(Color color)
Adds color to the colors array
Parameters:
color
- to addSee Also:
-
removeColor
public void removeColor(Color color)
Removes first occurrence of color in colors array
Parameters:
color
- to removeSee Also:
-
getCursor
public Cursor getCursor()
Specified by:
getCursor
in classPyramidOptions
See Also:
-
setCursor
public void setCursor(Cursor cursor)
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.
Specified by:
setCursor
in classPyramidOptions
-
getDataLabels
public DataLabelsFunnel getDataLabels()
Specified by:
getDataLabels
in classPyramidOptions
See Also:
-
setDataLabels
public void setDataLabels(DataLabelsFunnel dataLabels)
Description copied from class:
PyramidOptions
Specific data labels configuration for a series type
Specified by:
setDataLabels
in classPyramidOptions
-
getDepth
public Number getDepth()
Specified by:
getDepth
in classPyramidOptions
See Also:
-
setDepth
public void setDepth(Number depth)
The thickness of a 3D pie. Requires
highcharts-3d.js
Defaults to: 0
Specified by:
setDepth
in classPyramidOptions
-
getDescription
public String getDescription()
Specified by:
getDescription
in classPyramidOptions
See Also:
-
setDescription
public void setDescription(String description)
Requires Accessibility module
A description of the series to add to the screen reader information about the series.
Defaults to: undefined
Specified by:
setDescription
in classPyramidOptions
-
getEnableMouseTracking
public Boolean getEnableMouseTracking()
Specified by:
getEnableMouseTracking
in classPyramidOptions
See Also:
-
setEnableMouseTracking
public void setEnableMouseTracking(Boolean enableMouseTracking)
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
Specified by:
setEnableMouseTracking
in classPyramidOptions
-
getExposeElementToA11y
public Boolean getExposeElementToA11y()
Specified by:
getExposeElementToA11y
in classPyramidOptions
See Also:
-
setExposeElementToA11y
public void setExposeElementToA11y(Boolean exposeElementToA11y)
By default, series are exposed to screen readers as regions. By enabling this option, the series element itself will be exposed in the same way as the data points. This is useful if the series is not used as a grouping entity in the chart, but you still want to attach a description to the series.
Requires the Accessibility module.
Defaults to: undefined
Specified by:
setExposeElementToA11y
in classPyramidOptions
-
getFindNearestPointBy
public Dimension getFindNearestPointBy()
Specified by:
getFindNearestPointBy
in classPyramidOptions
See Also:
-
setFindNearestPointBy
public void setFindNearestPointBy(Dimension findNearestPointBy)
Determines whether the series should look for the nearest point in both dimensions or just the x-dimension when hovering the series. Defaults to
'xy'
for scatter series and'x'
for most other series. If the data has duplicate x-values, it is recommended to set this to'xy'
to allow hovering over all points.Applies only to series types using nearest neighbor search (not direct hover) for tooltip.
Specified by:
setFindNearestPointBy
in classPyramidOptions
-
getGetExtremesFromAll
public Boolean getGetExtremesFromAll()
Specified by:
getGetExtremesFromAll
in classPyramidOptions
See Also:
-
setGetExtremesFromAll
public void setGetExtremesFromAll(Boolean getExtremesFromAll)
Whether to use the Y extremes of the total chart width or only the zoomed area when zooming in on parts of the X axis. By default, the Y axis adjusts to the min and max of the visible data. Cartesian series only.
Defaults to: false
Specified by:
setGetExtremesFromAll
in classPyramidOptions
-
getHeight
public String getHeight()
Specified by:
getHeight
in classPyramidOptions
See Also:
-
setHeight
public void setHeight(String height)
The height of the funnel or pyramid. If it is a number it defines the pixel height, if it is a percentage string it is the percentage of the plot area height.
Specified by:
setHeight
in classPyramidOptions
Parameters:
height
- CSS style string representation
-
getKeys
public String[] getKeys()
Specified by:
getKeys
in classPyramidOptions
See Also:
-
setKeys
public void setKeys(String... keys)
An array specifying which option maps to which key in the data point array. This makes it convenient to work with unstructured data arrays from different sources.
Specified by:
setKeys
in classPyramidOptions
-
addKey
public void addKey(String key)
Adds key to the keys array
Specified by:
addKey
in classPyramidOptions
Parameters:
key
- to addSee Also:
-
removeKey
public void removeKey(String key)
Removes first occurrence of key in keys array
Specified by:
removeKey
in classPyramidOptions
Parameters:
key
- to removeSee Also:
-
getLinkedTo
public String getLinkedTo()
Specified by:
getLinkedTo
in classPyramidOptions
See Also:
-
setLinkedTo
public void setLinkedTo(String linkedTo)
The id of another series to link to. Additionally, the value can be ":previous" to link to the previous series. When two series are linked, only the first one appears in the legend. Toggling the visibility of this also toggles the linked series.
Specified by:
setLinkedTo
in classPyramidOptions
-
getMinSize
public Number getMinSize()
Specified by:
getMinSize
in classPyramidOptions
See Also:
-
setMinSize
public void setMinSize(Number minSize)
The minimum size for a pie in response to auto margins. The pie will try to shrink to make room for data labels in side the plot area, but only to this size.
Defaults to: 80
Specified by:
setMinSize
in classPyramidOptions
-
getNeckHeight
public String getNeckHeight()
See Also:
-
setNeckHeight
public void setNeckHeight(String neckHeight)
The height of the neck, the lower part of the funnel. A number defines pixel width, a percentage string defines a percentage of the plot area height.
Defaults to: 25%
-
getNeckWidth
public String getNeckWidth()
See Also:
-
setNeckWidth
public void setNeckWidth(String neckWidth)
The width of the neck, the lower part of the funnel. A number defines pixel width, a percentage string defines a percentage of the plot area width.
Defaults to: 30%
-
getPointDescriptionFormatter
public String getPointDescriptionFormatter()
Specified by:
-
setPointDescriptionFormatter
public void setPointDescriptionFormatter(String _fn_pointDescriptionFormatter)
Specified by:
-
getReversed
public Boolean getReversed()
Specified by:
getReversed
in classPyramidOptions
See Also:
-
setReversed
public void setReversed(Boolean reversed)
A reversed funnel has the widest area down. A reversed funnel with no neck width and neck height is a pyramid.
Defaults to: false
Specified by:
setReversed
in classPyramidOptions
-
getSelected
public Boolean getSelected()
Specified by:
getSelected
in classPyramidOptions
See Also:
-
setSelected
public void setSelected(Boolean selected)
Whether to select the series initially. If
showCheckbox
is true, the checkbox next to the series name will be checked for a selected series.Defaults to: false
Specified by:
setSelected
in classPyramidOptions
-
getShadow
public Boolean getShadow()
Specified by:
getShadow
in classPyramidOptions
See Also:
-
setShadow
public void setShadow(Boolean shadow)
Whether to apply a drop shadow to the graph line. Since 2.3 the shadow can be an object configuration containing
color
,offsetX
,offsetY
,opacity
andwidth
.Defaults to: false
Specified by:
setShadow
in classPyramidOptions
-
getShowInLegend
public Boolean getShowInLegend()
Specified by:
getShowInLegend
in classPyramidOptions
See Also:
-
setShowInLegend
public void setShowInLegend(Boolean showInLegend)
Whether to display this particular series or series type in the legend. Since 2.1, pies are not shown in the legend by default.
Defaults to: false
Specified by:
setShowInLegend
in classPyramidOptions
-
getSkipKeyboardNavigation
public Boolean getSkipKeyboardNavigation()
Specified by:
getSkipKeyboardNavigation
in classPyramidOptions
See Also:
-
setSkipKeyboardNavigation
public void setSkipKeyboardNavigation(Boolean skipKeyboardNavigation)
If set to
True
, the accessibility module will skip past the points in this series for keyboard navigation.Specified by:
setSkipKeyboardNavigation
in classPyramidOptions
-
getSlicedOffset
public Number getSlicedOffset()
Specified by:
getSlicedOffset
in classPyramidOptions
See Also:
-
setSlicedOffset
public void setSlicedOffset(Number slicedOffset)
If a point is sliced, moved out from the center, how many pixels should it be moved?.
Defaults to: 10
Specified by:
setSlicedOffset
in classPyramidOptions
-
getStates
public States getStates()
Specified by:
getStates
in classPyramidOptions
See Also:
-
setStates
public void setStates(States states)
A wrapper object for all the series options in specific states.
Specified by:
setStates
in classPyramidOptions
-
getStickyTracking
public Boolean getStickyTracking()
Specified by:
getStickyTracking
in classPyramidOptions
See Also:
-
setStickyTracking
public void setStickyTracking(Boolean stickyTracking)
Sticky tracking of mouse events. When true, the
mouseOut
event on a series isn't triggered until the mouse moves over another series, or out of the plot area. When false, themouseOut
event on a series is triggered when the mouse leaves the area around the series' graph or markers. This also implies the tooltip. WhenstickyTracking
is false andtooltip.shared
is false, the tooltip will be hidden when moving the mouse between series.Defaults to: false
Specified by:
setStickyTracking
in classPyramidOptions
-
getTooltip
public SeriesTooltip getTooltip()
Specified by:
getTooltip
in classPyramidOptions
See Also:
-
setTooltip
public void setTooltip(SeriesTooltip tooltip)
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.
Specified by:
setTooltip
in classPyramidOptions
-
getVisible
public Boolean getVisible()
Specified by:
getVisible
in classPyramidOptions
See Also:
-
setVisible
public void setVisible(Boolean visible)
Set the initial visibility of the series.
Defaults to: true
Specified by:
setVisible
in classPyramidOptions
-
getWidth
public String getWidth()
Specified by:
getWidth
in classPyramidOptions
See Also:
-
setWidth
public void setWidth(String width)
The width of the funnel compared to the width of the plot area, or the pixel width if it is a number.
Defaults to: 90%
Specified by:
setWidth
in classPyramidOptions
Parameters:
width
- CSS style string representation
-
getZoneAxis
public ZoneAxis getZoneAxis()
Specified by:
getZoneAxis
in classPyramidOptions
See Also:
-
setZoneAxis
public void setZoneAxis(ZoneAxis zoneAxis)
Defines the Axis on which the zones are applied.
Defaults to: y
Specified by:
setZoneAxis
in classPyramidOptions
-
getZones
public Zones[] getZones()
Specified by:
getZones
in classPyramidOptions
See Also:
-
setZones
public void setZones(Zones... zones)
An array defining zones within a series. Zones can be applied to the X axis, Y axis or Z axis for bubbles, according to the
zoneAxis
option.In styled mode, the color zones are styled with the
.highcharts-zone-{n}
class, or custom classed from theclassName
option (view live demo).Specified by:
setZones
in classPyramidOptions
-
addZone
public void addZone(Zones zone)
Adds zone to the zones array
Specified by:
addZone
in classPyramidOptions
Parameters:
zone
- to addSee Also:
-
removeZone
public void removeZone(Zones zone)
Removes first occurrence of zone in zones array
Specified by:
removeZone
in classPyramidOptions
Parameters:
zone
- to removeSee Also:
-
setCenter
public void setCenter(String x, String y)
Specified by:
setCenter
in classPyramidOptions
-
getCenter
public String[] getCenter()
Specified by:
getCenter
in classPyramidOptions
-
-