com.vaadin.flow.component.charts.model.
Class Tooltip
All Implemented Interfaces:
Options for the tooltip that appears when the user hovers over a series or point.
See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptiongetShape()
getSnap()
getSplit()
getStyle()
void
setAnimation
(Boolean animation) Enable or disable animation of the tooltip.
void
setBackgroundColor
(Color backgroundColor) The background color or gradient for the tooltip.
void
setBorderColor
(Color borderColor) The color of the tooltip border.
void
setBorderRadius
(Number borderRadius) The radius of the rounded border corners.
void
setBorderWidth
(Number borderWidth) The pixel width of the tooltip border.
void
setChangeDecimals
(Number changeDecimals) How many decimals to show for the
point.change
value when theseries.compare
option is set.void
setDateTimeLabelFormats
(DateTimeLabelFormats dateTimeLabelFormats) For series on a datetime axes, the date format in the tooltip's header will by default be guessed based on the closest data points.
void
setEnabled
(Boolean enabled) Enable or disable the tooltip.
void
setFollowPointer
(Boolean followPointer) Whether the tooltip should follow the mouse as it moves across columns, pie slices and other point types with an extent.
void
setFollowTouchMove
(Boolean followTouchMove) Whether the tooltip should follow the finger as it moves on a touch device.
void
setFooterFormat
(String footerFormat) A string to append to the tooltip format.
void
setFormatter
(String _fn_formatter) void
setHeaderFormat
(String headerFormat) The HTML of the tooltip header line.
void
setHideDelay
(Number hideDelay) The number of milliseconds to wait until the tooltip is hidden when mouse out from a point or chart.
void
setOutside
(Boolean outside) Whether to allow the tooltip to render outside the chart's SVG element box.
void
setPadding
(Number padding) Padding inside the tooltip, in pixels.
void
setPointFormat
(String pointFormat) The HTML of the point's line in the tooltip.
void
setPointFormatter
(String _fn_pointFormatter) void
setPositioner
(String _fn_positioner) void
Whether to apply a drop shadow to the tooltip.
void
The name of a symbol to use for the border around the tooltip.
void
When the tooltip is shared, the entire plot area will capture mouse movement or touch events.
void
Proximity snap for graphs or single points.
void
Split the tooltip into one label per series, with the header close to the axis.
void
CSS styles for the tooltip.
void
setUseHTML
(Boolean useHTML) Use HTML to render the contents of the tooltip instead of SVG.
void
setValueDecimals
(Number valueDecimals) How many decimals to show in each series' y value.
void
setValuePrefix
(String valuePrefix) A string to prepend to each series' y value.
void
setValueSuffix
(String valueSuffix) A string to append to each series' y value.
void
setXDateFormat
(String xDateFormat) The format for the date in the tooltip header if the X axis is a datetime axis.
-
Constructor Details
-
Tooltip
public Tooltip() -
Tooltip
-
-
Method Details
-
getAnimation
See Also:
-
setAnimation
Enable or disable animation of the tooltip. In slow legacy IE browsers the animation is disabled by default.
Defaults to: true
-
getBackgroundColor
See Also:
-
setBackgroundColor
The background color or gradient for the tooltip.
In styled mode, the stroke width is set in the
.highcharts-tooltip-box
class.Defaults to: rgba(247,247,247,0.85)
-
getBorderColor
See Also:
-
setBorderColor
The color of the tooltip border. When
null
, the border takes the color of the corresponding series or point.Defaults to: null
-
getBorderRadius
See Also:
-
setBorderRadius
The radius of the rounded border corners.
Defaults to: 3
-
getBorderWidth
See Also:
-
setBorderWidth
The pixel width of the tooltip border.
In styled mode, the stroke width is set in the
.highcharts-tooltip-box
class.Defaults to: 1
-
getDateTimeLabelFormats
-
setDateTimeLabelFormats
For series on a datetime axes, the date format in the tooltip's header will by default be guessed based on the closest data points. This member gives the default string representations used for each unit. For an overview of the replacement codes, see dateFormat.
Defaults to:
{ millisecond:"%A, %b %e, %H:%M:%S.%L", second:"%A, %b %e, %H:%M:%S", minute:"%A, %b %e, %H:%M", hour:"%A, %b %e, %H:%M", day:"%A, %b %e, %Y", week:"Week from %A, %b %e, %Y", month:"%B %Y", year:"%Y" }
-
getEnabled
See Also:
-
setEnabled
Enable or disable the tooltip.
Defaults to: true
-
getFollowPointer
See Also:
-
setFollowPointer
Whether the tooltip should follow the mouse as it moves across columns, pie slices and other point types with an extent. By default it behaves this way for scatter, bubble and pie series by override in the
plotOptions
for those series types.For touch moves to behave the same way, followTouchMove must be
true
also.Defaults to: false
-
getFollowTouchMove
See Also:
-
setFollowTouchMove
Whether the tooltip should follow the finger as it moves on a touch device. If this is
true
and chart.panning is set,followTouchMove
will take over one-finger touches, so the user needs to use two fingers for zooming and panning.Defaults to: true
-
getFormatter
-
setFormatter
-
getHeaderFormat
See Also:
-
setHeaderFormat
The HTML of the tooltip header line. Variables are enclosed by curly brackets. Available variables are
point.key
,series.name
,series.color
and other members from thepoint
andseries
objects. Thepoint.key
variable contains the category name, x value or datetime string depending on the type of axis. For datetime axes, thepoint.key
date format can be set using tooltip.xDateFormat.Defaults to
<span style="font-size: 10px">{point.key}</span><br/>
-
getHideDelay
See Also:
-
setHideDelay
The number of milliseconds to wait until the tooltip is hidden when mouse out from a point or chart.
Defaults to: 500
-
getPadding
See Also:
-
setPadding
Padding inside the tooltip, in pixels.
Defaults to: 8
-
getPointFormat
See Also:
-
setPointFormat
The HTML of the point's line in the tooltip. Variables are enclosed by curly brackets. Available variables are point.x, point.y, series.name and series.color and other properties on the same form. Furthermore, point.y can be extended by the
tooltip.valuePrefix
andtooltip.valueSuffix
variables. This can also be overridden for each series, which makes it a good hook for displaying units.In styled mode, the dot is colored by a class name rather than the point color.
Defaults to: ? {series.name}: {point.y}
-
getPointFormatter
-
setPointFormatter
-
getPositioner
-
setPositioner
-
getShadow
See Also:
-
setShadow
Whether to apply a drop shadow to the tooltip.
Defaults to: true
-
getShape
See Also:
-
setShape
The name of a symbol to use for the border around the tooltip. In Highcharts 3.x and less, the shape was
square
.Defaults to: callout
-
getSnap
See Also:
-
setSnap
Proximity snap for graphs or single points. It defaults to 10 for mouse-powered devices and 25 for touch devices.
Note that in most cases the whole plot area captures the mouse movement, and in these cases
tooltip.snap
doesn't make sense. This applies when stickyTracking istrue
(default) and when the tooltip is shared or split. -
getSplit
See Also:
-
setSplit
Split the tooltip into one label per series, with the header close to the axis. This is recommended over shared tooltips for charts with multiple line series, generally making them easier to read.
Defaults to: false
-
getStyle
See Also:
-
setStyle
CSS styles for the tooltip. The tooltip can also be styled through the CSS class
.highcharts-tooltip
.Defaults to: { "color": "#333333", "cursor": "default", "fontSize": "12px", "pointerEvents": "none", "whiteSpace": "nowrap" }
-
getUseHTML
See Also:
-
setUseHTML
Use HTML to render the contents of the tooltip instead of SVG. Using HTML allows advanced formatting like tables and images in the tooltip. It is also recommended for rtl languages as it works around rtl bugs in early Firefox.
Defaults to: false
-
getValueDecimals
See Also:
-
setValueDecimals
How many decimals to show in each series' y value. This is overridable in each series' tooltip options object. The default is to preserve all decimals.
-
getValuePrefix
See Also:
-
setValuePrefix
A string to prepend to each series' y value. Overridable in each series' tooltip options object.
-
getValueSuffix
See Also:
-
setValueSuffix
A string to append to each series' y value. Overridable in each series' tooltip options object.
-
getXDateFormat
See Also:
-
setXDateFormat
The format for the date in the tooltip header if the X axis is a datetime axis. The default is a best guess based on the smallest distance between points in the chart.
-
getChangeDecimals
See Also:
-
setChangeDecimals
How many decimals to show for the
point.change
value when theseries.compare
option is set. This is overridable in each series' tooltip options object. The default is to preserve all decimals. -
getOutside
See Also:
-
setOutside
Whether to allow the tooltip to render outside the chart's SVG element box. By default (false), the tooltip is rendered within the chart's SVG element, which results in the tooltip being aligned inside the chart area. For small charts, this may result in clipping or overlapping. When true, a separate SVG element is created and overlaid on the page, allowing the tooltip to be aligned inside the page itself.
-