GaugeChartWidget class

A modern gauge chart widget for displaying a single metric value.

This widget displays a value on a semi-circular or circular gauge, useful for KPIs, progress indicators, and single-value metrics.

Features

  • Customizable value range
  • Smooth animations
  • Customizable segments
  • Full theme support

Example

GaugeChartWidget(
  value: 75,
  minValue: 0,
  maxValue: 100,
  theme: ChartTheme.light(),
  title: 'Performance',
)
Inheritance

Constructors

GaugeChartWidget({Key? key, required double value, double minValue = 0.0, double maxValue = 100.0, int segments = 5, double startAngleDegrees = 180.0, double sweepAngleDegrees = 180.0, ChartTheme? theme, bool showGrid = true, bool showAxis = true, bool showLabel = true, String? title, String? subtitle, String? centerLabel, String? unit, bool useGlassmorphism = false, bool useNeumorphism = false, VoidCallback? onChartTap, bool isLoading = false, bool isError = false, String? errorMessage})
const

Properties

centerLabel String?
final
errorMessage String?
final
hashCode int
The hash code for this object.
no setterinherited
isError bool
final
isLoading bool
final
key Key?
Controls how one widget replaces another widget in the tree.
finalinherited
maxValue double
The maximum value of the gauge.
final
minValue double
The minimum value of the gauge.
final
onChartTap VoidCallback?
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
segments int
The number of segments/divisions on the gauge.
final
showAxis bool
final
showGrid bool
final
showLabel bool
final
startAngleDegrees double
The start angle in degrees (0 is right, positive is clockwise).
final
subtitle String?
final
sweepAngleDegrees double
The sweep angle in degrees (how much of the circle to use).
final
theme ChartTheme?
final
title String?
final
unit String?
final
useGlassmorphism bool
final
useNeumorphism bool
final
value double
The current value to display on the gauge.
final

Methods

createElement() StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() State<GaugeChartWidget>
Creates the mutable state for this widget at a given location in the tree.
override
debugDescribeChildren() List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a one-line detailed description of the object.
inherited
toStringShort() String
A short, textual description of this widget.
inherited

Operators

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