public class PlotOptionsBar extends ColumnOptions
Constructor and Description |
---|
PlotOptionsBar() |
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() |
Boolean |
getAnimation() |
Number |
getAnimationLimit() |
Color |
getBorderColor() |
Number |
getBorderRadius() |
Number |
getBorderWidth() |
ChartType |
getChartType() |
String |
getClassName() |
Boolean |
getClip() |
Color |
getColor() |
Boolean |
getColorByPoint() |
Number |
getColorIndex() |
String |
getColorKey() |
Color[] |
getColors() |
Boolean |
getCrisp() |
Number |
getCropThreshold() |
Cursor |
getCursor() |
DataLabels |
getDataLabels() |
Number |
getDepth() |
String |
getDescription() |
Color |
getEdgeColor() |
Number |
getEdgeWidth() |
Boolean |
getEnableMouseTracking() |
Boolean |
getExposeElementToA11y() |
Dimension |
getFindNearestPointBy() |
Boolean |
getGetExtremesFromAll() |
Boolean |
getGrouping() |
Number |
getGroupPadding() |
Number |
getGroupZPadding() |
String[] |
getKeys() |
String |
getLinkedTo() |
Number |
getMaxPointWidth() |
Number |
getMinPointLength() |
Color |
getNegativeColor() |
Number |
getOpacity() |
String |
getPointDescriptionFormatter() |
Number |
getPointInterval() |
IntervalUnit |
getPointIntervalUnit() |
Number |
getPointPadding() |
PointPlacement |
getPointPlacement() |
Number |
getPointRange() |
Number |
getPointStart() |
Number |
getPointWidth() |
Boolean |
getSelected() |
Boolean |
getShadow() |
Boolean |
getShowCheckbox() |
Boolean |
getShowInLegend() |
Boolean |
getSkipKeyboardNavigation() |
Boolean |
getSoftThreshold() |
Stacking |
getStacking() |
States |
getStates() |
Boolean |
getStickyTracking() |
Number |
getThreshold() |
SeriesTooltip |
getTooltip() |
Number |
getTurboThreshold() |
Boolean |
getVisible() |
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 |
setAnimation(Boolean animation)
Enable or disable the initial animation when a series is displayed.
|
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 |
setBorderColor(Color borderColor)
The color of the border surrounding each column or bar.
|
void |
setBorderRadius(Number borderRadius)
The corner radius of the border surrounding each column or bar.
|
void |
setBorderWidth(Number borderWidth)
The width of the border surrounding each column or bar.
|
void |
setClassName(String className)
A class name to apply to the series' graphical elements.
|
void |
setClip(Boolean clip)
Disable this option to allow series rendering in the whole plotting area.
|
void |
setColor(Color color)
The main color or the series.
|
void |
setColorByPoint(Boolean colorByPoint)
When using automatic point colors pulled from the
options.colors collection, this option determines whether
the chart should receive one color per series or one color per point. |
void |
setColorIndex(Number colorIndex)
Styled mode only.
|
void |
setColorKey(String colorKey)
Determines what data value should be used to calculate point color if
colorAxis is used. |
void |
setColors(Color... colors)
A series specific or series type specific color set to apply instead of
the global colors when
colorByPoint is true.
|
void |
setCrisp(Boolean crisp)
When true, each column edge is rounded to its nearest pixel in order to
render sharp on screen.
|
void |
setCropThreshold(Number cropThreshold)
When the series contains less points than the crop threshold, all points
are drawn, event if the points fall outside the visible plot area at the
current zoom.
|
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(DataLabels dataLabels) |
void |
setDepth(Number depth)
Depth of the columns in a 3D column chart.
|
void |
setDescription(String description)
Requires Accessibility module
|
void |
setEdgeColor(Color edgeColor)
3D columns only.
|
void |
setEdgeWidth(Number edgeWidth)
3D columns only.
|
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 |
setGrouping(Boolean grouping)
Whether to group non-stacked columns or to let them render independent of
each other.
|
void |
setGroupPadding(Number groupPadding)
Padding between each value groups, in x axis units.
|
void |
setGroupZPadding(Number groupZPadding)
The spacing between columns on the Z Axis in a 3D chart.
|
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 |
setMaxPointWidth(Number maxPointWidth)
The maximum allowed pixel width for a column, translated to the height of
a bar in a bar chart.
|
void |
setMinPointLength(Number minPointLength)
The minimal height for a column or width for a bar.
|
void |
setNegativeColor(Color negativeColor)
The color for the parts of the graph or points that are below the
threshold.
|
void |
setOpacity(Number opacity)
Opacity of a series parts: line, fill (e.g.
|
void |
setPointDescriptionFormatter(String _fn_pointDescriptionFormatter) |
void |
setPointInterval(Number pointInterval)
If no x values are given for the points in a series, pointInterval
defines the interval of the x values.
|
void |
setPointIntervalUnit(IntervalUnit pointIntervalUnit)
On datetime series, this allows for setting the
pointInterval to
irregular time units,
day , month and
year . |
void |
setPointPadding(Number pointPadding)
Padding between each column or bar, in x axis units.
|
void |
setPointPlacement(PointPlacement pointPlacement)
Possible values:
null , "on" ,
"between" . |
void |
setPointRange(Number pointRange)
The X axis range that each point is valid for.
|
void |
setPointStart(Date date)
Deprecated.
as of 4.0. Use
setPointStart(Instant) |
void |
setPointStart(Instant instant) |
void |
setPointStart(Number pointStart)
If no x values are given for the points in a series, pointStart defines
on what value to start.
|
void |
setPointWidth(Number pointWidth)
A pixel value specifying a fixed width for each column or bar.
|
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 |
setShowCheckbox(Boolean showCheckbox)
If true, a checkbox is displayed next to the legend item to allow
selecting the series.
|
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 |
setSoftThreshold(Boolean softThreshold)
When this is true, the series will not cause the Y axis to cross the zero
plane (or threshold option)
unless the data actually crosses the plane.
|
void |
setStacking(Stacking stacking)
Whether to stack the values of each series on top of each other.
|
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 |
setThreshold(Number threshold)
The Y axis value to serve as the base for the columns, for distinguishing
between values above and below a threshold.
|
void |
setTooltip(SeriesTooltip tooltip)
A configuration object for the tooltip rendering of each single series.
|
void |
setTurboThreshold(Number turboThreshold)
When a series contains a data array that is longer than this, only one
dimensional arrays of numbers, or two dimensional arrays with x and y
values are allowed.
|
void |
setVisible(Boolean visible)
Set the initial visibility of the series.
|
void |
setZoneAxis(ZoneAxis zoneAxis)
Defines the Axis on which the zones are applied.
|
void |
setZones(Zones... zones)
An array defining zones within a series.
|
public ChartType getChartType()
getChartType
in class AbstractPlotOptions
public Boolean getAllowPointSelect()
getAllowPointSelect
in class ColumnOptions
setAllowPointSelect(Boolean)
public void setAllowPointSelect(Boolean allowPointSelect)
Defaults to: false
setAllowPointSelect
in class ColumnOptions
public Boolean getAnimation()
getAnimation
in class ColumnOptions
setAnimation(Boolean)
public void setAnimation(Boolean animation)
ChartModel.setAnimation(Boolean)
setAnimation
in class ColumnOptions
public Number getAnimationLimit()
setAnimationLimit(Number)
public void setAnimationLimit(Number animationLimit)
animationLimit
to Infinity
.public Color getBorderColor()
getBorderColor
in class ColumnOptions
setBorderColor(Color)
public void setBorderColor(Color borderColor)
The color of the border surrounding each column or bar.
In styled mode, the border stroke can be set with the
.highcharts-point
rule.
Defaults to: #ffffff
setBorderColor
in class ColumnOptions
public Number getBorderRadius()
getBorderRadius
in class ColumnOptions
setBorderRadius(Number)
public void setBorderRadius(Number borderRadius)
Defaults to: 0
setBorderRadius
in class ColumnOptions
public Number getBorderWidth()
getBorderWidth
in class ColumnOptions
setBorderWidth(Number)
public void setBorderWidth(Number borderWidth)
The width of the border surrounding each column or bar.
In styled mode, the stroke width can be set with the
.highcharts-point
rule.
Defaults to: 1
setBorderWidth
in class ColumnOptions
public Boolean getClip()
getClip
in class ColumnOptions
setClip(Boolean)
public void setClip(Boolean clip)
Defaults to true
.
setClip
in class ColumnOptions
public String getClassName()
setClassName(String)
public void setClassName(String className)
public Color getColor()
setColor(Color)
public void setColor(Color color)
The main color or the series. In line type series it applies to the line
and the point markers unless otherwise specified. In bar type series it
applies to the bars unless a color is specified per point. The default
value is pulled from the options.colors
array.
In styled mode, the color can be defined by the
colorIndex option. Also, the
series color can be set with the .highcharts-series
,
.highcharts-color-{n}
,
.highcharts-{type}-series
or
.highcharts-series-{n}
class, or individual classes given by
the className
option.
public Boolean getColorByPoint()
getColorByPoint
in class ColumnOptions
setColorByPoint(Boolean)
public void setColorByPoint(Boolean colorByPoint)
options.colors
collection, this option determines whether
the chart should receive one color per series or one color per point.
Defaults to: false
setColorByPoint
in class ColumnOptions
public String getColorKey()
getColorKey
in class ColumnOptions
setColorKey(String)
public void setColorKey(String colorKey)
colorAxis
is used. Requires to set min
and
amx
if some custom point property is used or if
approximation for data grouping is set to 'sum'
.
Defaults to y
.
setColorKey
in class ColumnOptions
public Number getColorIndex()
setColorIndex(Number)
public void setColorIndex(Number colorIndex)
highcharts-color-{n}
.public Color[] getColors()
getColors
in class ColumnOptions
setColors(Color...)
public void setColors(Color... colors)
setColors
in class ColumnOptions
public void addColor(Color color)
addColor
in class ColumnOptions
color
- to addsetColors(Color...)
public void removeColor(Color color)
removeColor
in class ColumnOptions
color
- to removesetColors(Color...)
public Boolean getCrisp()
getCrisp
in class ColumnOptions
setCrisp(Boolean)
public void setCrisp(Boolean crisp)
crisp
to
false
may look better, even though each column is rendered
blurry.
Defaults to: true
setCrisp
in class ColumnOptions
public Number getCropThreshold()
setCropThreshold(Number)
public void setCropThreshold(Number cropThreshold)
Defaults to: 50
public Cursor getCursor()
getCursor
in class ColumnOptions
setCursor(Cursor)
public void setCursor(Cursor cursor)
setCursor
in class ColumnOptions
public DataLabels getDataLabels()
setDataLabels(DataLabels)
public void setDataLabels(DataLabels dataLabels)
public Number getDepth()
getDepth
in class ColumnOptions
setDepth(Number)
public void setDepth(Number depth)
highcharts-3d.js
.
Defaults to: 25
setDepth
in class ColumnOptions
public String getDescription()
setDescription(String)
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
public Color getEdgeColor()
getEdgeColor
in class ColumnOptions
setEdgeColor(Color)
public void setEdgeColor(Color edgeColor)
borderColor
, except it defaults to the same color as the
column.setEdgeColor
in class ColumnOptions
public Number getEdgeWidth()
getEdgeWidth
in class ColumnOptions
setEdgeWidth(Number)
public void setEdgeWidth(Number edgeWidth)
Defaults to: 1
setEdgeWidth
in class ColumnOptions
public Boolean getEnableMouseTracking()
getEnableMouseTracking
in class ColumnOptions
setEnableMouseTracking(Boolean)
public void setEnableMouseTracking(Boolean enableMouseTracking)
Defaults to: true
setEnableMouseTracking
in class ColumnOptions
public Boolean getExposeElementToA11y()
setExposeElementToA11y(Boolean)
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
public Dimension getFindNearestPointBy()
setFindNearestPointBy(Dimension)
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.
public Boolean getGetExtremesFromAll()
getGetExtremesFromAll
in class ColumnOptions
setGetExtremesFromAll(Boolean)
public void setGetExtremesFromAll(Boolean getExtremesFromAll)
Defaults to: false
setGetExtremesFromAll
in class ColumnOptions
public Number getGroupPadding()
getGroupPadding
in class ColumnOptions
setGroupPadding(Number)
public void setGroupPadding(Number groupPadding)
Defaults to: 0.2
setGroupPadding
in class ColumnOptions
public Number getGroupZPadding()
getGroupZPadding
in class ColumnOptions
setGroupZPadding(Number)
public void setGroupZPadding(Number groupZPadding)
highcharts-3d.js
.
Defaults to: 1
setGroupZPadding
in class ColumnOptions
public Boolean getGrouping()
getGrouping
in class ColumnOptions
setGrouping(Boolean)
public void setGrouping(Boolean grouping)
Defaults to: true
setGrouping
in class ColumnOptions
public String[] getKeys()
getKeys
in class ColumnOptions
setKeys(String...)
public void setKeys(String... keys)
setKeys
in class ColumnOptions
public void addKey(String key)
addKey
in class ColumnOptions
key
- to addsetKeys(String...)
public void removeKey(String key)
removeKey
in class ColumnOptions
key
- to removesetKeys(String...)
public String getLinkedTo()
getLinkedTo
in class ColumnOptions
setLinkedTo(String)
public void setLinkedTo(String linkedTo)
setLinkedTo
in class ColumnOptions
public Number getOpacity()
getOpacity
in class ColumnOptions
setOpacity(Number)
public void setOpacity(Number opacity)
Defaults to 1
.
setOpacity
in class ColumnOptions
public Number getMaxPointWidth()
getMaxPointWidth
in class ColumnOptions
setMaxPointWidth(Number)
public void setMaxPointWidth(Number maxPointWidth)
Defaults to: null
setMaxPointWidth
in class ColumnOptions
public Number getMinPointLength()
getMinPointLength
in class ColumnOptions
setMinPointLength(Number)
public void setMinPointLength(Number minPointLength)
Defaults to: 0
setMinPointLength
in class ColumnOptions
public Color getNegativeColor()
setNegativeColor(Color)
public void setNegativeColor(Color negativeColor)
Defaults to: null
public String getPointDescriptionFormatter()
public void setPointDescriptionFormatter(String _fn_pointDescriptionFormatter)
public Number getPointInterval()
getPointInterval
in class ColumnOptions
setPointInterval(Number)
public void setPointInterval(Number pointInterval)
If no x values are given for the points in a series, pointInterval defines the interval of the x values. For example, if a series contains one value every decade starting from year 0, set pointInterval to 10.
Since Highcharts 4.1, it can be combined with
pointIntervalUnit
to draw irregular intervals.
Defaults to: 1
setPointInterval
in class ColumnOptions
public IntervalUnit getPointIntervalUnit()
getPointIntervalUnit
in class ColumnOptions
setPointIntervalUnit(IntervalUnit)
public void setPointIntervalUnit(IntervalUnit pointIntervalUnit)
day
, month
and
year
. A day is usually the same as 24 hours, but
pointIntervalUnit also takes the DST crossover into consideration when
dealing with local time. Combine this option with
pointInterval
to draw weeks, quarters, 6 months, 10 years
etc.setPointIntervalUnit
in class ColumnOptions
public Number getPointPadding()
getPointPadding
in class ColumnOptions
setPointPadding(Number)
public void setPointPadding(Number pointPadding)
Defaults to: 0.1
setPointPadding
in class ColumnOptions
public PointPlacement getPointPlacement()
getPointPlacement
in class ColumnOptions
setPointPlacement(PointPlacement)
public void setPointPlacement(PointPlacement pointPlacement)
Possible values: null
, "on"
,
"between"
.
In a column chart, when pointPlacement is "on"
, the point
will not create any padding of the X axis. In a polar column chart this
means that the first column points directly north. If the pointPlacement
is "between"
, the columns will be laid out between ticks.
This is useful for example for visualising an amount between two points
in time or in a certain sector of a polar chart.
Since Highcharts 3.0.2, the point placement can also be numeric, where 0 is on the axis value, -0.5 is between this value and the previous, and 0.5 is between this value and the next. Unlike the textual options, numeric point placement options won't affect axis padding.
Note that pointPlacement needs a pointRange to work. For column series this is computed, but for line-type series it needs to be set.
Defaults to null
in cartesian charts, "between"
in polar charts.
setPointPlacement
in class ColumnOptions
public Number getPointRange()
getPointRange
in class ColumnOptions
setPointRange(Number)
public void setPointRange(Number pointRange)
setPointRange
in class ColumnOptions
public Number getPointStart()
getPointStart
in class ColumnOptions
setPointStart(Number)
public void setPointStart(Number pointStart)
Defaults to: 0
setPointStart
in class ColumnOptions
public Number getPointWidth()
getPointWidth
in class ColumnOptions
setPointWidth(Number)
public void setPointWidth(Number pointWidth)
null
, the width is calculated from the
pointPadding
and groupPadding
.setPointWidth
in class ColumnOptions
public Boolean getSelected()
getSelected
in class ColumnOptions
setSelected(Boolean)
public void setSelected(Boolean selected)
showCheckbox
is
true, the checkbox next to the series name will be checked for a selected
series.
Defaults to: false
setSelected
in class ColumnOptions
public Boolean getShadow()
getShadow
in class ColumnOptions
setShadow(Boolean)
public void setShadow(Boolean shadow)
color
,
offsetX
, offsetY
, opacity
and
width
.
Defaults to: false
setShadow
in class ColumnOptions
public Boolean getShowCheckbox()
getShowCheckbox
in class ColumnOptions
setShowCheckbox(Boolean)
public void setShowCheckbox(Boolean showCheckbox)
selected
option.
Defaults to: false
setShowCheckbox
in class ColumnOptions
public Boolean getShowInLegend()
getShowInLegend
in class ColumnOptions
setShowInLegend(Boolean)
public void setShowInLegend(Boolean showInLegend)
true
for standalone series,
false
for linked series.
Defaults to: true
setShowInLegend
in class ColumnOptions
public Boolean getSkipKeyboardNavigation()
setSkipKeyboardNavigation(Boolean)
public void setSkipKeyboardNavigation(Boolean skipKeyboardNavigation)
True
, the accessibility module will skip past the
points in this series for keyboard navigation.public Boolean getSoftThreshold()
setSoftThreshold(Boolean)
public void setSoftThreshold(Boolean softThreshold)
When this is true, the series will not cause the Y axis to cross the zero plane (or threshold option) unless the data actually crosses the plane.
For example, if softThreshold
is false
, a
series of 0, 1, 2, 3 will make the Y axis show negative values according
to the minPadding
option. If softThreshold
is
true
, the Y axis starts at 0.
Defaults to: true
public Stacking getStacking()
setStacking(Stacking)
public void setStacking(Stacking stacking)
public States getStates()
getStates
in class ColumnOptions
setStates(States)
public void setStates(States states)
setStates
in class ColumnOptions
public Boolean getStickyTracking()
getStickyTracking
in class ColumnOptions
setStickyTracking(Boolean)
public void setStickyTracking(Boolean stickyTracking)
mouseOut
event on a series isn't triggered until the mouse moves over another
series, or out of the plot area. When false, the mouseOut
event on a series is triggered when the mouse leaves the area around the
series' graph or markers. This also implies the tooltip. When
stickyTracking
is false and tooltip.shared
is
false, the tooltip will be hidden when moving the mouse between series.
Defaults to true for line and area type series, but to false for columns,
pies etc.
Defaults to: true
setStickyTracking
in class ColumnOptions
public Number getThreshold()
setThreshold(Number)
public void setThreshold(Number threshold)
null
, the
columns extend from the padding Y axis minimum.
Defaults to: 0
public SeriesTooltip getTooltip()
getTooltip
in class ColumnOptions
setTooltip(SeriesTooltip)
public void setTooltip(SeriesTooltip tooltip)
setTooltip
in class ColumnOptions
public Number getTurboThreshold()
setTurboThreshold(Number)
public void setTurboThreshold(Number turboThreshold)
0
disable.
Defaults to: 1000
public Boolean getVisible()
getVisible
in class ColumnOptions
setVisible(Boolean)
public void setVisible(Boolean visible)
Defaults to: true
setVisible
in class ColumnOptions
public ZoneAxis getZoneAxis()
getZoneAxis
in class ColumnOptions
setZoneAxis(ZoneAxis)
public void setZoneAxis(ZoneAxis zoneAxis)
Defaults to: y
setZoneAxis
in class ColumnOptions
public Zones[] getZones()
getZones
in class ColumnOptions
setZones(Zones...)
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 the
className
option (view live demo).
setZones
in class ColumnOptions
public void addZone(Zones zone)
addZone
in class ColumnOptions
zone
- to addsetZones(Zones...)
public void removeZone(Zones zone)
removeZone
in class ColumnOptions
zone
- to removesetZones(Zones...)
@Deprecated public void setPointStart(Date date)
setPointStart(Instant)
setPointStart
in class ColumnOptions
ColumnOptions.setPointStart(Number)
public void setPointStart(Instant instant)
setPointStart(Number)
Copyright © 2022. All rights reserved.