Series Config
Configure the chart series.
series is a list section: it takes an array of config objects (a single object is also accepted and treated as a one-entry array). Values shared by every entry can be set once in seriesDefaults; a value set on an individual entry wins over the shared one.
Every property is optional except property and falls back to its default. Property anchors are stable: link to any entry as #series.propertyName, and to a member of a nested property as #series.propertyName.memberName.
Properties
animateBaseFromAdjacent
Whether to animate leading/trailing series position values from their adjacent values (true) or from the base value (false).
- Default:
false— when renderer is bartrue— when renderer is linetrue— when renderer is areafalse— when renderer is none
- Validation:
should be a boolean
axis
The unique identifier of the axis that the series belongs to.
Assigns the series to the value axis in valueAxes whose id matches. With a single configured axis this can be omitted — it defaults to that axis id.
- Default:
sole axis id— value axis - Validation:
should be a string;should equal the id property of one of the valueAxes - Used in: Dual value axes · Tooltip formatting · Stacked · Grouped · Grouped Across Axes · +9 more
barAlignFraction
The fraction (0 - 1) of the slot width freed by barWidthFraction placed before each bar in the series (0 aligns with the slot start, 0.5 centers, 1 aligns with the slot end).
Only affects the bar renderer, and only when barWidthFraction is less than 1. Lets narrowed bars from different series share one slot side by side — e.g. the left open tick and right close tick of an OHLC bar.
- Default:
0.5 - Validation:
should be a number >= to 0 and <= 1 - Used in: OHLC Bars
barMinExtent
The minimum extent (in pixels) of each bar in the series along the value direction.
Only affects the bar renderer. A bar whose two ends resolve to (nearly) the same position — e.g. a ranged bar whose property and rangeProperty values are equal — is expanded to this extent, centered on its position, so it stays visible as a tick mark: e.g. the open/close ticks of an OHLC bar, or a candlestick doji body.
- Default:
0 - Validation:
should be a number >= to 0 - Used in: OHLC Bars
barWidthFraction
The fraction (0 - 1) of the bar layout slot width to use when drawing bars in the series.
Only affects the bar renderer. Narrows each bar within its layout slot (the full category slot, or the series’ sub-slot when grouped), so a narrow bar can overlay a full-width one from another series — e.g. a candlestick wick behind its body, or a bullet-chart measure over its backing range. The narrowed bar is centered by default; barAlignFraction moves it within the slot.
- Default:
1 - Validation:
should be a number >= to 0 and <= 1 - Used in: Candlestick · Hollow Candlestick · OHLC Bars
capExpand
Whether to expand the base of caps on a bar series when the size of the cap is greater than the extent of the bar.
- Default:
true - Validation:
should be a boolean - Used in: Missing Pos/Neg Stacked Values
capOnlyStackOuter
Whether to only show the cap on bars in the series when they are an outer series of a stack.
- Default:
false - Validation:
should be a boolean - Used in: Missing Pos/Neg Stacked Values
capSize
The size of the cap (in pixels) to use when drawing caps on a bar series.
- Default:
5 - Validation:
should be a number >= to 0 - Used in: Picket Fence Bars · Pos/Neg Picket Fence Bars · Missing Pos/Neg Stacked Values
capType
The type (point, curve, round, use null for none) of cap to use when drawing caps on a bar series.
Draws a decorative cap on the value end of each bar in the series; capSize controls its extent. To cap only the outside of a stacked bar, see capOnlyStackOuter and seriesStacks[].outerCapType.
- Default:
null - Validation:
should be one of [ "point", "curve", "round" ] or be equal to null - Used in: Picket Fence Bars · Pos/Neg Picket Fence Bars · Missing Pos/Neg Stacked Values
colorProperty
The property to retrieve from the data provider for the series color values (use null for none, to color by style instead).
- Default:
null - Validation:
should be a defined value or equal to null - Used in: Heatmap · Color and Base Property · Color Property · Heatmap
colorScale
The color ramp the series color values are mapped through.
- Default:
{ interpolation: null, min: null, max: null, missing: null, base: { … } } - Validation:
should be an object with any of the properties { interpolation: should be one of [ "rgb", "hsl", "lab", "hcl" ] when colorProperty is not null, min: should be equal to null when colorProperty is not null and colorScale.base.value is not null, max: should be equal to null when colorProperty is not null and colorScale.base.value is not null, missing: should be a valid color or be equal to null when colorProperty is not null, base: should be an object with any of the properties { value: should be a number or be equal to null, aboveMin: should be a valid color when colorProperty is not null and colorScale.base.value is not null, aboveMax: should be a valid color when colorProperty is not null and colorScale.base.value is not null, belowMin: should be a valid color when colorProperty is not null and colorScale.base.value is not null, belowMax: should be a valid color when colorProperty is not null and colorScale.base.value is not null } } - Used in: Heatmap · Color and Base Property · Color Property · Heatmap
colorScale.base
The data threshold that splits the color ramp in two, and the two ramps either side of it.
- Default:
{ value: null, aboveMin: null, aboveMax: null, belowMin: null, belowMax: null } - Validation:
should be an object with any of the properties { value: should be a number or be equal to null, aboveMin: should be a valid color when colorProperty is not null and colorScale.base.value is not null, aboveMax: should be a valid color when colorProperty is not null and colorScale.base.value is not null, belowMin: should be a valid color when colorProperty is not null and colorScale.base.value is not null, belowMax: should be a valid color when colorProperty is not null and colorScale.base.value is not null } - Used in: Color and Base Property
colorScale.base.aboveMax
The maximum color to use when interpolating the series shape color with a color property value that is above the base value (use null for none).
- Default:
null— when colorProperty is nullnull— when colorProperty is not null and colorScale.base.value is null-
#0000ff— when colorProperty is not null and colorScale.base.value is not null
- Validation:
should be equal to null when colorProperty is null;should be equal to null when colorProperty is not null and colorScale.base.value is null;should be a valid color when colorProperty is not null and colorScale.base.value is not null - Used in: Color and Base Property
colorScale.base.aboveMin
The minimum color to use when interpolating the series shape color with a color property value that is above the base value (use null for none).
- Default:
null— when colorProperty is nullnull— when colorProperty is not null and colorScale.base.value is null-
#8f8fff— when colorProperty is not null and colorScale.base.value is not null
- Validation:
should be equal to null when colorProperty is null;should be equal to null when colorProperty is not null and colorScale.base.value is null;should be a valid color when colorProperty is not null and colorScale.base.value is not null - Used in: Color and Base Property
colorScale.base.belowMax
The maximum color to use when interpolating the series shape color with a color property value that is below the base value (use null for none).
- Default:
null— when colorProperty is nullnull— when colorProperty is not null and colorScale.base.value is null-
#ff0000— when colorProperty is not null and colorScale.base.value is not null
- Validation:
should be equal to null when colorProperty is null;should be equal to null when colorProperty is not null and colorScale.base.value is null;should be a valid color when colorProperty is not null and colorScale.base.value is not null - Used in: Color and Base Property
colorScale.base.belowMin
The minimum color to use when interpolating the series shape color with a color property value that is below the base value (use null for none).
- Default:
null— when colorProperty is nullnull— when colorProperty is not null and colorScale.base.value is null-
#ff8f8f— when colorProperty is not null and colorScale.base.value is not null
- Validation:
should be equal to null when colorProperty is null;should be equal to null when colorProperty is not null and colorScale.base.value is null;should be a valid color when colorProperty is not null and colorScale.base.value is not null - Used in: Color and Base Property
colorScale.base.value
The base value to use for color interpolation, allowing 2 distinct sets of min & max colors for interpolation (use null for none).
- Default:
null - Validation:
should be a number or be equal to null - Used in: Color and Base Property
colorScale.interpolation
The type of d3 color interpolation to apply when using a color property (rgb, hsl, lab, hcl) (use null for none).
- Default:
null— when colorProperty is null"hcl"— when colorProperty is not null
- Validation:
should be one of [ "rgb", "hsl", "lab", "hcl" ] when colorProperty is not null;should be equal to null when colorProperty is null - Used in: Heatmap · Color and Base Property · Color Property · Heatmap
colorScale.max
The maximum color to use when interpolating the series shape color with a color property (use null for none).
- Default:
null— when colorProperty is null-
#0000ff— when colorProperty is not null and colorScale.base.value is null null— when colorProperty is not null and colorScale.base.value is not null
- Validation:
should be equal to null when colorProperty is null;should be equal to null when colorProperty is not null and colorScale.base.value is not null;should be a valid color when colorProperty is not null and colorScale.base.value is null - Used in: Heatmap · Color Property · Heatmap
colorScale.min
The minimum color to use when interpolating the series shape color with a color property (use null for none).
- Default:
null— when colorProperty is null-
#8f8fff— when colorProperty is not null and colorScale.base.value is null null— when colorProperty is not null and colorScale.base.value is not null
- Validation:
should be equal to null when colorProperty is null;should be equal to null when colorProperty is not null and colorScale.base.value is not null;should be a valid color when colorProperty is not null and colorScale.base.value is null - Used in: Heatmap · Color Property · Heatmap
colorScale.missing
The color drawn for a value whose color property value is missing (use null to fall back to the series style colors).
- Default:
null— when colorProperty is null-
#cccccc— when colorProperty is not null
- Validation:
should be equal to null when colorProperty is null;should be a valid color or be equal to null when colorProperty is not null
curve
The d3 curve type and param to use when drawing the series shape.
Only affects the line and area renderers. type selects the d3-shape curve (linear, monotoneX, natural, step, cardinal, catmullRom, …) and param is passed to the curve’s tension/alpha configurator for the curve types that take one.
- Default:
{ type: "linear" } - Validation:
should be an object with any of the properties { type: should be one of [ "linear", "monotoneX", "monotoneY", "basis", "cardinal", "catmullRom", "natural", "step", "stepBefore", "stepAfter" ], param: should be a number >= to 0 and <= 1 } - Used in: Curved Lines
curve.param
The tension/alpha value passed to the curve types that take one, or undefined to use the curve's own default.
- Default: none
- Validation:
should be a number >= to 0 and <= 1
curve.type
The d3-shape curve to interpolate the series shape with.
- Default:
"linear" - Validation:
should be one of [ "linear", "monotoneX", "monotoneY", "basis", "cardinal", "catmullRom", "natural", "step", "stepBefore", "stepAfter" ] - Used in: Curved Lines
errorBarCapSize
The full width (in pixels) of the horizontal caps drawn at the ends of the series error bars (use 0 to hide the caps).
The caps are the horizontal ticks at the whisker ends. On a bar renderer series the cap width is clamped to the bar layout slot so caps never overlap a neighbouring bar; use 0 to draw plain whiskers without caps.
- Default:
6 - Validation:
should be a number >= to 0
errorBarStyle
The style of the series error bars.
- Default:
{ normal: { … }, focused: { … }, defocused: { … } } - Validation:
should be an object with any of the properties { normal: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be equal to null, strokeDashArray: should be a valid dash array or be equal to null }, focused: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ] }, defocused: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ] } }
errorBarStyle.defocused
The style of the series error bars, while the series is defocused.
- Default:
{ strokeColor: "same", strokeOpacity: 0.5, strokeWidth: 1.5, strokeDashArray: "same" } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ] }
errorBarStyle.defocused.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette errorBar color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
errorBarStyle.defocused.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
"same" - Validation:
should be a valid dash array or be one of [ null, "same" ]
errorBarStyle.defocused.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
0.5 - Validation:
should be a number >= to 0 and <= 1
errorBarStyle.defocused.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1.5 - Validation:
should be a number >= to 0 or be one of [ null, "same" ]
errorBarStyle.focused
The style of the series error bars, while the series is focused.
- Default:
{ strokeColor: "same", strokeOpacity: 1, strokeWidth: 1.5, strokeDashArray: "same" } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ] }
errorBarStyle.focused.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette errorBar color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
errorBarStyle.focused.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
"same" - Validation:
should be a valid dash array or be one of [ null, "same" ]
errorBarStyle.focused.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
1 - Validation:
should be a number >= to 0 and <= 1
errorBarStyle.focused.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1.5 - Validation:
should be a number >= to 0 or be one of [ null, "same" ]
errorBarStyle.normal
The style of the series error bars, while the series is neither focused nor defocused.
- Default:
{ strokeColor: "series", strokeOpacity: 0.9, strokeWidth: 1.5, strokeDashArray: null } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be equal to null, strokeDashArray: should be a valid dash array or be equal to null }
errorBarStyle.normal.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "seriesIndex" / "categoryIndex" to take the matching colorPalette errorBar color by series or category index.
- Default:
"series" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ]
errorBarStyle.normal.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
null - Validation:
should be a valid dash array or be equal to null
errorBarStyle.normal.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
0.9 - Validation:
should be a number >= to 0 and <= 1
errorBarStyle.normal.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1.5 - Validation:
should be a number >= to 0 or be equal to null
errorHighProperty
The property to retrieve from the data provider for the absolute upper error bound values used to draw error bars (use null for none).
See errorLowProperty — the same rules apply to the upper bound.
- Default:
null - Validation:
should be equal to null when stack is not null;should be a defined value or equal to null when stack is null - Used in: Error Bars · Error Bars
errorLowProperty
The property to retrieve from the data provider for the absolute lower error bound values used to draw error bars (use null for none).
The bounds are absolute values in value axis units, not deltas from the series value, and they join the value axis domain so the whiskers never clip. Either bound can be used alone for a one-sided error bar; a category whose bound is undefined just omits that side of the whisker. Error bars draw on bar, line, area and none renderer series (centered on each bar — including grouped sub-slot bars — or on each point), but not on stacked series, where absolute bounds have no meaning against the cumulative stack position.
- Default:
null - Validation:
should be equal to null when stack is not null;should be a defined value or equal to null when stack is null - Used in: Error Bars · Error Bars
filterable
Whether or not the series can be filtered out of the chart via the legend or tooltip.
- Default:
true - Validation:
should be a boolean
focusCategoryOnClick
Whether the category should be focused whenever the user clicks/taps a category of the series in the chart.
- Default:
false - Validation:
should be a boolean
focusCategoryOnMouseOver
Whether the category should be focused whenever the user mouses over a category of the series in the chart.
- Default:
false - Validation:
should be a boolean
focusOnClick
Whether the series should be focused whenever the user clicks/taps a part of it in the chart.
- Default:
false - Validation:
should be a boolean
focusOnMouseOver
Whether the series should be focused whenever the user mouses over a part of it in the chart.
- Default:
false - Validation:
should be a boolean
followSeries
The unique identifier of another series whose legend filtering and focus this series follows (use null for none).
When the referenced series is toggled out of (or back into) the chart via the legend, this series follows it, and it shares the referenced series’ focus state both ways: focusing the leader highlights this series too, and focus interactions on this series target the leader. For companion series hidden from the legend (showInLegend: false) that visually belong to a legend series — e.g. a candlestick wick following its body — so filtering or focusing treats the whole mark as one.
- Default:
null - Validation:
should be a string or be equal to null;should equal the id property of one of the series - Used in: Candlestick · Hollow Candlestick · OHLC Bars
gradient
The unique id of the gradient config to be used when coloring the series shape (use null for none).
- Default:
sole gradient id— series gradient - Validation:
should be a string or be equal to null;should equal the id property of one of the linearGradients or radialGradients - Used in: Gradients · Gradients
group
The unique identifier of the series group that the series belongs to (use null for none).
Series sharing the same group id (an id from seriesGroups) are laid out side by side within each category slot — grouped/clustered bars. Defaults to the sole group id when exactly one series group is configured; use null to opt a series out.
- Default:
sole group id— series group - Validation:
should be a string or be equal to null;should equal the id property of one of the seriesGroups - Used in: Waterfall · Heatmap · Error Bars · Grouped · Stacked & Grouped · Waterfall · +5 more
id
The unique identifier for the series.
- Default:
S${index}— series index - Validation:
should be a string;should be unique - Used in: Waterfall · Heatmap · Error Bars · Waterfall · Heatmap · Candlestick · +6 more
ignore
Whether to ignore this series and treat it as though it were not specified.
- Default:
false - Validation:
should be a boolean
labelAboveBaseMaxPositionFraction
The labelMaxPositionFraction bound applied only to series values above the base value (use "auto" to inherit labelMaxPositionFraction, null for none).
- Default:
"auto" - Validation:
should be a number >= to 0 and <= 1 or be one of [ null, "auto" ]
labelAboveBaseMinPositionFraction
The labelMinPositionFraction bound applied only to series values above the base value (use "auto" to inherit labelMinPositionFraction, null for none).
- Default:
"auto" - Validation:
should be a number >= to 0 and <= 1 or be one of [ null, "auto" ]
labelAboveBaseOffset
The series position offset (in pixels) to apply to all series label positions that are above the base value (use "auto" to derive from the labelOffset).
- Default:
"auto" - Validation:
should be a number or be equal to "auto"
labelAboveBasePosition
Whether to position the series labels inside or outside of the series shape for series shapes that are above the base value.
- Default:
"auto" - Validation:
should be one of [ "auto", "inside", "center", "outside" ]
labelBelowBaseMaxPositionFraction
The labelMaxPositionFraction bound applied only to series values below the base value (use "auto" to inherit labelMaxPositionFraction, null for none).
- Default:
"auto" - Validation:
should be a number >= to 0 and <= 1 or be one of [ null, "auto" ]
labelBelowBaseMinPositionFraction
The labelMinPositionFraction bound applied only to series values below the base value (use "auto" to inherit labelMinPositionFraction, null for none).
- Default:
"auto" - Validation:
should be a number >= to 0 and <= 1 or be one of [ null, "auto" ]
labelBelowBaseOffset
The series position offset (in pixels) to apply to all series label positions that are below the base value (use "auto" to derive from the labelOffset).
- Default:
"auto" - Validation:
should be a number or be equal to "auto"
labelBelowBasePosition
Whether to position the series labels inside or outside of the series shape for series shapes that are below the base value.
- Default:
"auto" - Validation:
should be one of [ "auto", "inside", "center", "outside" ]
labelFormat
The d3 format string to be applied to the series label values (use null for none, use "auto" to derive from data).
- Default:
"auto" - Validation:
should be a valid number format or be one of [ null, "auto" ] - Used in: Markers and labels
labelMaxPositionFraction
The maximum position fraction (0 - 1) from the domain maximum for which series labels should be shown (use null for none).
- Default:
null - Validation:
should be a number >= to 0 and <= 1 or be equal to null
labelMinPositionFraction
The minimum position fraction (0 - 1) from the domain minimum for which series labels should be shown (use null for none).
- Default:
null - Validation:
should be a number >= to 0 and <= 1 or be equal to null - Used in: Positive Negative Labels
labelMinRangeFraction
The minimum position fraction (0 - 1) between two series values for which series labels should be shown (use null for none).
- Default:
null - Validation:
should be a number >= to 0 and <= 1 or be equal to null - Used in: Markers and labels · Positive Negative Labels · Stacked Labels
labelOffset
The series position offset (in pixels) to apply to all series label positions.
- Default:
0 - Validation:
should be a number - Used in: Positive Negative Labels
labelPosition
Whether to position the series labels inside or outside of the series shape.
- Default:
"center" - Validation:
should be one of [ "inside", "center", "outside" ] - Used in: Markers and labels · Positive Negative Labels · Stacked Labels
labelProperty
The property to retrieve from the data provider for the series label values (use null for none).
- Default:
null - Validation:
should be a defined value or equal to null - Used in: Markers and labels · Positive Negative Labels · Stacked Labels
labelTextStyle
The style of the series label values.
- Default:
{ normal: { … }, focused: { … }, defocused: { … } } - Validation:
should be an object with any of the properties { normal: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be equal to null, strokeDashArray: should be a valid dash array or be equal to null, fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }, focused: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }, defocused: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 } } - Used in: Markers and labels · Positive Negative Labels · Hollow Candlestick
labelTextStyle.defocused
The style of the series label values, while the series is defocused.
- Default:
{ strokeColor: "same", strokeOpacity: 1, strokeWidth: 1, strokeDashArray: "same", fillColor: "same", fillOpacity: 1 } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }
labelTextStyle.defocused.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette label color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
labelTextStyle.defocused.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
1 - Validation:
should be a number >= to 0 and <= 1
labelTextStyle.defocused.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette label color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
labelTextStyle.defocused.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
"same" - Validation:
should be a valid dash array or be one of [ null, "same" ]
labelTextStyle.defocused.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
1 - Validation:
should be a number >= to 0 and <= 1
labelTextStyle.defocused.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1 - Validation:
should be a number >= to 0 or be one of [ null, "same" ]
labelTextStyle.focused
The style of the series label values, while the series is focused.
- Default:
{ strokeColor: "same", strokeOpacity: 1, strokeWidth: 1, strokeDashArray: "same", fillColor: "same", fillOpacity: 1 } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }
labelTextStyle.focused.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette label color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
labelTextStyle.focused.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
1 - Validation:
should be a number >= to 0 and <= 1
labelTextStyle.focused.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette label color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
labelTextStyle.focused.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
"same" - Validation:
should be a valid dash array or be one of [ null, "same" ]
labelTextStyle.focused.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
1 - Validation:
should be a number >= to 0 and <= 1
labelTextStyle.focused.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1 - Validation:
should be a number >= to 0 or be one of [ null, "same" ]
labelTextStyle.normal
The style of the series label values, while the series is neither focused nor defocused.
- Default:
{ strokeColor: "currentColor", strokeOpacity: 0.8, strokeWidth: 1, strokeDashArray: null, fillColor: "currentColor", fillOpacity: 0.8 } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be equal to null, strokeDashArray: should be a valid dash array or be equal to null, fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 } - Used in: Markers and labels · Positive Negative Labels · Hollow Candlestick
labelTextStyle.normal.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "seriesIndex" / "categoryIndex" to take the matching colorPalette label color by series or category index.
- Default:
"currentColor" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ] - Used in: Markers and labels · Positive Negative Labels · Hollow Candlestick
labelTextStyle.normal.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
0.8 - Validation:
should be a number >= to 0 and <= 1 - Used in: Hollow Candlestick
labelTextStyle.normal.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "seriesIndex" / "categoryIndex" to take the matching colorPalette label color by series or category index.
- Default:
"currentColor" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ] - Used in: Markers and labels · Positive Negative Labels
labelTextStyle.normal.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
null - Validation:
should be a valid dash array or be equal to null
labelTextStyle.normal.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
0.8 - Validation:
should be a number >= to 0 and <= 1
labelTextStyle.normal.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1 - Validation:
should be a number >= to 0 or be equal to null
markerMinSize
The minimum marker size (in pixels) to use when interpolating the marker size based on a marker property value.
- Default:
1 - Validation:
should be a number >= to 0 - Used in: Bubble Chart
markerProperty
The property to retrieve from the data provider for the marker size values (use null for none).
- Default:
null - Validation:
should be a defined value or equal to null - Used in: Bubble Chart
markerShape
The shape to use when drawing the series marker (circle, cross, diamond, square, star, triangle, wye) (use null for none).
- Default:
null— when renderer is bar"circle"— when renderer is line"circle"— when renderer is area"circle"— when renderer is none
- Validation:
should be one of [ null, "circle", "cross", "diamond", "square", "star", "triangle", "wye" ] - Used in: Markers and labels · Sparklines · Multiple Axes · Range · Positive Negative Range · +8 more
markerSize
The maximum marker size (in pixels) to use when interpolating the marker size based on a marker property value, or the marker size when no marker property is used.
- Default:
6 - Validation:
should be a number >= to 0 - Used in: Markers and labels · Range · Bubble Chart · Scatter
markerSizeScale
The scale used to interpolate marker sizes from marker property values ("sqrt" scales the marker area with the value, "linear" scales its diameter).
- Default:
"sqrt" - Validation:
should be one of [ "sqrt", "linear" ]
markerStyle
The style of the series marker.
- Default:
{ normal: { … }, focused: { … }, defocused: { … } } - Validation:
should be an object with any of the properties { normal: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be equal to null, strokeDashArray: should be a valid dash array or be equal to null, fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }, focused: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }, defocused: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 } }
markerStyle.defocused
The style of the series marker, while the series is defocused.
- Default:
{ strokeColor: "same", strokeOpacity: 0.8, strokeWidth: 1, strokeDashArray: "same", fillColor: "same", fillOpacity: 0.8 } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }
markerStyle.defocused.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette marker color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
markerStyle.defocused.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
0.8 - Validation:
should be a number >= to 0 and <= 1
markerStyle.defocused.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette marker color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
markerStyle.defocused.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
"same" - Validation:
should be a valid dash array or be one of [ null, "same" ]
markerStyle.defocused.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
0.8 - Validation:
should be a number >= to 0 and <= 1
markerStyle.defocused.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1 - Validation:
should be a number >= to 0 or be one of [ null, "same" ]
markerStyle.focused
The style of the series marker, while the series is focused.
- Default:
{ strokeColor: "same", strokeOpacity: 1, strokeWidth: 3, strokeDashArray: "same", fillColor: "same", fillOpacity: 1 } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }
markerStyle.focused.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette marker color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
markerStyle.focused.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
1 - Validation:
should be a number >= to 0 and <= 1
markerStyle.focused.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette marker color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "same", "seriesIndex", "categoryIndex" ]
markerStyle.focused.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
"same" - Validation:
should be a valid dash array or be one of [ null, "same" ]
markerStyle.focused.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
1 - Validation:
should be a number >= to 0 and <= 1
markerStyle.focused.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
3 - Validation:
should be a number >= to 0 or be one of [ null, "same" ]
markerStyle.normal
The style of the series marker, while the series is neither focused nor defocused.
- Default:
{ strokeColor: "series", strokeOpacity: 0.9, strokeWidth: 1, strokeDashArray: null, fillColor: "series", fillOpacity: 0.9 } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be equal to null, strokeDashArray: should be a valid dash array or be equal to null, fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }
markerStyle.normal.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "seriesIndex" / "categoryIndex" to take the matching colorPalette marker color by series or category index.
- Default:
"series" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ]
markerStyle.normal.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
0.9 - Validation:
should be a number >= to 0 and <= 1
markerStyle.normal.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "series" to use the color of the series shape, or "seriesIndex" / "categoryIndex" to take the matching colorPalette marker color by series or category index.
- Default:
"series" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "series", "seriesIndex", "categoryIndex" ]
markerStyle.normal.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
null - Validation:
should be a valid dash array or be equal to null
markerStyle.normal.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
0.9 - Validation:
should be a number >= to 0 and <= 1
markerStyle.normal.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1 - Validation:
should be a number >= to 0 or be equal to null
missingValueMarkers
Whether to still show a marker at missing values (most useful with missingValues "base", which gives the marker a position).
- Default:
false - Validation:
should be a boolean
missingValues
What to draw at a category whose value is missing: break the shape at the gap (break), connect the neighbouring defined values (connect), or draw the point at the value axis base value (base).
With "connect", lines and areas bridge missing categories directly between the neighbouring defined values; with "base" the point is drawn at the value axis base value; the default "break" leaves a gap in the shape. For a series with a rangeProperty, a category counts as missing only when both properties are undefined — see partialRangeIsMissing.
- Default:
"break" - Validation:
should be one of [ "break", "connect", "base" ] - Used in: Waterfall · Heatmap · Missing Values · Waterfall · Heatmap · +3 more
order
The unique integer order of the series controlling its order of appearance.
- Default:
${index}— series index - Validation:
should be an integer;should be unique
partialRangeIsMissing
Whether to treat a value as missing when either of property or rangeProperty is undefined, instead of collapsing to the defined one.
Only affects series with a rangeProperty (stacked series are unaffected). By default a category with just one of property/rangeProperty undefined keeps a zero-extent span collapsed at the defined value, so ranged areas stay connected through it. When true such categories count as missing instead, following the configured missingValues treatment.
- Default:
false - Validation:
should be a boolean - Used in: Waterfall · Waterfall · Candlestick · Hollow Candlestick · +1 more
property
The property to retrieve from the data provider for the series values.
The chart reads this property from each category of the data provider to get the series value — it is the only series property without a default, so every series must set it. Use getDataErrors to check a dataset against the configured properties.
- Default: none
- Validation:
should be a defined value - Used in: Home · Getting started · Staged animation · Stacked · Grouped · Grouped Across Axes · +48 more
rangeProperty
The property to retrieve from the data provider for the secondary series values (use null for none).
When set, the series shape spans from the rangeProperty value to the property value instead of starting at the axis base — producing floating bars, a banded (low/high) area, or a pair of lines with the line renderer.
- Default:
null - Validation:
should be a defined value or equal to null - Used in: Thresholds and ranges · Waterfall · Heatmap · Range · Positive Negative Range · Waterfall · +4 more
renderer
The shape renderer to use when drawing the series shape (line, area, bar, none).
bar draws a rectangle per category value, line connects the values with a path, area fills between the value line and the value axis base, and none draws no shape. Different series in the same chart can use different renderers, e.g. bars with a line overlay.
- Default:
"line" - Validation:
should be one of [ "bar", "line", "area", "none" ] - Used in: Home · Getting started · Staged animation · Stacked · Grouped · Grouped Across Axes · +44 more
shapeStyle
The style of the series shape.
- Default:
{ normal: { … }, focused: { … }, defocused: { … } } - Validation:
should be an object with any of the properties { normal: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be equal to null, strokeDashArray: should be a valid dash array or be equal to null, fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }, focused: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 }, defocused: should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 } } - Used in: Thresholds and ranges · Waterfall · Heatmap · Color and Base Property · Color Property · Christmas Tree Bars · +8 more
shapeStyle.defocused
The style of the series shape, while the series is defocused.
- Default:
{ strokeColor: "same", strokeDashArray: "same", fillColor: "same" } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 } - Used in: Hollow Candlestick
shapeStyle.defocused.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette series color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ]
shapeStyle.defocused.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
0.5— when renderer is bar0.8— when renderer is line0.5— when renderer is area0.8— when renderer is none
- Validation:
should be a number >= to 0 and <= 1 - Used in: Hollow Candlestick
shapeStyle.defocused.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette series color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ]
shapeStyle.defocused.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
"same" - Validation:
should be a valid dash array or be one of [ null, "same" ]
shapeStyle.defocused.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
0.5— when renderer is bar0.8— when renderer is line0.5— when renderer is area0.8— when renderer is none
- Validation:
should be a number >= to 0 and <= 1
shapeStyle.defocused.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
0— when renderer is bar2— when renderer is line0— when renderer is area0— when renderer is none
- Validation:
should be a number >= to 0 or be one of [ null, "same" ] - Used in: Hollow Candlestick
shapeStyle.focused
The style of the series shape, while the series is focused.
- Default:
{ strokeColor: "same", strokeDashArray: "same", fillColor: "same" } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be one of [ null, "same" ], strokeDashArray: should be a valid dash array or be one of [ null, "same" ], fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 } - Used in: Hollow Candlestick
shapeStyle.focused.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette series color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ]
shapeStyle.focused.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
1— when renderer is bar1— when renderer is line1— when renderer is area1— when renderer is none
- Validation:
should be a number >= to 0 and <= 1 - Used in: Hollow Candlestick
shapeStyle.focused.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "same" to use the color of the normal state, or "seriesIndex" / "categoryIndex" to take the matching colorPalette series color by series or category index.
- Default:
"same" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "same", "seriesIndex", "categoryIndex" ]
shapeStyle.focused.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
"same" - Validation:
should be a valid dash array or be one of [ null, "same" ]
shapeStyle.focused.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
1— when renderer is bar1— when renderer is line1— when renderer is area1— when renderer is none
- Validation:
should be a number >= to 0 and <= 1
shapeStyle.focused.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
1— when renderer is bar4— when renderer is line1— when renderer is area0— when renderer is none
- Validation:
should be a number >= to 0 or be one of [ null, "same" ] - Used in: Hollow Candlestick
shapeStyle.normal
The style of the series shape, while the series is neither focused nor defocused.
- Default:
{ strokeColor: "seriesIndex", strokeDashArray: null, fillColor: "seriesIndex" } - Validation:
should be an object with any of the properties { strokeColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "seriesIndex", "categoryIndex" ], strokeOpacity: should be a number >= to 0 and <= 1, strokeWidth: should be a number >= to 0 or be equal to null, strokeDashArray: should be a valid dash array or be equal to null, fillColor: should be a valid svg color (or "none" / "currentColor") or be one of [ "seriesIndex", "categoryIndex" ], fillOpacity: should be a number >= to 0 and <= 1 } - Used in: Thresholds and ranges · Waterfall · Heatmap · Color and Base Property · Color Property · Christmas Tree Bars · +8 more
shapeStyle.normal.fillColor
The color of the fill: use "none" to switch the fill off, or "currentColor" to follow the host page's css color, or "seriesIndex" / "categoryIndex" to take the matching colorPalette series color by series or category index.
- Default:
"seriesIndex" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "seriesIndex", "categoryIndex" ] - Used in: Waterfall · Christmas Tree Bars · Range · Bubble Chart · +5 more
shapeStyle.normal.fillOpacity
The opacity (0 - 1) of the fill.
- Default:
0.8— when renderer is bar0.9— when renderer is line0.8— when renderer is area0.9— when renderer is none
- Validation:
should be a number >= to 0 and <= 1 - Used in: Thresholds and ranges · Heatmap · Color and Base Property · Color Property · Heatmap · +3 more
shapeStyle.normal.strokeColor
The color of the stroke (outline): use "none" to switch the stroke off, or "currentColor" to follow the host page's css color, or "seriesIndex" / "categoryIndex" to take the matching colorPalette series color by series or category index.
- Default:
"seriesIndex" - Validation:
should be a valid svg color (or "none" / "currentColor") or be one of [ "seriesIndex", "categoryIndex" ] - Used in: Waterfall · Christmas Tree Bars · Range · Bubble Chart · +5 more
shapeStyle.normal.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default:
null - Validation:
should be a valid dash array or be equal to null
shapeStyle.normal.strokeOpacity
The opacity (0 - 1) of the stroke.
- Default:
0.8— when renderer is bar0.9— when renderer is line0.8— when renderer is area0.9— when renderer is none
- Validation:
should be a number >= to 0 and <= 1 - Used in: Thresholds and ranges · Color and Base Property · Color Property · Hollow Candlestick
shapeStyle.normal.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
0— when renderer is bar3— when renderer is line0— when renderer is area0— when renderer is none
- Validation:
should be a number >= to 0 or be equal to null - Used in: Hollow Candlestick
showColorInLegend
Whether to show the series color as an icon next to the series title in the legend.
- Default:
false— when shapeStyle.normal.strokeColor or shapeStyle.normal.fillColor is categoryIndextrue— when neither shapeStyle.normal.strokeColor nor shapeStyle.normal.fillColor is categoryIndex
- Validation:
should be a boolean
showColorInTooltip
Whether to show the series color as an icon next to the series title in the tooltip.
- Default:
false— when shapeStyle.normal.strokeColor or shapeStyle.normal.fillColor is categoryIndextrue— when neither shapeStyle.normal.strokeColor nor shapeStyle.normal.fillColor is categoryIndex
- Validation:
should be a boolean
showInLegend
Whether to show the series in the legend.
- Default:
true - Validation:
should be a boolean - Used in: Heatmap · Heatmap · Candlestick · Hollow Candlestick · +1 more
showInTooltip
Whether to show the series in the tooltip.
- Default:
true - Validation:
should be a boolean - Used in: Hollow Candlestick
showPointer
Whether to show the pointer cursor when the user mouses over the series shapes in the chart.
Sets cursor: pointer on the series’ shapes (bars, markers, labels and line/area paths — or its pie slices), advertising that clicking does something. Typically paired with the onSeriesClick/onSliceClick callbacks or focusOnClick, which make the shapes clickable but leave the cursor unchanged by default.
- Default:
false - Validation:
should be a boolean
stack
The unique identifier of the series stack that the series belongs to (use null for none).
Series sharing the same stack id (an id from seriesStacks) are drawn stacked on one another and animate as a single unit, so the stack stays gapless mid-transition. Defaults to the sole stack id when exactly one stack is configured; use null to opt a series out.
- Default:
sole stack id— series stack - Validation:
should be a string or be equal to null;should equal the id property of one of the seriesStacks;should equal the id property of one of the seriesStacks that has the same axis property - Used in: Waterfall · Heatmap · Stacked · Stacked & Grouped · Axis Filtering Adjustment · +7 more
title
The title to display for the series in the legend (use null for none).
- Default:
null - Validation:
should be a string or be equal to null - Used in: Home · Getting started · Staged animation · Stacked · Grouped · Grouped Across Axes · +48 more
tooltipProperty
The property to retrieve from the data provider for the values shown for the series in the tooltip in place of the series values (use null for none).
useAxisFocus
Whether to show the series as focused when the value axis it belongs to is focused.
- Default:
true - Validation:
should be a boolean
useTitleForValueLabel
Whether to use the title value for the valueLabel value when the valueLabel is not set.
- Default:
true - Validation:
should be a boolean
valueFormat
The d3 format string to be applied to the series value when displayed in the tooltip (use null for none, use "auto" to derive from data ("auto" will use the value axis tick label format if it is set)).
A d3-format specifier applied to the value shown in the tooltip, e.g. ".1f" or ",.0f". "auto" derives a format from the data, preferring the value axis tickLabelFormat when that is set.
- Default:
"auto" - Validation:
should be a valid number format or be one of [ null, "auto" ] - Used in: Dual value axes · Tooltip formatting · Heatmap · Heatmap · Candlestick · Hollow Candlestick · +4 more
valueLabel
The label to show before a series value in the tooltip (use null for none).
- Default:
null - Validation:
should be a string or be equal to null - Used in: Candlestick · Hollow Candlestick · OHLC Bars
valuePrefix
The text to prefix series values with when showing them in the tooltip (use null for none).
- Default:
null - Validation:
should be a string or be equal to null - Used in: Tooltip formatting
valueSuffix
The text to append series values with when showing them in the tooltip (use null for none).
- Default:
null - Validation:
should be a string or be equal to null - Used in: Tooltip formatting