RangeAreaMark<T> class final

A filled band between paired low/high values at each x.

Gaps

low and high are FieldAccessor<T, num?>, not num, because RangeAreaDataPoint.gap is a real point with no interval and a TOTAL accessor cannot express one. Both null at a row lowers to RangeAreaDataPoint.gap; exactly one null is an authoring error and raises GrammarDiagnosticCode.incompleteRangeAreaInterval rather than guessing a bound. This mirrors PolarMark.intervalLow/intervalHigh.

No channels

Deliberate, not an omission. The range-area painter reads no per-point colour: it paints from the series colour, fillOpacity, the two boundary styles and the theme, and RangeAreaScreenPoint carries only the interval geometry. A colorBy or size channel would be accepted and then ignored, so none is offered.

What this mark does NOT carry

isXOrdered is absent because RangeAreaChartSeries hard-codes it true in its constructor — exactly as CandlestickChartSeries does — so a knob would be a lie.

fillGradient and pathAnimation WERE in this list. They were deliberately withheld when this mark shipped, because AreaMark and LineMark still refused the same two and carrying them here would have left an asymmetry a user hits immediately. Roadmap 1d closed that by giving all three families the path fields in one slice, which is why they are constructor parameters now rather than named refusals.

Every config field is nullable and null means "the RangeAreaChartSeries default". The defaults live on the series class alone and are resolved once at lowering, so the mark cannot carry a stale copy of one.

Inheritance

Constructors

RangeAreaMark({required FieldAccessor<T, num> x, required FieldAccessor<T, num?> low, required FieldAccessor<T, num?> high, String? id, String? name, Color? color, String? yAxisId, String? unit, FieldAccessor<T, String?>? label, FieldAccessor<T, String?>? pointKey, LineInterpolation? interpolation, double? tension, double? fillOpacity, RangeAreaBorderMode? borderMode, RangeAreaBoundaryStyle? upperBoundaryStyle, RangeAreaBoundaryStyle? lowerBoundaryStyle, bool? connectGaps, bool? showBoundaryMarkers, double? markerRadius, RangeAreaLabelConfig? labelConfig, RangeAreaHitTestMode? hitTestMode, AreaGradient? fillGradient, PathAnimationStyle? pathAnimation})
Creates a range-area band geometry.
const

Properties

borderMode RangeAreaBorderMode?
Which boundaries are stroked. Null keeps the series default.
final
color Color?
Base color for this geometry. Null inherits the theme's series color.
finalinherited
connectGaps bool?
Whether to bridge gaps rather than break the band. Null keeps the series default.
final
fillGradient AreaGradient?
Gradient painted through the band's fill instead of a flat colour. Null keeps the series default (RangeAreaChartSeries.fillGradient, which is unset), which is what null means on the series too.
final
fillOpacity double?
Fill opacity in [0, 1]. Null keeps the series default.
final
hashCode int
The hash code for this object.
no setteroverride
high FieldAccessor<T, num?>
Upper bound accessor. Null at a row means "no interval here".
final
hitTestMode RangeAreaHitTestMode?
Which region is interactive. Null keeps the series default.
final
id String?
Stable id for this mark.
finalinherited
interpolation LineInterpolation?
Boundary path interpolation. Null keeps the series default.
final
label FieldAccessor<T, String?>?
Per-point label accessor (ChartDataPoint.label). Null leaves every point unlabelled; an accessor returning null — or '', treated the same — leaves that one point unlabelled.
final
labelConfig RangeAreaLabelConfig?
Interval label configuration. Null keeps the series default.
final
low FieldAccessor<T, num?>
Lower bound accessor. Null at a row means "no interval here" — see the class docstring.
final
lowerBoundaryStyle RangeAreaBoundaryStyle?
Lower boundary stroke styling. Null keeps the series default.
final
markerRadius double?
Boundary marker radius in logical pixels. Null keeps the series default.
final
name String?
Display name used by legends and tooltips.
finalinherited
pathAnimation PathAnimationStyle?
Entrance and data-update motion for the band's paths. Null keeps the series default.
final
pointKey FieldAccessor<T, String?>?
Per-point stable identity accessor (ChartDataPoint.pointKey).
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
showBoundaryMarkers bool?
Whether to draw a marker at each boundary point. Null keeps the series default.
final
tension double?
Curve tension in [0, 1]. Null keeps the series default.
final
unit String?
Measure unit carried onto the lowered series (ChartSeries.unit). Null lowers to a series with no unit.
finalinherited
upperBoundaryStyle RangeAreaBoundaryStyle?
Upper boundary stroke styling. Null keeps the series default.
final
x FieldAccessor<T, num>
Horizontal position accessor. Values must be finite and strictly increasing across the data list.
final
yAxisId String?
Id of the YAxisConfig in PlotSpec.yAxes this mark measures against.
finalinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
override

Operators

operator ==(Object other) bool
The equality operator.
override