Introduction
Getting Started
Vue 2 End of Support
Native Components
Wrapper Components
- Introduction
- Barcodes
- Buttons
- Charts
- - Overview
  - Chart
  - SparkLine
  - StockChart
  - Series Types
  - Glossary
  - API
- Chat
- DataSource
- Date Inputs
- Diagram
- Dialog
- Dropdowns
- DropDownTree
- Editor
- Gantt
- Gauges
- Grid (wrapper)
- Inputs
- Layout
- List Views
- ListBox
- Map
- MediaPlayer
- PivotGrid
- Popups
- Scheduler
- ScrollView
- Spreadsheet
- TreeList
- TreeMap
- TreeView
- Upload
- Validator
- Window
- Framework & Features
- Globalization
- Troubleshooting
- Using Wrapper Components in Vite
Sample Applications
Styling & Themes
Common Features
Project Setup
Knowledge Base
Changelog
FAQ
Troubleshooting

Components / Charts / API / xAxisProps Chart API /

New to Kendo UI for Vue? Start a free 30-day trial

XAxisProps

x-axis-x-axis-item-axis-crossing-value `Object | Date | Array`

(For objects) The value at which the X axis crosses this axis.
(For arrays) The value indices at which the X axes cross the value axis.
(For dates) The date at which the X axis crosses this axis.

x-axis-x-axis-item-background `String`

The background color of the axis.

x-axis-x-axis-item-base-unit `String`

The base time interval for the axis labels. The default baseUnit is determined automatically from the value range.

The supported options are:

milliseconds
seconds
minutes
hours
days
weeks
months
years

x-axis-x-axis-item-color `String`

The color of the axis. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-crosshair-color `String`

The color of the crosshair. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-crosshair-dash-type `String`

The dash type of the crosshair.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

x-axis-x-axis-item-crosshair-opacity `Number`

The opacity of the crosshair. By default, the crosshair is opaque.

The background color of the tooltip. Accepts any valid CSS color string, including hex and rgb.

The color of the border. Accepts any valid CSS color string, including hex and rgb.

The dash type of the border.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

The width (in pixels) of the border. By default, the border width is set to zero which means that the border will not appear.

The text color of the tooltip. Accepts any valid CSS color string, including hex and rgb.

The tooltip font.

The format used to display the tooltip. Uses kendo.format. Contains one placeholder ({0}) which represents the value value.

The padding of the crosshair tooltip. A numeric value will set all paddings.

The bottom padding of the crosshair tooltip.

The left padding of the crosshair tooltip.

The right padding of the crosshair tooltip.

The top padding of the crosshair tooltip.

The template which renders the tooltip.The fields which can be used in the template are: value—the value value.

If x-axis-x-axis-item-crosshair-tooltip-visible is set to true, the Chart will display the Scatter Chart x axis crosshair tooltip. By default, the Scatter Chart x axis crosshair tooltip is not visible.

x-axis-x-axis-item-crosshair-visible `Boolean`

If x-axis-x-axis-item-crosshair-visible is set to true, the Chart will display the Scatter Chart x axis crosshair. By default, the Scatter Chart x axis crosshair is not visible.

x-axis-x-axis-item-crosshair-width `Number`

The width (in pixels) of the crosshair.

x-axis-x-axis-item-labels-background `String`

The background color of the labels. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-labels-border-color `String`

The color of the border. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-labels-border-dash-type `String`

The dash type of the border.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

x-axis-x-axis-item-labels-border-width `Number`

The width (in pixels) of the border. By default, the border width is set to zero which means that the border will not appear.

x-axis-x-axis-item-labels-color `String`

The text color of the labels. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-labels-culture `String`

The culture that will be used when formatting date values. For more information, refer to the article on globalization.

x-axis-x-axis-item-labels-date-formats-days `String`

The format that is used when xAxis.baseUnit is set to days.

x-axis-x-axis-item-labels-date-formats-hours `String`

The format that is used when xAxis.baseUnit is set to hours.

x-axis-x-axis-item-labels-date-formats-months `String`

The format that is used when xAxis.baseUnit is set to months.

x-axis-x-axis-item-labels-date-formats-weeks `String`

The format that is used when xAxis.baseUnit is set to weeks.

x-axis-x-axis-item-labels-date-formats-years `String`

The format that is used when xAxis.baseUnit is set to years.

x-axis-x-axis-item-labels-font `String`

The font style of the labels.

x-axis-x-axis-item-labels-format `String`

The format used to display the labels. Uses kendo.format. Contains one placeholder ({0}) which represents the category value.

x-axis-x-axis-item-labels-margin `Number`

The margin of the labels. A numeric value will set all margins.

x-axis-x-axis-item-labels-margin-bottom `Number`

The bottom margin of the labels.

x-axis-x-axis-item-labels-margin-left `Number`

The left margin of the labels.

x-axis-x-axis-item-labels-margin-right `Number`

The right margin of the labels.

x-axis-x-axis-item-labels-margin-top `Number`

The top margin of the labels.

x-axis-x-axis-item-labels-mirror `Boolean`

If x-axis-x-axis-item-labels-mirror is set to true, the Chart will mirror the axis labels and ticks. If the labels are normally on the left side of the axis, mirroring the axis will render them to the right.

x-axis-x-axis-item-labels-padding `Number`

The padding of the labels. A numeric value will set all paddings.

x-axis-x-axis-item-labels-padding-bottom `Number`

The bottom padding of the labels.

x-axis-x-axis-item-labels-padding-left `Number`

The left padding of the labels.

x-axis-x-axis-item-labels-padding-right `Number`

The right padding of the labels.

x-axis-x-axis-item-labels-padding-top `Number`

The top padding of the labels.

x-axis-x-axis-item-labels-position `String`

The position of the axis labels. By default, labels are positioned next to the axis.

When the position is set to end, the labels are placed at the end of the crossing axis—typically, at the top or right end of the Chart unless the crossing axis was reversed.
When the position is set to start, the labels are placed at the start of the crossing axis—typically, at the left or bottom end of the Chart unless the crossing axis was reversed.

x-axis-x-axis-item-labels-rotation `Number | String`

The rotation angle of the labels. By default, the labels are not rotated. If the axis is horizontal, value-axis-value-axis-item-labels-rotation can be set to auto and, as a result, the labels will be rotated only if the slot size is not sufficient to accommodate the entire labels.

x-axis-x-axis-item-labels-rotation-align `String`

The alignment of the rotated labels that is relative to the slot center.

The supported values are:

end
center

By default, the closest end of the label will be aligned to the center. If set to center, the center of the rotated label will be aligned instead.

x-axis-x-axis-item-labels-rotation-angle `Number | String`

The rotation angle of the labels. By default, the labels are not rotated. If the axis is horizontal, value-axis-value-axis-item-labels-rotation can be set to auto and, as a result, the labels will be rotated only if the slot size is not sufficient to accommodate the entire labels.

x-axis-x-axis-item-labels-skip `Number`

The number of labels that will be skipped.

x-axis-x-axis-item-labels-step `Number`

The step for rendering the label. Renders every n^th label. By default, every label is rendered.

x-axis-x-axis-item-labels-template `String | Function`

The template which renders the labels. The template supports the value field which represents the category value.

x-axis-x-axis-item-labels-visible `Boolean`

If x-axis-x-axis-item-labels-visible is set to true, the Chart will display the x axis labels. By default, the x axis labels are visible.

x-axis-x-axis-item-labels-visual `Function`

A function for creating a custom visual for the labels.

The supported argument fields are:

createVisual—A function that can be used to get the default visual.
culture—The default culture (if set) on the label.
format—The default format of the label.
options—The label options.
rect—The kendo.geometry.Rect that defines where the visual will be rendered.
sender—The Chart instance (may be undefined).
text—The label text.
value—The category value.

x-axis-x-axis-item-line-color `String`

The color of the lines. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-line-dash-type `String`

The dash type of the line.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

x-axis-x-axis-item-line-visible `Boolean`

If x-axis-x-axis-item-line-visible is set to true, the Chart will display the x axis lines. By default, the x axis lines are visible.

x-axis-x-axis-item-line-width `Number`

The width (in pixels) of the line. Affects also the major and minor ticks but not the grid lines.

x-axis-x-axis-item-major-grid-lines-color `String`

The color of the lines. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-major-grid-lines-dash-type `String`

The dash type of the line.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

x-axis-x-axis-item-major-grid-lines-visible `Boolean`

If x-axis-x-axis-item-major-grid-lines-visible is set to false, the Chart will not display the x major grid lines. By default, the x major grid lines are visible.

x-axis-x-axis-item-major-grid-lines-width `Number`

The width (in pixels) of the line. Affects also the major and minor ticks but not the grid lines.

x-axis-x-axis-item-major-grid-lines-step `Number`

The step of the x axis major grid lines.

x-axis-x-axis-item-major-grid-lines-skip `Number`

The skip of the x axis major grid lines.

x-axis-x-axis-item-minor-grid-lines-color `String`

The color of the minor grid lines. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-minor-grid-lines-dash-type `String`

The dash type of the minor grid lines.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

x-axis-x-axis-item-minor-grid-lines-visible `Boolean`

If x-axis-x-axis-item-minor-grid-lines-visible is set to true, the Chart will display the minor grid lines. By default, the minor grid lines are visible.

x-axis-x-axis-item-minor-grid-lines-width `Number`

The width (in pixels) of the category axis minor grid lines.

x-axis-x-axis-item-minor-grid-lines-step `Number`

The step of the x axis minor grid lines.

x-axis-x-axis-item-minor-grid-lines-skip `Number`

The skip of the x axis minor grid lines.

x-axis-x-axis-item-minor-ticks-color `String`

The color of the x axis minor ticks lines. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-minor-ticks-size `Number`

The length of the tick line.

x-axis-x-axis-item-minor-ticks-visible `Boolean`

If x-axis-x-axis-item-minor-ticks-visible is set to true, the Chart will display the x axis minor ticks. By default, the x axis minor ticks are not visible.

x-axis-x-axis-item-minor-ticks-width `Number`

The width (in pixels) of the minor ticks.

x-axis-x-axis-item-minor-ticks-step `Number`

The step of the x axis minor ticks.

x-axis-x-axis-item-minor-ticks-skip `Number`

The skip of the x axis minor ticks.

x-axis-x-axis-item-major-ticks-color `String`

The color of the Scatter Chart x axis major ticks lines. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-major-ticks-size `Number`

The length of the tick line.

x-axis-x-axis-item-major-ticks-visible `Boolean`

If x-axis-x-axis-item-major-ticks-visible is set to true, the Chart will display the Scatter Chart x axis major ticks. By default, the category axis major ticks are visible.

x-axis-x-axis-item-major-ticks-width `Number`

The width (in pixels) of the major ticks.

x-axis-x-axis-item-major-ticks-step `Number`

The step of the x axis major ticks.

x-axis-x-axis-item-major-ticks-skip `Number`

The skip of the x axis major ticks.

x-axis-x-axis-item-major-unit `Number`

The interval between major divisions. If this is a date axis, the value represents the number of xAxis.baseUnits between major divisions. If xAxis.type is set to log, the majorUnit value will be used for the base of the logarithm.

x-axis-x-axis-item-max `Object`

The maximum value of the axis.

x-axis-x-axis-item-min `Object`

The minimum value of the axis.

x-axis-x-axis-item-minor-unit `Number`

The interval between minor divisions. Defaults to 1/5 of xAxis.majorUnit. If xAxis.type is set to log, the minorUnit value represents the number of divisions between two major units and defaults to the major unit minus one.

x-axis-x-axis-item-name `String`

The unique axis name. Associates a series with an X axis which uses the series.xAxis option.

x-axis-x-axis-item-narrow-range `Boolean`

If x-axis-x-axis-item-narrow-range is set to true, the Chart will prevent the automatic axis range from snapping to 0. Setting it to false will force the automatic axis range to snap to 0.

x-axis-x-axis-item-pane `String`

The name of the pane in which the axis will be rendered. If x-axis-x-axis-item-pane is not set, the axis will be rendered in the first (default) pane.

x-axis-x-axis-item-plot-bands `Array`

The plot bands of the x axis.

x-axis-x-axis-item-reverse `Boolean`

If x-axis-x-axis-item-reverse is set to true, the value axis direction will be reversed. By default, values increase from left to right and from bottom to top.

x-axis-x-axis-item-start-angle `Number`

The angle (degrees) where the 0 value is placed. Angles increase counterclockwise and zero is to the right. Negative values are acceptable.

x-axis-x-axis-item-title-background `String`

The background color of the title. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-title-border-color `String`

The color of the border. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-title-border-dash-type `String`

The dash type of the border.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

x-axis-x-axis-item-title-border-width `Number`

The width (in pixels) of the border. By default, the border width is set to zero which means that the border will not appear.

x-axis-x-axis-item-title-color `String`

The text color of the title. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-title-font `String`

The font style of the title.

x-axis-x-axis-item-title-margin `Number`

The margin of the title. A numeric value will set all margins.

x-axis-x-axis-item-title-margin-bottom `Number`

The bottom margin of the title.

x-axis-x-axis-item-title-margin-left `Number`

The left margin of the title.

x-axis-x-axis-item-title-margin-right `Number`

The right margin of the title.

x-axis-x-axis-item-title-margin-top `Number`

The top margin of the title.

x-axis-x-axis-item-title-padding `Number`

The padding of the title. A numeric value will set all paddings.

x-axis-x-axis-item-title-padding-bottom `Number`

The bottom padding of the title.

x-axis-x-axis-item-title-padding-left `Number`

The left padding of the title.

x-axis-x-axis-item-title-padding-right `Number`

The right padding of the title.

x-axis-x-axis-item-title-padding-top `Number`

The top padding of the title.

x-axis-x-axis-item-title-position `String`

The position of the title.

The supported values are:

top—(Applicable to vertical axes) The axis title is positioned on the top.
bottom—(Applicable to vertical axes) The axis title is positioned on the bottom.
left—(Applicable to horizontal axes) The axis title is positioned on the left.
right—(Applicable to horizontal axes) The axis title is positioned on the right.
center—The axis title is positioned in the center.

x-axis-x-axis-item-title-rotation `Number`

The rotation angle of the title. By default, the title is not rotated.

x-axis-x-axis-item-title-text `String`

The text of the title.

x-axis-x-axis-item-title-visible `Boolean`

If set to true, the Chart will display the Scatter Chart x axis title. By default, the Scatter Chart x axis title is visible.

x-axis-x-axis-item-title-visual `Function`

A function for creating a custom visual for the title.

The supported argument fields are:

text—The label text.
rect—The kendo.geometry.Rect that defines where the visual will be rendered.
sender—The Chart instance (may be undefined).
options—The label options.
createVisual—A function that can be used to get the default visual.

x-axis-x-axis-item-type `String`

The axis type.

The supported values are:

numeric—A umeric axis.
date—A specialized axis for displaying chronological data.
log—A logarithmic axis.

x-axis-x-axis-item-visible `Boolean`

If set to true, the Chart will display the x axis. By default, the x axis is visible.

x-axis-x-axis-item-notes-position `String`

The position of the x axis note. top—The note is positioned on the top.; bottom—The note is positioned on the bottom.; left—The note is positioned on the left. or right—The note is positioned on the right..

x-axis-x-axis-item-notes-icon-background `String`

The background color of the notes icon.

x-axis-x-axis-item-notes-icon-border-color `String`

The border color of the icon.

x-axis-x-axis-item-notes-icon-border-width `Number`

The border width of the icon.

x-axis-x-axis-item-notes-icon-size `Number`

The size of the icon.

x-axis-x-axis-item-notes-icon-type `String`

The icon shape.

The supported values are:

circle—The marker shape is circular.
square—The marker shape is square.
triangle—The marker shape is triangular.
cross—The marker is in the shape of a cross.

x-axis-x-axis-item-notes-icon-visible `Boolean`

The icon visibility.

x-axis-x-axis-item-notes-label-background `String`

The background color of the label. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-notes-label-border-color `String`

The color of the border. Accepts any valid CSS color string, including hex and rgb.

x-axis-x-axis-item-notes-label-border-dash-type `String`

The dash type of the border.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

inside—The label is positioned inside the icon.
outside—The label is positioned outside the icon.

x-axis-x-axis-item-notes-line-dash-type `String`

The dash type of the note line.

The supported dash types are:

dash—A line that consists of dashes.
dashDot—A line that consists of a repeating dash-dot pattern.
dot—A line that consists of dots.
longDash—A line that consists of a repeating long-dash pattern.
longDashDot—A line that consists of a repeating long-dash-dot pattern.
longDashDotDot—A line that consists of a repeating long-dash-dot-dot.
solid—A solid line.

rect—The kendo.geometry.Rect that defines where the visual will be rendered.
sender—The Chart instance (may be undefined).
options—The note options.
createVisual—A function that can be used to get the default visual.
value—The note value.

Product Bundles

DevCraft

Web

Mobile

Document Management

Desktop

Reporting & Mocking

Automated Testing

CMS

UI/UX Tools

Debugging

Extended Reality

Free Tools

Support and Learning

Resources

Productivity and Design Tools

XAxisProps