argumentAxis

The argumentAxis object, which is described here, configures the argument axis individually. To specify common settings for all axes in a chart, use the commonAxisSettings object. Axis-specific settings override common settings.

axisDivisionFactor

For axes displaying numbers, the distance between major ticks depends on two interconnected options: axisDivisionFactor and tickInterval. Consider that you have specified both these options. If the specified tick interval leads the pixel distance between two ticks to being less than the axisDivisionFactor value, this tick interval will be ignored.

Use the axisDivisionFactor option only if you need to set the distance between ticks not knowing the axis values. Otherwise, use the tickInterval option.

See Also

categories

By default, arguments on a discrete axis keep the order of objects in the data source. For example, objects in the following data source are sorted by decreasing area value. The resulting arguments will be sorted the same way.

See Also

In this example, you can change the value of the discreteAxisDivisionMode option using the select box under the chart. Note how the grid lines change their position in accordance with the value of this option.

In this example, you can change the value of the discreteAxisDivisionMode option using the select box under the chart. Note how the grid lines change their position in accordance with the value of this option.

In this example, you can change the value of the discreteAxisDivisionMode option using the select box under the chart. Note how the grid lines change their position in accordance with the value of this option.

endOnTick

A grid is a set of mutually-crossing vertical and horizontal lines that stretch throughout the entire chart. Visually, grid lines can be considered extensions of major ticks. The grid improves the readability of chart data.

The commonAxisSettings.grid object specifies common settings for all grid lines in the chart. To configure only those grid lines that descend from a particular axis, use the following objects.

In this example, you can change the value of the argumentAxis.hoverMode option using the select box under the chart. To spot the difference between the "none" and "allArgumentPoints" settings, point to an axis label.

In this example, you can change the value of the argumentAxis.hoverMode option using the select box under the chart. To spot the difference between the "none" and "allArgumentPoints" settings, point to an axis label.

In this example, you can change the value of the argumentAxis.hoverMode option using the select box under the chart. To spot the difference between the "none" and "allArgumentPoints" settings, point to an axis label.

inverted

When an axis is inverted (that is, when this option is set to true), its maximum and minimum values swap their places. As a result, axis values ascend in the opposite direction. Along with the axis, series also become inverted.

logarithmBase

By default, ticks on a logarithmic axis are generated on a base of 10, i.e., 0.1, 1, 10, 100, 1000 etc. But you can specify the needed base using the logarithmBase option. For example, if you set this option to 5, the following ticks will be generated: 0.5, 5, 25, 125, 625, etc.

max

The min and max options specify custom limits for the argument axis, thus focusing the widget on a specific chart segment. By default, these options equal to the minimum and maximum arguments on the axis.

NOTE

If the valueMarginsEnabled option is true, the argument axis extends slightly beyond the min and max values.

maxValueMargin

Controls the empty space between the maximum series points and the axis. Applies only to the axes of the "continuous" and "logarithmic" type.

By default, the axes extend slightly beyond their extrema generating an empty space between the axes and the minimum/maximum series points. It prevents cutting off parts of those points. To control this empty space, use the minValueMargin and maxValueMargin options. These options are used in the following formulas for the actual start and end axis values.

min

The min and max options specify custom limits for the argument axis, thus focusing the widget on a specific chart segment. By default, these options equal to the minimum and maximum arguments on the axis.

NOTE

If the valueMarginsEnabled option is true, the argument axis extends slightly beyond the min and max values.

In addition to the major grid built on major ticks, the Chart widget provides the minor grid built on minor ticks.

NOTE

Neither minor ticks, nor the minor grid can be displayed if the axis is of the "discrete" type.

The commonAxisSettings.minorGrid object specifies common settings for all minor grid lines in the chart. To configure only those grid lines that descend from a particular axis, use the following objects.

Minor ticks divide the segment between two neighboring major ticks into smaller segments. Minor ticks are generated automatically, unless the minorTickInterval option is set.

If the axis displays numbers, assign a number to this option. If the axis displays date-time values, assign one of the accepted string values or an object to this option. The object should contain only one of all fields described in this section, for example:

When using the widget as an ASP.NET MVC Control, specify this option using the VizTimeInterval enum. This enum accepts the same values, but they start with an upper-case letter, for example, 'day' becomes Day.

See Also

argumentAxis.minorTickCount - specifies how many minor ticks to place between two neighboring major ticks.

minValueMargin

By default, the axes extend slightly beyond their extrema generating an empty space between the axes and the minimum/maximum series points. It prevents cutting off parts of those points. To control this empty space, use the minValueMargin and maxValueMargin options. These options are used in the following formulas for the actual start and end axis values.

See Also

A strip is a colored piece of the chart's background that highlights a range of values. Strips allow a viewer to see whether a certain series point falls in or out of a range.

Each object in the strips array configures a single strip. To limit a strip, set its startValue and endValue options. You may set only one of them, in which case the strip will not have a limit at one end. Note that setting the color option is also necessary for a strip to be displayed.

See Also

argumentAxis.stripStyle - specifies the appearance of those strips that belong to the argument axis.

commonAxisSettings.stripStyle - specifies the appearance of all strips in the widget.

Major ticks divide an axis into segments, thus improving the viewer's perception of visualized data. Major ticks are generated automatically, unless the tickInterval option is set.

If the axis displays numbers, assign a number to this option. If the axis displays date-time values, assign one of the accepted string values or an object to this option. The object should contain only one of all fields described in this section, for example:

When you use an axis of the "logarithmic"type, ticks are generated on a base of powers. For example, assuming that the logarithm base is 10 and the tick interval is 1, ticks are generated at 10-2, 10-1, 100, 101, 102, 103, etc. If the tick interval becomes 2, ticks are generated at 10-1, 101, 103, etc.

When using the widget as an ASP.NET MVC Control, specify this option using the VizTimeInterval enum. This enum accepts the same values, but they start with an upper-case letter, for example, 'day' becomes Day.

See Also

The axis title is a short text displayed alongside the axis. Usually, the axis title shows units of measurement for arguments displayed by the axis. You can put any text in the axis title though.

If you assign an object to the title option, specifying the text field of this object is necessary for the axis title to be displayed. Besides the object, the title option accepts a string, thus providing a shortcut for setting the axis title. Therefore, this:

title: 'Axis Title'

is the same as this:

title: {
text: 'Axis Title'
}

See Also

commonAxisSettings.title - specifies the appearance of all axis titles in the widget.

type

Continuous
Displays numeric and date-time arguments. To divide this axis into intervals, use the tickInterval option.

Discrete
Displays string arguments called "categories". To sort them, use the categories array.

Logarithmic
Displays numeric arguments. Each argument is the logarithmBase value raised to some power. For example, logarithmBase equaling to 10 produces the following arguments: 10-2, 10-1, 100, 101, 102, etc. The logarithmic axis is useful when you visualize a dataset of rapidly-growing values.

Normally, there is no need to specify this option, because the axis type is determined automatically depending on the type of arguments. However, you may force the use of a specific axis type, for example, to employ the "discrete" axis type with numeric or date-time arguments.

When using the widget as an ASP.NET MVC Control, specify this option using the AxisScaleType enum. This enum accepts the following values: Discrete, Continuous and Logarithmic.

valueMarginsEnabled

Adds an empty space between the axis and the minimum and maximum series points.

By default, the argument axis extends slightly beyond its extrema. It prevents cutting off parts of the minimum and maximum series points. To disable this feature, set the valueMarginsEnabled option to false.

See Also

argumentAxis.minValueMargin - sets a custom margin for minimum series points.

argumentAxis.maxValueMargin - sets a custom margin for maximum series points.