Clip Indicator Config
Configure the band marking plot edges that have data hidden behind them (applies when chart.type is xy).
- Validation: should be an object with any of the properties {
font,front,hatch,label,labelPadding,size,style,textStyle,visible}
Every property is optional and falls back to its default. Property anchors are stable: link to any entry as #clipIndicator.propertyName, and to a member of a nested property as #clipIndicator.propertyName.memberName.
font
The font of the clip indicator label (family, size, weight, style), each member falling back to chart.font when null.
- Default:
{ family: null, size: null, weight: null, style: null } - Validation: should be an object with any of the properties {
family,size,style,weight}
font.family
The css font-family of the text, or null to leave the font family to css.
- Default:
null - Validation:
should be a css font-family string with at least one character other than whitespace or be equal to null
font.size
The font size of the text, as a number of pixels or any css font-size string (a length with a unit, a percentage, a size keyword, or a calc/clamp/min/max/var function), or null to leave the font size to css.
- Default:
null - Validation:
should be a number of pixels greater than 0, or a css font-size string (a length above 0 with a unit, a percentage, a size keyword, or a calc/clamp/min/max/var function) or be equal to null
font.style
The css font-style of the text ("normal", "italic", "oblique"), or null to leave the font style to css.
- Default:
null - Validation:
should be one of [ "normal", "italic", "oblique" ] or be equal to null
font.weight
The css font-weight of the text (100 to 900 in hundreds, or "normal", "bold", "lighter", "bolder"), or null to leave the font weight to css.
- Default:
null - Validation:
should be one of [ 100, 200, 300, 400, 500, 600, 700, 800, 900, "normal", "bold", "lighter", "bolder" ] or be equal to null
front
Whether the clip indicator should be shown in front (true) or behind (false) the series shapes.
- Default:
true - Validation:
should be a boolean
hatch
The diagonal hatch filling the clip indicator band (use null for a flat fill instead).
- Default:
{ spacing: 6, lineWidth: 2 } - Validation: should be an object with any of the properties {
lineWidth,spacing} or be equal to null
hatch.lineWidth
The thickness (in pixels) of each hatch line; at or above spacing the hatch closes up into a flat fill.
- Default:
2 - Validation:
should be a number >= to 0
hatch.spacing
The distance (in pixels) between neighbouring hatch lines.
- Default:
6 - Validation:
should be a number >= to 0
label
The text shown in the clip indicator band, and the band's accessible name (use null for no label; the band is still shown).
- Default:
"Clipped" - Validation:
should be a string or be equal to null
labelPadding
The space (in pixels) between the clip indicator label and the edges of its band, which also determines the band depth when size is "auto".
- Default:
2 - Validation:
should be a number >= to 0
size
The depth (in pixels) of the clip indicator band (use "auto" to size it from the label plus labelPadding on both sides).
- Default:
"auto" - Validation:
should be a number >= to 0 or be equal to "auto"
style
The styles to apply to the clip indicator band, whose fillColor draws the hatch when one is set (strokeColor, strokeOpacity, strokeWidth, fillColor, fillOpacity (use null for none)).
- Default:
{ strokeColor: "currentColor", strokeOpacity: 0.4, strokeWidth: 1, strokeDashArray: null, fillColor: "currentColor", fillOpacity: 0.4 }: when hatch is set{ strokeColor: null, strokeOpacity: 0, strokeWidth: null, strokeDashArray: null, fillColor: "currentColor", fillOpacity: 0.15 }: when hatch is null
- Validation: should be an object with any of the properties {
fillColor,fillOpacity,strokeColor,strokeDashArray,strokeOpacity,strokeWidth}
style.fillColor
The color of the fill: use null to leave the svg fill attribute unset so that css can supply it, "none" to switch the fill off, or "currentColor" to follow the host page's css color.
- Default: none
- Validation:
should be a valid svg color (or "none" / "currentColor") or be equal to null
style.fillOpacity
The opacity (0 - 1) of the fill, or null to leave the svg fill-opacity attribute unset.
- Default: none
- Validation:
should be a number >= to 0 and <= 1 or be equal to null
style.strokeColor
The color of the stroke (outline): use null to leave the svg stroke attribute unset so that css can supply it, "none" to switch the stroke off, or "currentColor" to follow the host page's css color.
- Default: none
- Validation:
should be a valid svg color (or "none" / "currentColor") or be equal to null
style.strokeDashArray
The dash array pattern of the stroke (e.g. "5, 5"), or null for a solid stroke.
- Default: none
- Validation:
should be a valid dash array or be equal to null
style.strokeOpacity
The opacity (0 - 1) of the stroke, or null to leave the svg stroke-opacity attribute unset.
- Default: none
- Validation:
should be a number >= to 0 and <= 1 or be equal to null
style.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default: none
- Validation:
should be a number >= to 0 or be equal to null
textStyle
The styles to apply to the clip indicator label (strokeColor, strokeOpacity, strokeWidth, fillColor, fillOpacity (use null for none)).
- Default:
{ strokeColor: null, strokeOpacity: 0, strokeWidth: null, strokeDashArray: null, fillColor: "currentColor", fillOpacity: 0.7 } - Validation: should be an object with any of the properties {
fillColor,fillOpacity,strokeColor,strokeDashArray,strokeOpacity,strokeWidth}
textStyle.fillColor
The color of the fill: use null to leave the svg fill attribute unset so that css can supply it, "none" to switch the fill off, or "currentColor" to follow the host page's css color.
- Default:
"currentColor" - Validation:
should be a valid svg color (or "none" / "currentColor") or be equal to null
textStyle.fillOpacity
The opacity (0 - 1) of the fill, or null to leave the svg fill-opacity attribute unset.
- Default:
0.7 - Validation:
should be a number >= to 0 and <= 1 or be equal to null
textStyle.strokeColor
The color of the stroke (outline): use null to leave the svg stroke attribute unset so that css can supply it, "none" to switch the stroke off, or "currentColor" to follow the host page's css color.
- Default:
null - Validation:
should be a valid svg color (or "none" / "currentColor") or be equal to null
textStyle.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
textStyle.strokeOpacity
The opacity (0 - 1) of the stroke, or null to leave the svg stroke-opacity attribute unset.
- Default:
0 - Validation:
should be a number >= to 0 and <= 1 or be equal to null
textStyle.strokeWidth
The width (in pixels) of the stroke, or null to leave the svg stroke-width attribute unset.
- Default:
null - Validation:
should be a number >= to 0 or be equal to null
visible
Whether to mark the plot edges that have data hidden behind them, which happens when an axis min or max excludes some of the values.
- Default:
false: when chart.type is pietrue: when chart.type is xy
- Validation:
should be a boolean