label

Configures axis labels.

Type: Object

Axis labels display the values of major axis ticks.

DevExtreme HTML5 Charts AxisLabels

The commonAxisSettings.label object, which is described here, specifies common settings for all axis labels in the chart. To configure only those labels that belong to a particular axis, use the following objects.

Axis-specific settings override common settings.

Show Example:
AngularJS
Knockout
jQuery

In this example, you can see the default appearance of axis labels.


                                    

                                    

In this example, you can see the default appearance of axis labels.


                                    

                                    

In this example, you can see the default appearance of axis labels.


                                    

                                    

alignment

Aligns axis labels in relation to ticks.

Type: String
Default Value: undefined
Accepted Values: 'left' | 'center' | 'right'

When using a widget as an ASP.NET MVC Control, specify this option using the HorizontalAlignment enum. This enum accepts the following values: Left, Center and Right.

Show Example:
AngularJS
Knockout
jQuery

In this example, you can change the value of the commonAxisSettings.label.alignment option using the select box under the chart.


                                    

                                    

                                    

In this example, you can change the value of the commonAxisSettings.label.alignment option using the select box under the chart.


                                    

                                    

                                    

In this example, you can change the value of the commonAxisSettings.label.alignment option using the select box under the chart.


                                    

                                    

                                    

displayMode

Allows you to rotate or stagger axis labels. Applies to the horizontal axis only.

Type: String
Default Value: 'standard'
Accepted Values: 'standard' | 'rotate' | 'stagger'
NOTE
Unless the rotated option is set to true, the argument axis is horizontal and the value axis is vertical.

This option accepts one of the following values.

  • rotate
    Rotates axis labels through the angle specified by the rotationAngle option.
  • stagger
    Arranges axis labels in two rows in a staggering manner. An empty space between the rows is specified by the staggeringSpacing option.
  • standard
    Does not change the default disposition of axis labels.

font

Specifies font options for axis labels.

Type: Object

indentFromAxis

Adds a pixel-measured empty space between an axis and its labels.

Type: Number
Default Value: 10

DevExtreme HTML5 Charts IdentFromAxis

See Also

overlappingBehavior

Decides how to arrange axis labels when there is not enough space to keep all of them.

Type: String|Object
Default Value: 'hide'
Accepted Values: 'stagger' | 'rotate' | 'hide' | 'none'

When axis labels overlap each other, you can rearrange them by setting the overlappingBehavior option. Depending on whether an axis is horizontal or vertical, this option accepts different values.

NOTE
Unless the rotated option is set to true, the argument axis is horizontal and the value axis is vertical.

The following values can be specified for both horizontal and vertical axes.

  • hide
    Hides certain axis labels leaving more space for the others.
  • none
    Leaves axis labels overlapped.

The following values can be specified for horizontal axes only.

  • rotate
    Rotates axis labels through the angle specified by the rotationAngle option.
  • stagger
    Arranges axis labels in two rows in a staggering manner. An empty space between the rows is specified by the staggeringSpacing option.

When using the widget as an ASP.NET MVC Control, specify this option using the OverlappingBehavior enum. This enum accepts the following values: Stagger, Rotate, Hide and None.

NOTE
Specifying this option with an object as well as with the "enlargeTickInterval" and "ignore" values is deprecated.
See Also
Show Example:
AngularJS
Knockout
jQuery

In this example, tick intervals are intentionally set to very small values so that axis labels overlap each other. You can choose an overlap resolving algorithm using the SelectBox under the Chart. Note that the "stagger" and "rotate" algorithms apply to the labels of the argument axis only.


                                    

                                    

                                    

In this example, tick intervals are intentionally set to very small values so that axis labels overlap each other. You can choose an overlap resolving algorithm using the SelectBox under the Chart. Note that the "stagger" and "rotate" algorithms apply to the labels of the argument axis only.


                                    

                                    

                                    

In this example, tick intervals are intentionally set to very small values so that axis labels overlap each other. You can choose an overlap resolving algorithm using the SelectBox under the Chart. Note that the "stagger" and "rotate" algorithms apply to the labels of the argument axis only.


                                    

                                    

                                    

rotationAngle

Specifies the rotation angle of axis labels. Applies only if displayMode or overlappingBehavior is "rotate".

Type: Number
Default Value: 90

Show Example:
AngularJS
Knockout
jQuery

In this example, you can change the rotationAngle option using the Slider under the Chart.


                                    

                                    

                                    

In this example, you can change the rotationAngle option using the Slider under the Chart.


                                    

                                    

                                    

In this example, you can change the rotationAngle option using the Slider under the Chart.


                                    

                                    

                                    

staggeringSpacing

Adds a pixel-measured empty space between two staggered rows of axis labels. Applies only if displayMode or overlappingBehavior is "stagger".

Type: Number
Default Value: 5

Show Example:
AngularJS
Knockout
jQuery

In this example, you can change the staggeringSpacing option using the Slider under the Chart.


                                    

                                    

                                    

In this example, you can change the staggeringSpacing option using the Slider under the Chart.


                                    

                                    

                                    

In this example, you can change the staggeringSpacing option using the Slider under the Chart.


                                    

                                    

                                    

visible

Shows/hides axis labels.

Type: Boolean
Default Value: true