HighchartsZAxisOptions class
The Z axis or depth axis for 3D plots.
See the Axis class for programmatic access to the axis.
- Inheritance
-
- Object
- HighchartsOptionsBase
- HighchartsZAxisOptions
Constructors
-
HighchartsZAxisOptions.new({HighchartsXAxisAccessibilityOptions? accessibility, bool? alignTicks, bool? allowDecimals, String? alternateGridColor, double? angle, List<
String> ? categories, double? ceiling, String? className, double? crossing, HighchartsXAxisDateTimeLabelFormatsOptions? dateTimeLabelFormats, bool? endOnTick, HighchartsXAxisEventsOptions? events, double? floor, String? gridLineColor, String? gridLineDashStyle, String? gridLineInterpolation, double? gridLineWidth, double? gridZIndex, String? id, HighchartsXAxisLabelsOptions? labels, double? linkedTo, double? margin, dynamic max, double? maxPadding, double? maxZoom, dynamic min, double? minPadding, double? minRange, double? minTickInterval, String? minorGridLineColor, String? minorGridLineDashStyle, double? minorGridLineWidth, String? minorTickColor, String? minorTickInterval, double? minorTickLength, String? minorTickPosition, double? minorTickWidth, bool? minorTicks, double? minorTicksPerMajor, double? offset, dynamic opposite, double? pane, bool? panningEnabled, List<HighchartsXAxisPlotBandsOptions> ? plotBands, List<HighchartsXAxisPlotLinesOptions> ? plotLines, bool? reversed, bool? reversedStacks, bool? showFirstLabel, bool? showLastLabel, double? softMax, double? softMin, double? startOfWeek, bool? startOnTick, double? tickAmount, String? tickColor, double? tickInterval, double? tickLength, double? tickPixelInterval, String? tickPosition, dynamic tickPositioner, List<double> ? tickPositions, double? tickWidth, String? tickmarkPlacement, HighchartsXAxisTitleOptions? title, String? type, bool? uniqueNames, List<List> ? units, bool? visible, double? zIndex, bool? zoomEnabled}) - The Z axis or depth axis for 3D plots.
Properties
- accessibility ↔ HighchartsXAxisAccessibilityOptions?
-
Accessibility options for an axis. Requires the accessibility module.
getter/setter pair
- alignTicks ↔ bool?
-
When using multiple axis, the ticks of two or more opposite axes
will automatically be aligned by adding ticks to the axis or axes
with the least ticks, as if
tickAmount
were specified.getter/setter pair - allowDecimals ↔ bool?
-
Whether to allow decimals in this axis' ticks. When counting
integers, like persons or hits on a web page, decimals should
be avoided in the labels. By default, decimals are allowed on small
scale axes.
getter/setter pair
- alternateGridColor ↔ String?
-
When using an alternate grid color, a band is painted across the
plot area between every other grid line.
getter/setter pair
- angle ↔ double?
-
In a polar chart, this is the angle of the Y axis in degrees, where
0 is up and 90 is right. The angle determines the position of the
axis line and the labels, though the coordinate system is unaffected.
Since v8.0.0 this option is also applicable for X axis (inverted
polar).
getter/setter pair
-
categories
↔ List<
String> ? -
If categories are present for the xAxis, names are used instead of
numbers for that axis.
getter/setter pair
- ceiling ↔ double?
-
The highest allowed value for automatically computed axis extremes.
getter/setter pair
- className ↔ String?
-
A class name that opens for styling the axis by CSS, especially in
Highcharts styled mode. The class name is applied to group elements
for the grid, axis elements and labels.
getter/setter pair
- crossing ↔ double?
-
The value on a perpendicular axis where this axis should cross. This
is typically used on mathematical plots where the axes cross at 0.
When
crossing
is set, space will not be reserved at the sides of the chart for axis labels and title, so those may be clipped. In this case it is better to place the axes without thecrossing
option.getter/setter pair - dateTimeLabelFormats ↔ HighchartsXAxisDateTimeLabelFormatsOptions?
-
For a datetime axis, the scale will automatically adjust to the
appropriate unit. This member gives the default string
representations used for each unit. For intermediate values,
different units may be used, for example the
day
unit can be used on midnight andhour
unit be used for intermediate values on the same axis.getter/setter pair - endOnTick ↔ bool?
-
Whether to force the axis to end on a tick. Use this option with
the
maxPadding
option to control the axis end.getter/setter pair - events ↔ HighchartsXAxisEventsOptions?
-
Event handlers for the axis.
getter/setter pair
- floor ↔ double?
-
The lowest allowed value for automatically computed axis extremes.
getter/setter pair
- gridLineColor ↔ String?
-
Color of the grid lines extending the ticks across the plot area.
getter/setter pair
- gridLineDashStyle ↔ String?
-
The dash or dot style of the grid lines. For possible values, see
this demonstration.
getter/setter pair
- gridLineInterpolation ↔ String?
-
Polar charts only. Whether the grid lines should draw as a polygon
with straight lines between categories, or as circles. Can be either
circle
orpolygon
. Since v8.0.0 this option is also applicable for X axis (inverted polar).getter/setter pair - gridLineWidth ↔ double?
-
The width of the grid lines extending the ticks across the plot area.
Defaults to 1 on the Y axis and 0 on the X axis, except for 3d
charts.
getter/setter pair
- gridZIndex ↔ double?
-
The Z index of the grid lines.
getter/setter pair
- hashCode → int
-
The hash code for this object.
no setterinherited
- id ↔ String?
-
An id for the axis. This can be used after render time to get
a pointer to the axis object through
chart.get()
.getter/setter pair - labels ↔ HighchartsXAxisLabelsOptions?
-
The axis labels show the number or category for each tick.
getter/setter pair
- linkedTo ↔ double?
-
Index of another axis that this axis is linked to. When an axis is
linked to a master axis, it will take the same extremes as
the master, but as assigned by min or max or by setExtremes.
It can be used to show additional info, or to ease reading the
chart by duplicating the scales.
getter/setter pair
- margin ↔ double?
-
If there are multiple axes on the same side of the chart, the pixel
margin between the axes. Defaults to 0 on vertical axes, 15 on
horizontal axes.
getter/setter pair
- max ↔ dynamic
-
The maximum value of the axis. If
undefined
, the max value is automatically calculated.getter/setter pair - maxPadding ↔ double?
-
Padding of the max value relative to the length of the axis. A
padding of 0.05 will make a 100px axis 5px longer. This is useful
when you don't want the highest data value to appear on the edge
of the plot area. When the axis'
max
option is set or a max extreme is set usingaxis.setExtremes()
, the maxPadding will be ignored.getter/setter pair - maxZoom ↔ double?
-
Deprecated. Use
minRange
instead.getter/setter pair - min ↔ dynamic
-
The minimum value of the axis. If
undefined
, the min value is automatically calculated.getter/setter pair - minorGridLineColor ↔ String?
-
Color of the minor, secondary grid lines.
getter/setter pair
- minorGridLineDashStyle ↔ String?
-
The dash or dot style of the minor grid lines. For possible values,
see this demonstration.
getter/setter pair
- minorGridLineWidth ↔ double?
-
Width of the minor, secondary grid lines.
getter/setter pair
- minorTickColor ↔ String?
-
Color for the minor tick marks.
getter/setter pair
- minorTickInterval ↔ String?
-
Specific tick interval in axis units for the minor ticks. On a linear
axis, if
"auto"
, the minor tick interval is calculated as a fifth of the tickInterval. Ifundefined
, minor ticks are not shown.getter/setter pair - minorTickLength ↔ double?
-
The pixel length of the minor tick marks.
getter/setter pair
- minorTickPosition ↔ String?
-
The position of the minor tick marks relative to the axis line.
Can be one of
inside
andoutside
.getter/setter pair - minorTicks ↔ bool?
-
Enable or disable minor ticks. The interval between the minor ticks
can be controlled either by the
minorTicksPerMajor setting, or as an
absolute minorTickInterval value.
getter/setter pair
- minorTicksPerMajor ↔ double?
-
The number of minor ticks per major tick. Works for
linear
,logarithmic
anddatetime
axes.getter/setter pair - minorTickWidth ↔ double?
-
The pixel width of the minor tick mark.
getter/setter pair
- minPadding ↔ double?
-
Padding of the min value relative to the length of the axis. A
padding of 0.05 will make a 100px axis 5px longer. This is useful
when you don't want the lowest data value to appear on the edge
of the plot area. When the axis'
min
option is set or a min extreme is set usingaxis.setExtremes()
, the minPadding will be ignored.getter/setter pair - minRange ↔ double?
-
The minimum range to display on this axis. The entire axis will not
be allowed to span over a smaller interval than this. For example,
for a datetime axis the main unit is milliseconds. If minRange is
set to 3600000, you can't zoom in more than to one hour.
getter/setter pair
- minTickInterval ↔ double?
-
The minimum tick interval allowed in axis values. For example on
zooming in on an axis with daily data, this can be used to prevent
the axis from showing hours. Defaults to the closest distance between
two points on the axis.
getter/setter pair
- offset ↔ double?
-
The distance in pixels from the plot area to the axis line.
A positive offset moves the axis with it's line, labels and ticks
away from the plot area. This is typically used when two or more
axes are displayed on the same side of the plot. With multiple
axes the offset is dynamically adjusted to avoid collision, this
can be overridden by setting offset explicitly.
getter/setter pair
- opposite ↔ dynamic
-
Whether to display the axis on the opposite side of the normal. The
normal is on the left side for vertical axes and bottom for
horizontal, so the opposite sides will be right and top respectively.
This is typically used with dual or multiple axes.
getter/setter pair
- pane ↔ double?
-
Refers to the index in the panes array. Used for circular
gauges and polar charts. When the option is not set then first pane
will be used.
getter/setter pair
- panningEnabled ↔ bool?
-
Whether to pan axis. If
chart.panning
is enabled, the option allows to disable panning on an individual axis.getter/setter pair -
plotBands
↔ List<
HighchartsXAxisPlotBandsOptions> ? -
An array of colored bands stretching across the plot area marking an
interval on the axis.
getter/setter pair
-
plotLines
↔ List<
HighchartsXAxisPlotLinesOptions> ? -
An array of lines stretching across the plot area, marking a specific
value on one of the axes.
getter/setter pair
- reversed ↔ bool?
-
Whether to reverse the axis so that the highest number is closest
to the origin. If the chart is inverted, the x axis is reversed by
default.
getter/setter pair
- reversedStacks ↔ bool?
-
This option determines how stacks should be ordered within a group.
For example reversed xAxis also reverses stacks, so first series
comes last in a group. To keep order like for non-reversed xAxis
enable this option.
getter/setter pair
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- showFirstLabel ↔ bool?
-
Whether to show the first tick label.
getter/setter pair
- showLastLabel ↔ bool?
-
Whether to show the last tick label. Defaults to
true
on cartesian charts, andfalse
on polar charts.getter/setter pair - softMax ↔ double?
-
A soft maximum for the axis. If the series data maximum is less than
this, the axis will stay at this maximum, but if the series data
maximum is higher, the axis will flex to show all data.
getter/setter pair
- softMin ↔ double?
-
A soft minimum for the axis. If the series data minimum is greater
than this, the axis will stay at this minimum, but if the series
data minimum is lower, the axis will flex to show all data.
getter/setter pair
- startOfWeek ↔ double?
-
For datetime axes, this decides where to put the tick between weeks.
0 = Sunday, 1 = Monday.
getter/setter pair
- startOnTick ↔ bool?
-
Whether to force the axis to start on a tick. Use this option with
the
minPadding
option to control the axis start.getter/setter pair - tickAmount ↔ double?
-
The amount of ticks to draw on the axis. This opens up for aligning
the ticks of multiple charts or panes within a chart. This option
overrides the
tickPixelInterval
option.getter/setter pair - tickColor ↔ String?
-
Color for the main tick marks.
getter/setter pair
- tickInterval ↔ double?
-
The interval of the tick marks in axis units. When
undefined
, the tick interval is computed to approximately follow the tickPixelInterval on linear and datetime axes. On categorized axes, aundefined
tickInterval will default to 1, one category. Note that datetime axes are based on milliseconds, so for example an interval of one day is expressed as24 * 3600 * 1000
.getter/setter pair - tickLength ↔ double?
-
The pixel length of the main tick marks.
getter/setter pair
- tickmarkPlacement ↔ String?
-
For categorized axes only. If
on
the tick mark is placed in the center of the category, ifbetween
the tick mark is placed between categories. The default isbetween
if thetickInterval
is 1, elseon
. In order to render tick marks on a category axis it is necessary to provide a tickWidth.getter/setter pair - tickPixelInterval ↔ double?
-
If tickInterval is
null
this option sets the approximate pixel interval of the tick marks. Not applicable to categorized axis.getter/setter pair - tickPosition ↔ String?
-
The position of the major tick marks relative to the axis line.
Can be one of
inside
andoutside
.getter/setter pair - tickPositioner ↔ dynamic
-
A callback function returning array defining where the ticks are
laid out on the axis. This overrides the default behaviour of
tickPixelInterval and tickInterval. The automatic tick positions are accessible
through
this.tickPositions
and can be modified by the callback.getter/setter pair -
tickPositions
↔ List<
double> ? -
An array defining where the ticks are laid out on the axis. This
overrides the default behaviour of tickPixelInterval and tickInterval.
getter/setter pair
- tickWidth ↔ double?
-
The pixel width of the major tick marks. Defaults to 0 on category
axes, otherwise 1.
getter/setter pair
- title ↔ HighchartsXAxisTitleOptions?
-
The axis title, showing next to the axis line.
getter/setter pair
- type ↔ String?
-
The type of axis. Can be one of
linear
,logarithmic
,datetime
orcategory
. In a datetime axis, the numbers are given in milliseconds, and tick marks are placed on appropriate values like full hours or days. In a category axis, the point names of the chart's series are used for categories, if not a categories array is defined.getter/setter pair - uniqueNames ↔ bool?
-
Applies only when the axis
type
iscategory
. WhenuniqueNames
is true, points are placed on the X axis according to their names. If the same point name is repeated in the same or another series, the point is placed on the same X position as other points of the same name. WhenuniqueNames
is false, the points are laid out in increasing X positions regardless of their names, and the X axis category will take the name of the last point in each position.getter/setter pair -
units
↔ List<
List> ? -
Datetime axis only. An array determining what time intervals the
ticks are allowed to fall on. Each array item is an array where the
first value is the time unit and the second value another array of
allowed multiples.
getter/setter pair
- visible ↔ bool?
-
Whether axis, including axis title, line, ticks and labels, should
be visible.
getter/setter pair
- zIndex ↔ double?
-
The Z index for the axis group.
getter/setter pair
- zoomEnabled ↔ bool?
-
Whether to zoom axis. If
chart.zoomType
is set, the option allows to disable zooming on an individual axis.getter/setter pair
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toJSON(
) → String -
Serializes the settings to a JSON string.
inherited
-
toOptionsJSON(
StringBuffer buffer) → void -
override
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited