StackedBarSeries<T, D> class
Renders the stacked bar series.
Stacked bar chart consists of multiple bar series stacked horizontally one after another. The length of each series is determined by the value in each data point.
To render a stacked bar chart, create an instance of StackedBarSeries, and add it to the series collection property of SfCartesianChart.
Provides options to customize properties such as color, opacity, borderWidth, borderColor, borderRadius of the stacked bar segments.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- RenderObjectWidget
- SlottedMultiChildRenderObjectWidget<
SeriesSlot, RenderObject> - ChartSeries<
T, D> - CartesianSeries<
T, D> - XyDataSeries<
T, D> - StackedSeriesBase<
T, D> - StackedBarSeries
- Annotations
Constructors
-
StackedBarSeries({ValueKey<
String> ? key, ChartSeriesRendererFactory<T, D> ? onCreateRenderer, List<T> ? dataSource, required ChartValueMapper<T, D> ? xValueMapper, required ChartValueMapper<T, num> ? yValueMapper, ChartValueMapper<T, dynamic> ? sortFieldValueMapper, ChartValueMapper<T, Color> ? pointColorMapper, ChartValueMapper<T, String> ? dataLabelMapper, SortingOrder sortingOrder = SortingOrder.none, bool isTrackVisible = false, String groupName = '', Color trackColor = Colors.grey, Color trackBorderColor = Colors.transparent, double trackBorderWidth = 1.0, double trackPadding = 0.0, BorderRadius borderRadius = BorderRadius.zero, double spacing = 0.0, String? xAxisName, String? yAxisName, String? name, Color? color, double width = 0.7, MarkerSettings markerSettings = const MarkerSettings(), EmptyPointSettings emptyPointSettings = const EmptyPointSettings(), DataLabelSettings dataLabelSettings = const DataLabelSettings(), bool initialIsVisible = true, LinearGradient? gradient, LinearGradient? borderGradient, bool enableTooltip = true, double animationDuration = 1500, List<Trendline> ? trendlines, Color borderColor = Colors.transparent, double borderWidth = 2.0, SelectionBehavior? selectionBehavior, bool isVisibleInLegend = true, LegendIconType legendIconType = LegendIconType.seriesType, String? legendItemText, List<double> ? dashArray, double opacity = 1.0, double animationDelay = 0, SeriesRendererCreatedCallback<T, D> ? onRendererCreated, ChartPointInteractionCallback? onPointTap, ChartPointInteractionCallback? onPointDoubleTap, ChartPointInteractionCallback? onPointLongPress, CartesianShaderCallback? onCreateShader, List<int> ? initialSelectedDataIndexes}) -
Creating an argument constructor of StackedBarSeries class.
const
Properties
- animationDelay → double
-
Delay duration of the series animation.It takes a millisecond value as
input. By default, the series will get animated for the specified
duration. If animationDelay is specified, then the series will begin to
animate after the specified duration.
finalinherited
- animationDuration → double
-
Duration of the series animation. It takes millisecond value as input.
finalinherited
- borderColor → Color
-
final
- borderGradient → LinearGradient?
-
Fills the border of the chart series with gradient color.
finalinherited
- borderRadius → BorderRadius
-
Customizes the corners of the column. Each corner can be customized with
a desired value or with a single value.
final
- borderWidth → double
-
Border width of the series.
finalinherited
- color → Color?
-
Color of the series.
finalinherited
-
dashArray
→ List<
double> ? -
Dashes of the series.
finalinherited
-
dataLabelMapper
→ ChartValueMapper<
T, String> ? -
Field in the data source, which is considered as text for the data points.
finalinherited
- dataLabelSettings → DataLabelSettings
-
Customizes the data labels in a series. Data label is a text, which
displays the details about the data point.
finalinherited
-
dataSource
→ List<
T> ? -
Data required for rendering the series. If no data source is specified,
empty chart will be rendered without series.
finalinherited
- emptyPointSettings → EmptyPointSettings
-
Customizes the empty points, i.e. null data points in a series.
finalinherited
- enableTooltip → bool
-
Enables or disables the tooltip for this series. Tooltip will display more
details about data points when tapping the data point region.
finalinherited
- gradient → LinearGradient?
-
Fills the chart series with gradient color.
finalinherited
- groupName → String
-
Specifies the group name.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- initialIsVisible → bool
-
Visibility of the series.
finalinherited
-
initialSelectedDataIndexes
→ List<
int> ? -
List of data indexes to initially be selected.
finalinherited
- isTrackVisible → bool
-
Renders column with track. Track is a rectangular bar rendered from the
start to the end of the axis. Column series
will be rendered above the track.
finalinherited
- isVisibleInLegend → bool
-
Toggles the visibility of the legend item of this specific series
in the legend.
finalinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- legendIconType → LegendIconType
-
Shape of the legend icon. Any shape in the LegendIconType can be applied
to this property. By default, icon will be rendered based
on the type of the series.
finalinherited
- legendItemText → String?
-
Text to be displayed in legend. By default, the series name will be
displayed in the legend. You can change this by
setting values to this property.
finalinherited
- markerSettings → MarkerSettings
-
Indication of data points.
finalinherited
- name → String?
-
Name of the series. The name will be displayed in legend item by default.
If name is not specified for the series, then the current series index
with ‘series’ text prefix will be considered as series name.
finalinherited
-
onCreateRenderer
→ ChartSeriesRendererFactory<
T, D> ? -
Used to create the renderer for custom series.
finalinherited
- onCreateShader → CartesianShaderCallback?
-
Fills the data points with the gradient and image shaders.
finalinherited
- onPointDoubleTap → ChartPointInteractionCallback?
-
Called when double tapped on the chart data point.
finalinherited
- onPointLongPress → ChartPointInteractionCallback?
-
Called when long pressed on the chart data point.
finalinherited
- onPointTap → ChartPointInteractionCallback?
-
Called when tapped on the chart data point.
finalinherited
-
onRendererCreated
→ SeriesRendererCreatedCallback<
T, D> ? -
Triggers when the series renderer is created.
finalinherited
- opacity → double
-
Opacity of the series. The value ranges from 0 to 1.
finalinherited
-
pointColorMapper
→ ChartValueMapper<
T, Color> ? -
Field in the data source, which is considered as fill color
for the data points.
finalinherited
-
positions
→ List<
ChartDataPointType> -
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- selectionBehavior → SelectionBehavior?
-
Customizes the data points or series on selection.
finalinherited
-
slots
→ Iterable<
SeriesSlot> -
Returns a list of all available slots.
no setterinherited
-
sortFieldValueMapper
→ ChartValueMapper<
T, dynamic> ? -
Field in the data source, which is considered for sorting the data points.
finalinherited
- sortingOrder → SortingOrder
-
The data points in the series can be sorted in ascending or descending
order. The data points will be rendered in the specified order
if it is set to none.
finalinherited
- spacing → double
-
final
- trackBorderColor → Color
-
Color of the track border.
finalinherited
- trackBorderWidth → double
-
Width of the track border.
finalinherited
- trackColor → Color
-
Color of the track.
finalinherited
- trackPadding → double
-
Padding of the track.
finalinherited
-
trendlines
→ List<
Trendline> ? -
Customizes the trendlines.
finalinherited
- width → double
-
final
- xAxisName → String?
-
Name of the x-axis to bind the series.
finalinherited
-
xValueMapper
→ ChartValueMapper<
T, D> ? -
Field in the data source, which is considered as x-value.
finalinherited
- yAxisName → String?
-
Name of the y-axis to bind the series.
finalinherited
-
yValueMapper
→ ChartValueMapper<
T, num> ? -
Field in the data source, which is considered as y-value.
finalinherited
Methods
-
childForSlot(
SeriesSlot slot) → Widget? -
Returns the widget that is currently occupying the provided
slot
.inherited -
createElement(
) → SlottedRenderObjectElement< SeriesSlot, RenderObject> -
RenderObjectWidgets always inflate to a RenderObjectElement subclass.
inherited
-
createRenderer(
) → StackedBarSeriesRenderer< T, D> -
Create the stacked bar series renderer.
override
-
createRenderObject(
BuildContext context) → StackedBarSeriesRenderer< T, D> -
Creates an instance of the RenderObject class that this
RenderObjectWidget represents, using the configuration described by this
RenderObjectWidget.
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
-
didUnmountRenderObject(
covariant RenderObject renderObject) → void -
A render object previously associated with this widget has been removed
from the tree. The given RenderObject will be of the same type as
returned by this object's createRenderObject.
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}) → 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
-
transposed(
) → bool -
override
-
updateRenderObject(
BuildContext context, covariant StackedBarSeriesRenderer< T, D> renderObject) → void -
Copies the configuration described by this RenderObjectWidget to the
given RenderObject, which will be of the same type as returned by this
object's createRenderObject.
override
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited