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
-
- Object
- Mark<
T> - SeriesMark<
T> - RangeAreaMark
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