LineChart class

A line chart widget supporting single or multi-series data.

Renders data as connected points using Braille sub-cell resolution. Supports optional markers, grid, axis labels, and per-series styling.

// Single-series (backward-compatible)
LineChart(values: [10, 20, 15, 30, 25], width: 60, height: 12)

// Multi-series with per-line colors
LineChart(
  series: [sineValues, cosineValues, noiseValues],
  lineStyles: [style1, style2, style3],
  legendEntries: [
    ChartLegendEntry('sin(t)', style1),
    ChartLegendEntry('cos(t)', style2),
    ChartLegendEntry('noise', style3),
  ],
)
Inheritance

Constructors

LineChart({List<double>? values, List<List<double>>? series, List<UvStyle>? lineStyles, int? width, int? height, UvStyle? lineStyle, UvStyle? gridStyle, UvStyle? labelStyle, bool showGrid = false, int gridRows = 3, int gridCols = 3, bool showMarkers = true, String markerChar = '●', String lineChar = '•', List<String>? xLabels, List<String>? yLabels, double? minValue, double? maxValue, List<ChartLegendEntry>? legendEntries, int legendColumns = 1, int legendRowGap = 0, ChartLegendPosition legendPosition = ChartLegendPosition.topRight, int legendPadding = 1, int? crosshairX, int? crosshairY, UvStyle? crosshairStyle, Key? key})

Properties

accessibilityLabel → String?
Optional accessibility label.
no setterinherited
accessibilityRole → String
Optional accessibility role.
no setterinherited
children → List<Widget>
Child widgets that receive forwarded messages.
no setterinherited
crosshairStyle → UvStyle?
final
crosshairX → int?
final
crosshairY → int?
final
debugRenderObjectPassthrough → bool
Whether this widget is intentionally transparent to render-object layouts.
no setterinherited
degradationSignal → WidgetDegradationSignal
Signal that controls this widget's render budget behavior.
no setterinherited
focusable → bool
Whether this widget can receive keyboard focus.
no setterinherited
gridCols → int
final
gridRows → int
final
gridStyle → UvStyle?
final
hashCode → int
The hash code for this object.
no setterinherited
height → int?
final
id → String
Unique identifier for this widget.
no setterinherited
key → Key?
Key for preserving widget identity.
finalinherited
labelStyle → UvStyle?
final
legendColumns → int
final
legendEntries → List<ChartLegendEntry>?
final
legendPadding → int
final
legendPosition → ChartLegendPosition
final
legendRowGap → int
final
lineChar → String
final
lineStyle → UvStyle?
final
lineStyles → List<UvStyle>?
Per-series line styles (cycled if shorter than series count).
final
markerChar → String
final
maxValue → double?
final
minValue → double?
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
series → List<List<double>>?
Multi-series data: list of value lists (one per series).
final
showGrid → bool
final
showMarkers → bool
final
theme → Theme
Access the current theme.
no setterinherited
values → List<double>?
Single-series data values (backward-compatible).
final
width → int?
final
xLabels → List<String>?
final
yLabels → List<String>?
final

Methods

buildCachedView<T>(T builder(), Object? cacheKey) → T
Returns a cached view if the cache key matches.
inherited
createRenderObject() → RenderObject
override
didUnmountRenderObject(RenderObject renderObject) → void
inherited
handleInit() → Cmd?
Override this instead of init for widget-specific initialization.
inherited
handleIntercept(Msg msg) → (Widget, Cmd?)
Override this to handle messages before they reach children.
inherited
handleUpdate(Msg msg) → (Widget, Cmd?)
Override this to handle messages specific to this widget.
inherited
init() → Cmd?
Called once when the widget is first mounted.
inherited
invalidateCachedView() → void
Clears any cached view for this widget.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
shouldRenderAt(DegradationLevel degradationLevel, {required bool subtreeHasFocusedWidget}) → bool
Whether this widget should participate in the current render when degradationLevel is active.
inherited
toString() → String
A string representation of this object.
inherited
update(Msg msg) → (Model, Cmd?)
Handles messages by forwarding to children then calling handleUpdate.
inherited
updateRenderObject(RenderObject renderObject) → void
override
view() → Object
Renders the widget to a string or View.
override

Operators

operator ==(Object other) → bool
The equality operator.
inherited