DateTimeCategoryAxis class
An axis which is used to plot date-time values. It is similar to DateTimeAxis except that it excludes missing dates.
This is a unique type of axis used mainly with financial series. Like CategoryAxis, all the data points are plotted with equal spaces by removing space for missing dates. Intervals and ranges for the axis are calculated similar to DateTimeAxis. There will be no visual gaps between points even when the difference between two points is more than a year.
A simple use case of this axis type is when the user wishes to visualize the working hours on an employee for a month by excluding the weekends.
Provides options for label placement, interval, date format for customizing the appearance.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- RenderObjectWidget
- LeafRenderObjectWidget
- ChartAxis
- DateTimeCategoryAxis
Constructors
-
DateTimeCategoryAxis({Key? key, String? name, bool isVisible = true, AxisTitle title = const AxisTitle(), AxisLine axisLine = const AxisLine(), ChartRangePadding rangePadding = ChartRangePadding.auto, EdgeLabelPlacement edgeLabelPlacement = EdgeLabelPlacement.none, ChartDataLabelPosition labelPosition = ChartDataLabelPosition.outside, TickPosition tickPosition = TickPosition.outside, int labelRotation = 0, AxisLabelIntersectAction labelIntersectAction = AxisLabelIntersectAction.hide, LabelAlignment labelAlignment = LabelAlignment.center, bool isInversed = false, bool opposedPosition = false, int maximumLabels = 3, MajorTickLines majorTickLines = const MajorTickLines(), MajorGridLines majorGridLines = const MajorGridLines(), TextStyle? labelStyle, double plotOffset = 0, double initialZoomFactor = 1, double initialZoomPosition = 0, InteractiveTooltip interactiveTooltip = const InteractiveTooltip(), DateTime? minimum, DateTime? maximum, double? interval, DateTime? initialVisibleMinimum, DateTime? initialVisibleMaximum, dynamic crossesAt, String? associatedAxisName, bool placeLabelsNearAxisLine = true, List<
PlotBand> plotBands = const <PlotBand>[], int? desiredIntervals, RangeController? rangeController, double? maximumLabelWidth, double? labelsExtent, LabelPlacement labelPlacement = LabelPlacement.betweenTicks, DateFormat? dateFormat, DateTimeIntervalType intervalType = DateTimeIntervalType.auto, DateTimeIntervalType autoScrollingDeltaType = DateTimeIntervalType.auto, int? autoScrollingDelta, double borderWidth = 0.0, Color? borderColor, AxisBorderType axisBorderType = AxisBorderType.rectangle, MultiLevelLabelStyle multiLevelLabelStyle = const MultiLevelLabelStyle(), MultiLevelLabelFormatterCallback? multiLevelLabelFormatter, List<DateTimeCategoricalMultiLevelLabel> ? multiLevelLabels, AutoScrollingMode autoScrollingMode = AutoScrollingMode.end, ChartLabelFormatterCallback? axisLabelFormatter, dynamic onRendererCreated(DateTimeCategoryAxisController)?}) -
Creating an argument constructor of DateTimeCategoryAxis class.
const
Properties
- anchorRangeToVisiblePoints → bool
-
Determines the value axis range, based on the visible data points or based
on the overall data points available in chart.
finalinherited
- associatedAxisName → String?
-
Axis line crossed on mentioned axis name,
and applicable for plot band also.
finalinherited
- autoScrollingDelta → int?
-
The number of data points to be visible always in the chart.
finalinherited
- autoScrollingDeltaType → DateTimeIntervalType
-
Defines the type of delta value in the DateTime axis.
final
- autoScrollingMode → AutoScrollingMode
-
Determines whether the axis should be scrolled from the start position or
end position.
finalinherited
- axisBorderType → AxisBorderType
-
Border type of the axis label.
finalinherited
- axisLabelFormatter → ChartLabelFormatterCallback?
-
Called while rendering each axis label in the chart.
finalinherited
- axisLine → AxisLine
-
Customizes the appearance of the axis line. The axis line is
visible by default.
finalinherited
- borderColor → Color?
-
Border color of the axis label.
finalinherited
- borderWidth → double
-
Border width of the axis label.
finalinherited
- crossesAt → dynamic
-
Customization to place the axis crossing on another axis based
on the value.
finalinherited
- dateFormat → DateFormat?
-
Formats the date-time category axis labels.
final
- desiredIntervals → int?
-
The number of intervals in an axis.
finalinherited
- edgeLabelPlacement → EdgeLabelPlacement
-
Position of the edge labels.
finalinherited
- enableAutoIntervalOnZooming → bool
-
Enables or disables the automatic interval while zooming.
finalinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
- initialVisibleMaximum → DateTime?
-
The maximum visible value of the axis.
final
- initialVisibleMinimum → DateTime?
-
The minimum visible value of the axis.
final
- initialZoomFactor → double
-
Zoom factor of an axis.
finalinherited
- initialZoomPosition → double
-
Position of the zoomed axis. The value ranges from 0 to 1.
finalinherited
- interactiveTooltip → InteractiveTooltip
-
Customizes the crosshair and selection zooming tooltip. Tooltip displays
the current axis value based on the crosshair position/selectionZoomRect
position at an axis.
finalinherited
- interval → double?
-
Axis interval value.
finalinherited
- intervalType → DateTimeIntervalType
-
Customizes the date-time category axis interval.
final
- isInversed → bool
-
Inverts the axis.
finalinherited
- isVisible → bool
-
Toggles the visibility of the axis.
finalinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- labelAlignment → LabelAlignment
-
Alignment of the labels.
finalinherited
- labelIntersectAction → AxisLabelIntersectAction
-
Axis labels intersecting action.
finalinherited
- labelPlacement → LabelPlacement
-
Position of the date-time category axis labels.
final
- labelPosition → ChartDataLabelPosition
-
Position of the labels.
finalinherited
- labelRotation → int
-
Angle for axis labels.
The axis labels can be rotated to any angle.
finalinherited
- labelsExtent → double?
-
Specifies the fixed width for the axis labels. This width represents the
space between axis line and axis title.
finalinherited
- labelStyle → TextStyle?
-
Customizes the appearance of the axis labels.
finalinherited
- majorGridLines → MajorGridLines
-
Customizes the appearance of the major grid lines.
finalinherited
- majorTickLines → MajorTickLines
-
Customizes the appearance of the major tick lines.
finalinherited
- maximum → DateTime?
-
Maximum value of the axis.
final
- maximumLabels → int
-
The maximum number of labels to be displayed in an axis in
100 logical pixels.
finalinherited
- maximumLabelWidth → double?
-
Specifies maximum text width for axis labels.
finalinherited
- minimum → DateTime?
-
Minimum value of the axis.
final
- minorGridLines → MinorGridLines
-
Customizes the appearance of the minor grid lines.
finalinherited
- minorTickLines → MinorTickLines
-
Customizes the appearance of the minor tick lines.
finalinherited
- minorTicksPerInterval → int
-
Interval of the minor ticks.
finalinherited
- multiLevelLabelFormatter → MultiLevelLabelFormatterCallback?
-
Called while rendering each multi-level label.
finalinherited
-
multiLevelLabels
→ List<
DateTimeCategoricalMultiLevelLabel> ? -
Provides the option to group the axis labels. You can customize the start,
end value of a multi-level label, text, and level of
the multi-level labels.
final
- multiLevelLabelStyle → MultiLevelLabelStyle
-
Customize the multi-level label’s border color, width, type, and
text style such as color, font size, etc.
finalinherited
- name → String?
-
Name of an axis.
finalinherited
- onRendererCreated → dynamic Function(DateTimeCategoryAxisController)?
-
final
- opposedPosition → bool
-
Opposes the axis position.
finalinherited
- placeLabelsNearAxisLine → bool
-
Consider to place the axis label respect to near axis line.
finalinherited
-
plotBands
→ List<
PlotBand> -
Render the plot band in axis.
finalinherited
- plotOffset → double
-
Padding for plot area. The axis is rendered in chart with padding.
finalinherited
- rangeController → RangeController?
-
The
rangeController
property is used to set the maximum and minimum values for the chart in the viewport. In the minimum and maximum properties of the axis, you can specify the minimum and maximum values with respect to the entire data source. In the visibleMinimum and visibleMaximum properties, you can specify the values to be viewed in the viewed port i.e. range controller's start and end values respectively.finalinherited - rangePadding → ChartRangePadding
-
Padding for minimum and maximum values in an axis.
finalinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- tickPosition → TickPosition
-
Position of the tick lines.
finalinherited
- title → AxisTitle
-
Customizes the appearance of the axis title.
finalinherited
Methods
-
createElement(
) → LeafRenderObjectElement -
RenderObjectWidgets always inflate to a RenderObjectElement subclass.
inherited
-
createRenderer(
) → RenderDateTimeCategoryAxis -
override
-
createRenderObject(
BuildContext context) → RenderDateTimeCategoryAxis -
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, 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
-
updateRenderObject(
BuildContext context, covariant RenderDateTimeCategoryAxis 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