HighchartsYAxisOptions class
The Y axis or value axis. Normally this is the vertical axis, though if the chart is inverted this is the horizontal axis. In case of multiple axes, the yAxis node is an array of configuration objects.
See the Axis object for programmatic access to the axis.
- Inheritance
-
- Object
- HighchartsOptionsBase
- HighchartsYAxisOptions
Constructors
-
HighchartsYAxisOptions.new({HighchartsXAxisAccessibilityOptions? accessibility, bool? alignTicks, bool? allowDecimals, String? alternateGridColor, double? angle, List<
HighchartsXAxisBreaksOptions> ? breaks, List<String> ? categories, double? ceiling, String? className, HighchartsXAxisCrosshairOptions? crosshair, double? crossing, HighchartsXAxisDateTimeLabelFormatsOptions? dateTimeLabelFormats, bool? endOnTick, HighchartsXAxisEventsOptions? events, double? floor, HighchartsXAxisGridOptions? grid, String? gridLineColor, String? gridLineDashStyle, String? gridLineInterpolation, double? gridLineWidth, double? gridZIndex, dynamic height, String? id, HighchartsYAxisLabelsOptions? labels, dynamic left, String? lineColor, double? lineWidth, double? linkedTo, double? margin, dynamic max, String? maxColor, dynamic maxLength, double? maxPadding, double? maxRange, double? maxZoom, dynamic min, String? minColor, dynamic minLength, 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, bool? opposite, double? pane, bool? panningEnabled, List<HighchartsYAxisPlotBandsOptions> ? plotBands, List<HighchartsYAxisPlotLinesOptions> ? plotLines, double? range, HighchartsYAxisResizeOptions? resize, bool? reversed, bool? reversedStacks, HighchartsYAxisScrollbarOptions? scrollbar, bool? showEmpty, bool? showFirstLabel, bool? showLastLabel, double? softMax, double? softMin, HighchartsYAxisStackLabelsOptions? stackLabels, HighchartsYAxisStackShadowOptions? stackShadow, double? startOfWeek, bool? startOnTick, double? staticScale, List<List> ? stops, double? tickAmount, String? tickColor, double? tickInterval, double? tickLength, double? tickPixelInterval, String? tickPosition, dynamic tickPositioner, List<double> ? tickPositions, double? tickWidth, String? tickmarkPlacement, HighchartsYAxisTitleOptions? title, String? tooltipValueFormat, dynamic top, String? type, bool? uniqueNames, List<List> ? units, bool? visible, dynamic width, double? zIndex, bool? zoomEnabled}) - The Y axis or value axis. Normally this is the vertical axis, though if the chart is inverted this is the horizontal axis. In case of multiple axes, the yAxis node is an array of configuration objects.
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
-
breaks
↔ List<
HighchartsXAxisBreaksOptions> ? -
An array defining breaks in the axis, the sections defined will be
left out and all the points shifted closer to each other.
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
- crosshair ↔ HighchartsXAxisCrosshairOptions?
-
Configure a crosshair that follows either the mouse pointer or the
hovered point.
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
- grid ↔ HighchartsXAxisGridOptions?
-
Set grid options for the axis labels. Requires Highcharts Gantt.
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?
-
Highcharts Options Widget.
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
- height ↔ dynamic
-
The height of the Y axis. If it's a number, it is interpreted as
pixels.
getter/setter pair
- 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 ↔ HighchartsYAxisLabelsOptions?
-
Highcharts Options Widget.
getter/setter pair
- left ↔ dynamic
-
The left position as the horizontal axis. If it's a number, it is
interpreted as pixel position relative to the chart.
getter/setter pair
- lineColor ↔ String?
-
The color of the line marking the axis itself.
getter/setter pair
- lineWidth ↔ double?
-
Highcharts Options Widget.
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
-
Highcharts Options Widget.
getter/setter pair
- maxColor ↔ String?
-
Solid gauge only. Unless stops are set, the color
to represent the maximum value of the Y axis.
getter/setter pair
- maxLength ↔ dynamic
-
Maximal size of a resizable axis. Could be set as a percent
of plot area or pixel size.
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 - maxRange ↔ double?
-
Maximum range which can be set using the navigator's handles.
Opposite of xAxis.minRange.
getter/setter pair
- maxZoom ↔ double?
-
Deprecated. Use
minRange
instead.getter/setter pair - min ↔ dynamic
-
Highcharts Options Widget.
getter/setter pair
- minColor ↔ String?
-
Solid gauge only. Unless stops are set, the color
to represent the minimum value of the Y axis.
getter/setter pair
- minLength ↔ dynamic
-
Minimal size of a resizable axis. Could be set as a percent
of plot area or pixel size.
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 max extreme is set usingaxis.setExtremes()
, the maxPadding 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 ↔ bool?
-
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<
HighchartsYAxisPlotBandsOptions> ? -
Highcharts Options Widget.
getter/setter pair
-
plotLines
↔ List<
HighchartsYAxisPlotLinesOptions> ? -
Highcharts Options Widget.
getter/setter pair
- range ↔ double?
-
The zoomed range to display when only defining one or none of
min
ormax
. For example, to show the latest month, a range of one month can be set.getter/setter pair - resize ↔ HighchartsYAxisResizeOptions?
-
Options for axis resizing. It adds a thick line between panes which
the user can drag in order to resize the panes.
getter/setter pair
- reversed ↔ bool?
-
Whether to reverse the axis so that the highest number is closest
to the origin.
getter/setter pair
- reversedStacks ↔ bool?
-
If
true
, the first series in a stack will be drawn on top in a positive, non-reversed Y axis. Iffalse
, the first series is in the base of the stack.getter/setter pair - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- scrollbar ↔ HighchartsYAxisScrollbarOptions?
-
An optional scrollbar to display on the Y axis in response to
limiting the minimum an maximum of the axis values.
getter/setter pair
- showEmpty ↔ bool?
-
Whether to show the axis line and title when the axis has no data.
getter/setter pair
- showFirstLabel ↔ bool?
-
Whether to show the first tick label.
getter/setter pair
- showLastLabel ↔ bool?
-
Whether to show the last tick label.
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
- stackLabels ↔ HighchartsYAxisStackLabelsOptions?
-
The stack labels show the total value for each bar in a stacked
column or bar chart. The label will be placed on top of positive
columns and below negative columns. In case of an inverted column
chart or a bar chart the label is placed to the right of positive
bars and to the left of negative bars.
getter/setter pair
- stackShadow ↔ HighchartsYAxisStackShadowOptions?
-
Relevant only for pictorial series. The
stackShadow
forms the background of stacked points. Requiresseries.stacking
to be defined.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
maxPadding
option to control the axis start.getter/setter pair - staticScale ↔ double?
-
For vertical axes only. Setting the static scale ensures that each tick unit
is translated into a fixed pixel height. For example, setting the static
scale to 24 results in each Y axis category taking up 24 pixels, and the
height of the chart adjusts. Adding or removing items will make the chart
resize.
getter/setter pair
-
stops
↔ List<
List> ? -
Solid gauge series only. Color stops for the solid gauge. Use this
in cases where a linear gradient between a
minColor
andmaxColor
is not sufficient. The stops is an array of tuples, where the first item is a float between 0 and 1 assigning the relative position in the gradient, and the second item is the color.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?
-
Highcharts Options Widget.
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.
getter/setter pair
- title ↔ HighchartsYAxisTitleOptions?
-
Highcharts Options Widget.
getter/setter pair
- tooltipValueFormat ↔ String?
-
Parallel coordinates only. Format that will be used for point.y
and available in tooltip.pointFormat as
{point.formattedValue}
. If not set,{point.formattedValue}
will use other options, in this order:getter/setter pair - top ↔ dynamic
-
The top position of the Y axis. If it's a number, it is interpreted
as pixel position relative to the chart.
getter/setter pair
- type ↔ String?
-
The type of axis. Can be one of
linear
,logarithmic
,datetime
,category
ortreegrid
. Defaults totreegrid
for Gantt charts,linear
for other chart types.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
- width ↔ dynamic
-
The width as the horizontal axis. If it's a number, it is interpreted
as pixels.
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