HighchartsTreemapSeriesOptions class
A treemap
series. If the type option is
not specified, it is inherited from chart.type.
Configuration options for the series are given in three levels:
- Options for all series in a chart are defined in the plotOptions.series object.
- Options for all
treemap
series are defined in plotOptions.treemap. - Options for one single series are given in the series instance array.
API Docs: https://api.highcharts.com/highcharts/series.treemap
- Inheritance
-
- Object
- HighchartsOptionsBase
- HighchartsTreemapSeriesOptions
Constructors
-
HighchartsTreemapSeriesOptions.new({HighchartsSeriesAccessibilityOptions? accessibility, bool? allowDrillToNode, bool? allowPointSelect, bool? allowTraversingTree, bool? alternateStartingDirection, dynamic animation, double? animationLimit, String? boostBlending, double? boostThreshold, String? borderColor, double? borderRadius, double? borderWidth, HighchartsTreemapSeriesBreadcrumbsOptions? breadcrumbs, String? className, bool? clip, HighchartsTreemapSeriesClusterOptions? cluster, String? color, dynamic colorAxis, bool? colorByPoint, double? colorIndex, String? colorKey, List? colors, bool? crisp, double? cropThreshold, String? cursor, Map<
String, dynamic> ? custom, String? dashStyle, HighchartsTreemapSeriesDataLabelsOptions? dataLabels, String? description, bool? enableMouseTracking, HighchartsTreemapSeriesEventsOptions? events, String? findNearestPointBy, bool? getExtremesFromAll, double? groupPadding, String? id, bool? ignoreHiddenPoint, bool? inactiveOtherPoints, bool? includeInDataExport, double? index, bool? interactByLeaf, List<String> ? keys, HighchartsSeriesLabelOptions? label, String? layoutAlgorithm, String? layoutStartingDirection, double? legendIndex, String? legendSymbol, bool? levelIsConstant, List<HighchartsTreemapSeriesLevelsOptions> ? levels, double? lineWidth, String? linecap, String? linkedTo, String? negativeColor, String? nodeSizeBy, bool? nullInteraction, HighchartsSeriesOnPointOptions? onPoint, double? opacity, HighchartsSeriesPointOptions? point, dynamic pointDescriptionFormat, dynamic pointDescriptionFormatter, double? pointInterval, String? pointIntervalUnit, dynamic pointStart, bool? relativeXValue, bool? selected, bool? showCheckbox, bool? showInLegend, bool? softThreshold, HighchartsSeriesSonificationOptions? sonification, double? sortIndex, String? stacking, HighchartsTreemapSeriesStatesOptions? states, String? step, bool? stickyTracking, double? threshold, HighchartsTreemapSeriesTooltipOptions? tooltip, bool? traverseToLeaf, HighchartsTreemapSeriesTraverseUpButtonOptions? traverseUpButton, double? turboThreshold, bool? visible, dynamic xAxis, dynamic yAxis, double? zIndex, String? zoneAxis, List<HighchartsSeriesZonesOptions> ? zones}) -
A
treemap
series. If the type option is not specified, it is inherited from chart.type.
Properties
- accessibility ↔ HighchartsSeriesAccessibilityOptions?
-
Accessibility options for a series.
getter/setter pair
- allowDrillToNode ↔ bool?
-
When enabled the user can click on a point which is a parent and
zoom in on its children. Deprecated and replaced by
allowTraversingTree.
getter/setter pair
- allowPointSelect ↔ bool?
-
Allow this series' points to be selected by clicking on the graphic
(columns, point markers, pie slices, map areas etc).
getter/setter pair
- allowTraversingTree ↔ bool?
-
When enabled the user can click on a point which is a parent and
zoom in on its children.
getter/setter pair
- alternateStartingDirection ↔ bool?
-
Enabling this option will make the treemap alternate the drawing
direction between vertical and horizontal. The next levels starting
direction will always be the opposite of the previous.
getter/setter pair
- animation ↔ dynamic
-
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:
getter/setter pair
- animationLimit ↔ double?
-
Highcharts Options Widget.
getter/setter pair
- boostBlending ↔ String?
-
Sets the color blending in the boost module.
getter/setter pair
- boostThreshold ↔ double?
-
Set the point threshold for when a series should enter boost mode.
getter/setter pair
- borderColor ↔ String?
-
The color of the border surrounding each tree map item.
getter/setter pair
- borderRadius ↔ double?
-
The border radius for each treemap item.
getter/setter pair
- borderWidth ↔ double?
-
The width of the border surrounding each tree map item.
getter/setter pair
-
Options for the breadcrumbs, the navigation at the top leading the
way up through the traversed levels.
getter/setter pair
- className ↔ String?
-
An additional class name to apply to the series' graphical elements.
This option does not replace default class names of the graphical
element. Changes to the series' color will also be reflected in a
chart's legend and tooltip.
getter/setter pair
- clip ↔ bool?
-
Disable this option to allow series rendering in the whole plotting
area.
getter/setter pair
- cluster ↔ HighchartsTreemapSeriesClusterOptions?
-
An option to optimize treemap series rendering by grouping smaller leaf
nodes below a certain square area threshold in pixels. If the square area
of a point becomes smaller than the specified threshold, determined by
the
pixelWidth
and/orpixelHeight
options, then this point is moved into one group point per series.getter/setter pair - color ↔ String?
-
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.getter/setter pair - colorAxis ↔ dynamic
-
When using dual or multiple color axes, this number defines which
colorAxis the particular series is connected to. It refers to
either the
axis id
or the index of the axis in the colorAxis array, with 0 being the
first. Set this option to false to prevent a series from connecting
to the default color axis.
getter/setter pair
- colorByPoint ↔ bool?
-
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.getter/setter pair - colorIndex ↔ double?
-
Styled mode only. A specific color index to use for the series, so its
graphic representations are given the class name
highcharts-color-{n}
.getter/setter pair - colorKey ↔ String?
-
Highcharts Options Widget.
getter/setter pair
- colors ↔ List?
-
A series specific or series type specific color set to apply instead
of the global colors when
colorByPoint is true.
getter/setter pair
- crisp ↔ bool?
-
When true, each point or column edge is rounded to its nearest pixel
in order to render sharp on screen. In some cases, when there are a
lot of densely packed columns, this leads to visible difference
in column widths or distance between columns. In these cases,
setting
crisp
tofalse
may look better, even though each column is rendered blurry.getter/setter pair - cropThreshold ↔ double?
-
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. The advantage of drawing all points
(including markers and columns), is that animation is performed on
updates. On the other hand, when the series contains more points than
the crop threshold, the series data is cropped to only contain points
that fall within the plot area. The advantage of cropping away
invisible points is to increase performance on large series.
getter/setter pair
- cursor ↔ String?
-
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.
getter/setter pair
-
custom
↔ Map<
String, dynamic> ? -
A reserved subspace to store options and values for customized
functionality. Here you can add additional data for your own event
callbacks and formatter callbacks.
getter/setter pair
- dashStyle ↔ String?
-
Name of the dash style to use for the graph, or for some series types
the outline of each shape.
getter/setter pair
- dataLabels ↔ HighchartsTreemapSeriesDataLabelsOptions?
-
Highcharts Options Widget.
getter/setter pair
- description ↔ String?
-
A description of the series to add to the screen reader information
about the series.
getter/setter pair
- enableMouseTracking ↔ bool?
-
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.
getter/setter pair
- events ↔ HighchartsTreemapSeriesEventsOptions?
-
Highcharts Options Widget.
getter/setter pair
- findNearestPointBy ↔ String?
-
Highcharts Options Widget.
getter/setter pair
- getExtremesFromAll ↔ bool?
-
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.
getter/setter pair
- groupPadding ↔ double?
-
Group padding for parent elements in terms of pixels. See also the
nodeSizeBy
option that controls how the leaf nodes' size is affected by the padding.getter/setter pair - hashCode → int
-
The hash code for this object.
no setterinherited
- id ↔ String?
-
An id for the series. This can be used after render time to get a pointer
to the series object through
chart.get()
.getter/setter pair - ignoreHiddenPoint ↔ bool?
-
Whether to ignore hidden points when the layout algorithm runs.
If
false
, hidden points will leave open spaces.getter/setter pair - inactiveOtherPoints ↔ bool?
-
Highlight only the hovered point and fade the remaining points.
getter/setter pair
- includeInDataExport ↔ bool?
-
When set to
false
will prevent the series data from being included in any form of data export.getter/setter pair - index ↔ double?
-
The index of the series in the chart, affecting the internal index in the
chart.series
array, the visible Z index as well as the order in the legend.getter/setter pair - interactByLeaf ↔ bool?
-
This option decides if the user can interact with the parent nodes
or just the leaf nodes. When this option is undefined, it will be
true by default. However when allowTraversingTree is true, then it
will be false by default.
getter/setter pair
-
keys
↔ List<
String> ? -
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.
getter/setter pair
- label ↔ HighchartsSeriesLabelOptions?
-
Series labels are placed as close to the series as possible in a
natural way, seeking to avoid other series. The goal of this
feature is to make the chart more easily readable, like if a
human designer placed the labels in the optimal position.
getter/setter pair
- layoutAlgorithm ↔ String?
-
This option decides which algorithm is used for setting position
and dimensions of the points.
getter/setter pair
- layoutStartingDirection ↔ String?
-
Defines which direction the layout algorithm will start drawing.
getter/setter pair
- legendIndex ↔ double?
-
The sequential index of the series in the legend.
getter/setter pair
- legendSymbol ↔ String?
-
Highcharts Options Widget.
getter/setter pair
- levelIsConstant ↔ bool?
-
Used together with the levels and allowTraversingTree options. When
set to false the first level visible to be level one, which is
dynamic when traversing the tree. Otherwise the level will be the
same as the tree structure.
getter/setter pair
-
levels
↔ List<
HighchartsTreemapSeriesLevelsOptions> ? -
Set options on specific levels. Takes precedence over series options,
but not point options.
getter/setter pair
- linecap ↔ String?
-
The SVG value used for the
stroke-linecap
andstroke-linejoin
of a line graph. Round means that lines are rounded in the ends and bends.getter/setter pair - lineWidth ↔ double?
-
The width of the line connecting the data points.
getter/setter pair
- linkedTo ↔ String?
-
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.
getter/setter pair
- negativeColor ↔ String?
-
The color for the parts of the graph or points that are below the
threshold. Note that
zones
takes precedence over the negative color. UsingnegativeColor
is equivalent to applying a zone with value of 0.getter/setter pair - nodeSizeBy ↔ String?
-
Experimental. How to set the size of child nodes when a header or padding
is present. When
leaf
, the group is expanded to make room for headers and padding in order to preserve the relative sizes between leaves. Whengroup
, the leaves are naïvely fit into the remaining area after the header and padding are subtracted.getter/setter pair - nullInteraction ↔ bool?
-
Whether or not data-points with the value of
null
should be interactive. When this is set totrue
, tooltips may highlight these points, and this option also enables keyboard navigation for such points. Format options for such points includenullFormat
andnullFormater
. Works for these series:line
,spline
,area
,area-spline
,column
,bar
, and*timeline
.getter/setter pair - onPoint ↔ HighchartsSeriesOnPointOptions?
-
Options for the Series on point feature. Only
pie
andsunburst
series are supported at this moment.getter/setter pair - opacity ↔ double?
-
The opacity of grouped points in treemap. When a point has children, the
group point is covering the children, and is given this opacity. The
visibility of the children is determined by the opacity.
getter/setter pair
- point ↔ HighchartsSeriesPointOptions?
-
Properties for each single point.
getter/setter pair
- pointDescriptionFormat ↔ dynamic
-
Same as
accessibility.point.descriptionFormat,
but for an individual series. Overrides the chart wide configuration.
getter/setter pair
- pointDescriptionFormatter ↔ dynamic
-
Same as
accessibility.series.descriptionFormatter,
but for an individual series. Overrides the chart wide configuration.
getter/setter pair
- pointInterval ↔ double?
-
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, setpointInterval
to10
. In truedatetime
axes, thepointInterval
is set in milliseconds.getter/setter pair - pointIntervalUnit ↔ String?
-
On datetime series, this allows for setting the
pointInterval to irregular time
units,
day
,month
andyear
. A day is usually the same as 24 hours, butpointIntervalUnit
also takes the DST crossover into consideration when dealing with local time. Combine this option withpointInterval
to draw weeks, quarters, 6 months, 10 years etc.getter/setter pair - pointStart ↔ dynamic
-
If no x values are given for the points in a series,
pointStart
defines on what value to start. For example, if a series contains one yearly value starting from 1945, setpointStart
to 1945.getter/setter pair - relativeXValue ↔ bool?
-
When true, X values in the data set are relative to the current
pointStart
,pointInterval
andpointIntervalUnit
settings. This allows compression of the data for datasets with irregular X values.getter/setter pair - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- selected ↔ bool?
-
Whether to select the series initially. If
showCheckbox
is true, the checkbox next to the series name in the legend will be checked for a selected series.getter/setter pair - showCheckbox ↔ bool?
-
If true, a checkbox is displayed next to the legend item to allow
selecting the series. The state of the checkbox is determined by
the
selected
option.getter/setter pair - showInLegend ↔ bool?
-
Whether to display this series type or specific series item in the
legend.
getter/setter pair
-
If set to
true
, the accessibility module will skip past the points in this series for keyboard navigation.getter/setter pair - softThreshold ↔ bool?
-
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.
getter/setter pair
- sonification ↔ HighchartsSeriesSonificationOptions?
-
Sonification/audio chart options for a series.
getter/setter pair
- sortIndex ↔ double?
-
The sort index of the point inside the treemap level.
getter/setter pair
- stacking ↔ String?
-
Whether to stack the values of each series on top of each other.
Possible values are
undefined
to disable,"normal"
to stack by value or"percent"
.getter/setter pair - states ↔ HighchartsTreemapSeriesStatesOptions?
-
A wrapper object for all the series options in specific states.
getter/setter pair
- step ↔ String?
-
Whether to apply steps to the line. Possible values are
left
,center
andright
.getter/setter pair - stickyTracking ↔ bool?
-
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.getter/setter pair - threshold ↔ double?
-
The threshold, also called zero level or base level. For line type
series this is only used in conjunction with
negativeColor.
getter/setter pair
- tooltip ↔ HighchartsTreemapSeriesTooltipOptions?
-
Highcharts Options Widget.
getter/setter pair
- traverseToLeaf ↔ bool?
-
This option enables automatic traversing to the last child level upon
node interaction. This feature simplifies navigation by immediately
focusing on the deepest layer of the data structure without intermediate
steps.
getter/setter pair
- traverseUpButton ↔ HighchartsTreemapSeriesTraverseUpButtonOptions?
-
Options for the button appearing when traversing down in a treemap.
getter/setter pair
- turboThreshold ↔ double?
-
When a series contains a
data
array that is longer than this, the Series class looks for data configurations of plain numbers or arrays of numbers. The first and last valid points are checked. If found, the rest of the data is assumed to be the same. This saves expensive data checking and indexing in long series, and makes data-heavy charts render faster.getter/setter pair - visible ↔ bool?
-
Set the initial visibility of the series.
getter/setter pair
- xAxis ↔ dynamic
-
When using dual or multiple x axes, this number defines which xAxis the
particular series is connected to. It refers to either the
axis id
or the index of the axis in the xAxis array, with 0 being the first.
getter/setter pair
- yAxis ↔ dynamic
-
When using dual or multiple y axes, this number defines which yAxis the
particular series is connected to. It refers to either the
axis id
or the index of the axis in the yAxis array, with 0 being the first.
getter/setter pair
- zIndex ↔ double?
-
Define the visual z index of the series.
getter/setter pair
- zoneAxis ↔ String?
-
Defines the Axis on which the zones are applied.
getter/setter pair
-
zones
↔ List<
HighchartsSeriesZonesOptions> ? -
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. The zone definitions have to be in ascending order regarding to the value.getter/setter pair
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toJSON(
) → String -
Serializes the settings to a JSON string.
inherited
-
toOptionsJSON(
StringBuffer buffer) → void -
override
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited