BuyLog In
DevExtreme
All docs
V 19.1
24.2
The page you are viewing does not exist in version 24.2.
24.1
The page you are viewing does not exist in version 24.1.
23.2
The page you are viewing does not exist in version 23.2.
23.1
The page you are viewing does not exist in version 23.1.
22.2
The page you are viewing does not exist in version 22.2.
22.1
The page you are viewing does not exist in version 22.1.
21.2
The page you are viewing does not exist in version 21.2.
21.1
The page you are viewing does not exist in version 21.1.
20.2
The page you are viewing does not exist in version 20.2.
20.1
The page you are viewing does not exist in version 20.1.
19.2
19.1
18.2
18.1
17.2
All docs
V19.1

General Information

.NET Subscription

What's Included
DevExpress Installation
DevExpress Code Examples

Common Tools

Project Converter
Assembly Deployment Tool
Localization Service

Quality Assurance and Productivity

CodeRush for Visual Studio (FREE)
TestCafe Studio

Desktop

Controls

WinForms
WPF
VCL
WinUI

Tools

WinForms Skin Editor
WPF Theme Designer
WPF Theme Editor (Legacy)
Coded UI Test Extension

Frameworks and Libraries

XAF - Cross-Platform .NET App UI
XPO - .NET ORM Library (FREE)
XPO Profiler
Core Libraries
Drawing Graphics Library
.NET App Security & Web API Service (FREE)

Web

Controls and Extensions

ASP.NET Web Forms Controls
ASP.NET MVC Extensions
ASP.NET Core Controls
ASP.NET Bootstrap Controls
DevExtreme
DevExtreme ASP.NET MVC Controls
Blazor Components

Tools

ASP.NET Theme Builder
ASP.NET Theme Deployer

Maintenance Mode

ASP.NET Core Bootstrap Controls

Mobile

Xamarin UI Controls (FREE)
.NET MAUI (FREE)

Enterprise and Analytic Tools

Reporting
Report and Dashboard Server
BI Dashboard
Office File API

End-User Documentation

Interface Elements for Desktop
Interface Elements for Web
Dashboard for Desktop
Dashboard for Web
24.2
The page you are viewing does not exist in version 24.2.
24.1
The page you are viewing does not exist in version 24.1.
23.2
The page you are viewing does not exist in version 23.2.
23.1
The page you are viewing does not exist in version 23.1.
22.2
The page you are viewing does not exist in version 22.2.
22.1
The page you are viewing does not exist in version 22.1.
21.2
The page you are viewing does not exist in version 21.2.
21.1
The page you are viewing does not exist in version 21.1.
20.2
The page you are viewing does not exist in version 20.2.
20.1
The page you are viewing does not exist in version 20.1.
19.2
19.1
18.2
18.1
17.2
Full-text search
API Reference
UI Widgets
Accordion
ActionSheet
Autocomplete
BarGauge
Box
Bullet
Button
ButtonGroup
Calendar
Chart
Configuration
adaptiveLayout
adjustOnZoom
animation
annotations[]
argumentAxis
autoHidePointMarkers
barGroupPadding
barGroupWidth
barWidth
commonAnnotationSettings
commonAxisSettings
commonPaneSettings
commonSeriesSettings
containerBackgroundColor
crosshair
customizeAnnotation
customizeLabel
customizePoint
dataPrepareSettings
dataSource
defaultPane
disabled
elementAttr
equalBarWidth
export
legend
loadingIndicator
margin
maxBubbleSize
minBubbleSize
negativesAsZeroes
onArgumentAxisClick
onDisposing
onDone
onDrawn
onExported
onExporting
onFileSaving
onIncidentOccurred
onInitialized
onLegendClick
onOptionChanged
onPointClick
onPointHoverChanged
onPointSelectionChanged
onSeriesClick
onSeriesHoverChanged
onSeriesSelectionChanged
onTooltipHidden
onTooltipShown
onZoomEnd
onZoomStart
palette
paletteExtensionMode
panes
pathModified
pointSelectionMode
redrawOnResize
resolveLabelOverlapping
rotated
rtlEnabled
scrollBar
scrollingMode
series
seriesSelectionMode
seriesTemplate
size
stickyHovering
synchronizeMultiAxes
theme
title
tooltip
useAggregation
valueAxis
allowDecimals
autoBreaksEnabled
axisDivisionFactor
breaks[]
breakStyle
categories
color
constantLines[]
constantLineStyle
discreteAxisDivisionMode
endOnTick
grid
inverted
label
alignment
customizeHint
customizeText
displayMode
font
format
indentFromAxis
overlappingBehavior
rotationAngle
staggeringSpacing
textOverflow
visible
wordWrap
logarithmBase
max
maxAutoBreakCount
maxValueMargin
min
minorGrid
minorTick
minorTickCount
minorTickInterval
minValueMargin
minVisualRangeLength
multipleAxesSpacing
name
opacity
pane
placeholderSize
position
showZero
strips[]
stripStyle
synchronizedValue
tick
tickInterval
title
type
valueMarginsEnabled
valueType
visible
visualRange
visualRangeUpdateMode
wholeRange
width
zoomAndPan
zoomingMode
Methods
Events
Series Types
Chart Elements
CheckBox
CircularGauge
ColorBox
ContextMenu
DataGrid
DateBox
DeferRendering
DiagramCTP
Drawer
DropDownBox
DropDownButton
FileManagerCTP
FileUploader
FilterBuilder
Form
Funnel
Gallery
HtmlEditorCTP
LinearGauge
List
LoadIndicator
LoadPanel
Lookup
Map
Menu
MultiView
NavBar
NumberBox
PieChart
PivotGrid
PivotGridFieldChooser
PolarChart
Popover
Popup
ProgressBar
RadioGroup
RangeSelector
RangeSlider
Resizable
ResponsiveBox
Sankey
Scheduler
ScrollView
SelectBox
SlideOut
SlideOutView
Slider
Sparkline
SpeedDialAction
Switch
TabPanel
Tabs
TagBox
TextArea
TextBox
TileView
Toast
Toolbar
Tooltip
TreeList
TreeMap
TreeView
ValidationGroup
ValidationSummary
Validator
VectorMap
Markup Components
UI Events
CSS Classes
Data Layer
Types
Utilities
Getting Started
Angular
React
Vue
ASP.NET MVC 5
ASP.NET Core
Widgets
Data Binding
Common Features

General Information

.NET Subscription

What's Included
DevExpress Installation
DevExpress Code Examples

Common Tools

Project Converter
Assembly Deployment Tool
Localization Service

Quality Assurance and Productivity

CodeRush for Visual Studio (FREE)
TestCafe Studio

Desktop

Controls

WinForms
WPF
VCL
WinUI

Tools

WinForms Skin Editor
WPF Theme Designer
WPF Theme Editor (Legacy)
Coded UI Test Extension

Frameworks and Libraries

XAF - Cross-Platform .NET App UI
XPO - .NET ORM Library (FREE)
XPO Profiler
Core Libraries
Drawing Graphics Library
.NET App Security & Web API Service (FREE)

Web

Controls and Extensions

ASP.NET Web Forms Controls
ASP.NET MVC Extensions
ASP.NET Core Controls
ASP.NET Bootstrap Controls
DevExtreme
DevExtreme ASP.NET MVC Controls
Blazor Components

Tools

ASP.NET Theme Builder
ASP.NET Theme Deployer

Maintenance Mode

ASP.NET Core Bootstrap Controls

Mobile

Xamarin UI Controls (FREE)
.NET MAUI (FREE)

Enterprise and Analytic Tools

Reporting
Report and Dashboard Server
BI Dashboard
Office File API

End-User Documentation

Interface Elements for Desktop
Interface Elements for Web
Dashboard for Desktop
Dashboard for Web
A newer version of this page is available. Switch to the current version.

JavaScript/jQuery Chart - valueAxis.label

Configures the labels of the value axis.

Type:

Object

Axis labels display the values of major axis ticks.

DevExtreme HTML5 Charts AxisLabels

See Also
  • commonAxisSettings.label - configures the labels of all axes in the widget.

alignment

Aligns axis labels in relation to ticks.

Type:

String

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

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

customizeHint

Specifies the hint that appears when a user points to an axis label.

Type:

Function

Function parameters:
axisValue:

Object

Information on the axis value.

Object structure:
Name Type Description
value

Date

|

Number

|

String

The raw value.
valueText

String

The formatted value converted to a string.
Return Value:

String

The text for the hint to display.

DevExtreme HTML5 Charts AxisLabelHint

NOTE
As an alternative to the function’s parameter you can use the this keyword.

customizeText

Customizes the text displayed by axis labels.

Type:

Function

Function parameters:
axisValue:

Object

Information on the axis value.

Object structure:
Name Type Description
value

Date

|

Number

|

String

The raw value.
valueText

String

The formatted value converted to a string.
Return Value:

String

The text for the label to display.

Cannot be used in themes.

NOTE
As an alternative to the function’s parameter you can use the this keyword.

displayMode

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

Type:

String

Default Value: 'standard'
Accepted Values: 'rotate' | 'stagger' | 'standard'

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

format

Formats a value before it is displayed in an axis label.

Type:

Format

Default Value: undefined

See the format section for details on accepted values.

See Also

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

Default Value: 'hide'
Accepted Values: 'rotate' | 'stagger' | 'none' | 'hide'

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.

Use the OverlappingBehavior enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Stagger, Rotate, Hide, and None.

View Demo

See Also

rotationAngle

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

Type:

Number

Default Value: 90

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

textOverflow

Specifies what to do with axis labels that overflow the allocated space after applying wordWrap: hide, truncate them and display an ellipsis, or do nothing.

Type:

String

Default Value: 'none'
Accepted Values: 'ellipsis' | 'hide' | 'none'

Use the VizTextOverflow enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Ellipsis, Hide, and None.

visible

Shows/hides axis labels.

Type:

Boolean

Default Value: true

wordWrap

Specifies how to wrap texts that do not fit into a single line.

Type:

String

Default Value: 'normal'
Accepted Values: 'normal' | 'breakWord' | 'none'

The following modes are available:

  • "normal"
    Text breaks only at allowed breakpoints (for example, a space between two words).

  • "breakWord"
    Words can be broken if there are no available breakpoints in the line.

  • "none"
    Word wrap is disabled.

If the text overflows the container even after word wrap, the widget applies the textOverflow option.

Use the VizWordWrap enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Normal, BreakWord, and None.