public class PlotOptionsFlags extends AbstractPlotOptions
Constructor and Description |
---|
PlotOptionsFlags() |
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() |
ChartType |
getChartType() |
String |
getClassName() |
Boolean |
getClip() |
Color |
getColor() |
Number |
getColorIndex() |
String |
getColorKey() |
Color[] |
getColors() |
Number |
getCompareBase() |
Boolean |
getCrisp() |
Number |
getCropThreshold() |
Cursor |
getCursor() |
String |
getDescription() |
Boolean |
getEnableMouseTracking() |
Boolean |
getExposeElementToA11y() |
Dimension |
getFindNearestPointBy() |
String |
getGapUnit() |
Boolean |
getGetExtremesFromAll() |
String[] |
getKeys() |
Number |
getLegendIndex() |
Color |
getLineColor() |
Number |
getLineWidth() |
String |
getLinkedTo() |
Number |
getMaxPointWidth() |
PlotOptionsSeries |
getNavigatorOptions() |
Color |
getNegativeColor() |
String |
getOnKey() |
String |
getOnSeries() |
Number |
getOpacity() |
String |
getPointDescriptionFormatter() |
IntervalUnit |
getPointIntervalUnit() |
Boolean |
getSelected() |
Boolean |
getShadow() |
FlagShape |
getShape() |
Boolean |
getShowCheckbox() |
Boolean |
getShowInLegend() |
Boolean |
getShowInNavigator() |
Boolean |
getSkipKeyboardNavigation() |
Boolean |
getSoftThreshold() |
Number |
getStackDistance() |
States |
getStates() |
Boolean |
getStickyTracking() |
Style |
getStyle() |
String |
getTextAlign() |
Number |
getThreshold() |
SeriesTooltip |
getTooltip() |
Boolean |
getUseHTML() |
Boolean |
getVisible() |
Number |
getY() |
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 or
bars.
|
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 |
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 of the series.
|
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 |
setCompareBase(Number compareBase)
When compare is
percent , this option dictates whether to use 0 or 100 as the
base of comparison. |
void |
setCrisp(Boolean crisp)
When true, each point or 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 |
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 |
setGapUnit(String gapUnit)
Together with
gapSize , this option defines where to draw
gaps in the graph. |
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 |
setKeys(String... keys)
An array specifying which option maps to which key in the data point
array.
|
void |
setLegendIndex(Number legendIndex)
The sequential index of the series within the legend.
|
void |
setLineColor(Color lineColor)
The color of the line/border of the flag.
|
void |
setLineWidth(Number lineWidth)
The pixel width of the candlestick line/border.
|
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 |
setNavigatorOptions(PlotOptionsSeries navigatorOptions)
Options for the corresponding navigator series if
showInNavigator is true for this series. |
void |
setNegativeColor(Color negativeColor)
The color for the parts of the graph or points that are below the
threshold.
|
void |
setOnKey(String onKey)
In case the flag is placed on a series, on what point key to place it.
|
void |
setOnSeries(String onSeries)
The id of the series that the flags should be drawn on.
|
void |
setOpacity(Number opacity)
Opacity of a series parts: line, fill (e.g.
|
void |
setPointDescriptionFormatter(String _fn_pointDescriptionFormatter) |
void |
setPointIntervalUnit(IntervalUnit pointIntervalUnit)
On datetime series, this allows for setting the
pointInterval to
irregular time units,
day , month and
year . |
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 |
setShape(FlagShape shape)
The shape of the marker.
|
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 |
setShowInNavigator(Boolean showInNavigator)
Whether or not to show the series in the navigator.
|
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 |
setStackDistance(Number stackDistance)
When multiple flags in the same series fall on the same value, this
number determines the vertical offset between them.
|
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 |
setStyle(Style style)
The text styles of the flag.
|
void |
setTextAlign(String textAlign)
Text alignment for the text inside the flag.
|
void |
setThreshold(Number threshold)
The threshold, also called zero level or base level.
|
void |
setTooltip(SeriesTooltip tooltip)
Specific tooltip options for flag series.
|
void |
setUseHTML(Boolean useHTML)
Whether to use HTML to render the flag texts.
|
void |
setVisible(Boolean visible)
Set the initial visibility of the series.
|
void |
setY(Number y)
The y position of the top left corner of the flag relative to either the
series (if onSeries is defined), or the x axis.
|
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()
setAllowPointSelect(Boolean)
public void setAllowPointSelect(Boolean allowPointSelect)
Defaults to: false
public Number getAnimationLimit()
setAnimationLimit(Number)
public void setAnimationLimit(Number animationLimit)
animationLimit
to Infinity
.public String getClassName()
setClassName(String)
public void setClassName(String className)
public Boolean getClip()
setClip(Boolean)
public void setClip(Boolean clip)
Defaults to true
.
public Color getColor()
setColor(Color)
public void setColor(Color color)
The main color of 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 Number getColorIndex()
setColorIndex(Number)
public void setColorIndex(Number colorIndex)
highcharts-color-{n}
.public String getColorKey()
setColorKey(String)
public void setColorKey(String colorKey)
colorAxis
is used. Requires to set min
and
max
if some custom point property is used or if
approximation for data grouping is set to 'sum'
.
Defaults to y
.
public Color[] getColors()
setColors(Color...)
public void setColors(Color... colors)
public void addColor(Color color)
color
- to addsetColors(Color...)
public void removeColor(Color color)
color
- to removesetColors(Color...)
public Number getCompareBase()
setCompareBase(Number)
public void setCompareBase(Number compareBase)
percent
, this option dictates whether to use 0 or 100 as the
base of comparison.
Defaults to: 0
public Boolean getCrisp()
setCrisp(Boolean)
public void setCrisp(Boolean crisp)
crisp
to false
may look better, even though each column is
rendered blurry.
Defaults to true
.
public Number getCropThreshold()
setCropThreshold(Number)
public void setCropThreshold(Number cropThreshold)
Defaults to: 50
public Cursor getCursor()
setCursor(Cursor)
public void setCursor(Cursor cursor)
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 Boolean getEnableMouseTracking()
setEnableMouseTracking(Boolean)
public void setEnableMouseTracking(Boolean enableMouseTracking)
Defaults to: true
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 String getGapUnit()
setGapUnit(String)
public void setGapUnit(String gapUnit)
gapSize
, this option defines where to draw
gaps in the graph.
Defaults to: relative
public Boolean getGetExtremesFromAll()
setGetExtremesFromAll(Boolean)
public void setGetExtremesFromAll(Boolean getExtremesFromAll)
Defaults to: false
public String[] getKeys()
setKeys(String...)
public void setKeys(String... keys)
public void addKey(String key)
key
- to addsetKeys(String...)
public void removeKey(String key)
key
- to removesetKeys(String...)
public Number getLegendIndex()
setLegendIndex(Number)
public void setLegendIndex(Number legendIndex)
Defaults to: 0
public Color getLineColor()
setLineColor(Color)
public void setLineColor(Color lineColor)
The color of the line/border of the flag.
In styled mode, the stroke is set in the
.highcharts-flag-series .highcharts-point
rule.
Defaults to: #000000
public Number getLineWidth()
setLineWidth(Number)
public void setLineWidth(Number lineWidth)
1
.
Defaults to: 1
public String getLinkedTo()
setLinkedTo(String)
public void setLinkedTo(String linkedTo)
public Number getMaxPointWidth()
setMaxPointWidth(Number)
public void setMaxPointWidth(Number maxPointWidth)
Defaults to: null
public PlotOptionsSeries getNavigatorOptions()
setNavigatorOptions(PlotOptionsSeries)
public void setNavigatorOptions(PlotOptionsSeries navigatorOptions)
Options for the corresponding navigator series if
showInNavigator
is true
for this series.
Available options are the same as any series, documented at
plotOptions and
series.
These options are merged with options in navigator.series, and will take precedence if the same option is defined both places.
Defaults to: undefined
public Color getNegativeColor()
setNegativeColor(Color)
public void setNegativeColor(Color negativeColor)
Defaults to: null
public String getOnKey()
setOnKey(String)
public void setOnKey(String onKey)
y
. In range or OHLC-type
series, however, the flag can optionally be placed on the
open
, high
, low
or
close
key.
Defaults to: y
public String getOnSeries()
setOnSeries(String)
public void setOnSeries(String onSeries)
Defaults to: undefined
public Number getOpacity()
setOpacity(Number)
public void setOpacity(Number opacity)
Defaults to 1
.
public String getPointDescriptionFormatter()
public void setPointDescriptionFormatter(String _fn_pointDescriptionFormatter)
public IntervalUnit getPointIntervalUnit()
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.public Boolean getSelected()
setSelected(Boolean)
public void setSelected(Boolean selected)
showCheckbox
is
true, the checkbox next to the series name in the legend will be checked
for a selected series.
Defaults to: false
public Boolean getShadow()
setShadow(Boolean)
public void setShadow(Boolean shadow)
color
,
offsetX
, offsetY
, opacity
and
width
.
Defaults to: false
public FlagShape getShape()
setShape(FlagShape)
public void setShape(FlagShape shape)
url(/path-to-image.jpg)
.
Individual shapes can also be set for each point.
Defaults to: flag
public Boolean getShowCheckbox()
setShowCheckbox(Boolean)
public void setShowCheckbox(Boolean showCheckbox)
selected
option.
Defaults to: false
public Boolean getShowInLegend()
setShowInLegend(Boolean)
public void setShowInLegend(Boolean showInLegend)
true
for standalone series,
false
for linked series.
Defaults to: true
public Boolean getShowInNavigator()
setShowInNavigator(Boolean)
public void setShowInNavigator(Boolean showInNavigator)
Defaults to: undefined
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: false
public Number getStackDistance()
setStackDistance(Number)
public void setStackDistance(Number stackDistance)
Defaults to: 12
public States getStates()
setStates(States)
public void setStates(States states)
public Boolean getStickyTracking()
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 not shared.
When stickyTracking
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, candlesticks etc.
Defaults to: true
public Style getStyle()
setStyle(Style)
public void setStyle(Style style)
The text styles of the flag.
In styled mode, the styles are set in the
.highcharts-flag-series .highcharts-point
rule.
Defaults to: { "fontSize": "11px", "fontWeight": "bold" }
public String getTextAlign()
setTextAlign(String)
public void setTextAlign(String textAlign)
Defaults to: center
public Number getThreshold()
setThreshold(Number)
public void setThreshold(Number threshold)
Defaults to: 0
public SeriesTooltip getTooltip()
setTooltip(SeriesTooltip)
public void setTooltip(SeriesTooltip tooltip)
text
option for each
point.public Boolean getUseHTML()
setUseHTML(Boolean)
public void setUseHTML(Boolean useHTML)
Defaults to: false
public Boolean getVisible()
setVisible(Boolean)
public void setVisible(Boolean visible)
Defaults to: true
public Number getY()
setY(Number)
public void setY(Number y)
-30
.
Defaults to: -30
public ZoneAxis getZoneAxis()
setZoneAxis(ZoneAxis)
public void setZoneAxis(ZoneAxis zoneAxis)
Defaults to: y
public Zones[] getZones()
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).
public void addZone(Zones zone)
zone
- to addsetZones(Zones...)
public void removeZone(Zones zone)
zone
- to removesetZones(Zones...)
Copyright © 2022. All rights reserved.