CategoryAxis
Represents the category axis configuration options.
Definition
Package:@progress/kendo-angular-charts
Properties
Sets the time-interval steps when baseUnit is set to "fit" or "auto".
The axis tries to divide the active period into the smallest possible units that yield maxDateGroups or less discrete intervals.
Sets the category index or date at which the first value axis crosses this axis. Use an array to set the category indices or dates at which the value axes cross the category axis. To denote the far end of the axis, set an index greater than or equal to the number of categories.
background?
string
Sets the background color of the axis.
Sets the base time interval for the date axis.
The default base unit is automatically determined by the minimum difference between subsequent categories. Use "fit" to set a base unit and categoryAxis.baseUnitStep so the total number of categories does not exceed categoryAxis.maxDateGroups. Series data is aggregated for the specified base unit by using the series.aggregate function.
baseUnitStep?
number | "auto"
Sets the step (interval) between categories in base units.
Use "auto" to set the step so the total number of categories does not exceed categoryAxis.maxDateGroups. This option is ignored if categoryAxis.baseUnit is set to "fit".
categories?
any[]
Sets the category names. The Chart creates a category for every item of the array.
color?
string
Sets the color to apply to all axis elements.
Accepts a valid CSS color string, including HEX and RGB and can be overridden by categoryAxis.labels.color and categoryAxis.line.color.
Configures the crosshair options.
The crosshair is displayed when the categoryAxis.crosshair.visible option is set to true.
Configures the highlight options of the category axis.
justified?
boolean
Determines if the Chart positions categories and series points on major ticks.
This removes the empty space before and after the series. The default value is false except for "area", "verticalArea", "rangeArea", and "verticalRangeArea". This option is ignored if series.type is set to "bar", "column", "boxPlot", "ohlc", "candlestick", or "waterfall".
Configures the axis labels.
Configures the axis lines. Also affects the major and minor ticks, but not the grid lines.
Configures the major grid lines. These are the lines that are an extension of the major ticks through the body of the Chart.
Configures the category axis major ticks.
max?
any
Sets the last date displayed on a date category axis or the index of the last category displayed on a category axis.
By default, the max value is the same as the last category. This is often used in combination with categoryAxis.min and categoryAxis.roundToBaseUnit to set up a fixed date range.
maxDateGroups?
number
Sets the maximum number of groups (categories) to display when categoryAxis.baseUnit is set to "fit" or categoryAxis.baseUnitStep is set to "auto".
maxDivisions?
number
Sets the maximum number of ticks and labels to display. Applicable for date category axis.
min?
any
Sets the first date displayed on a date category axis or the index of the first category displayed on a category axis.
By default, the min value is the same as the first category. This is often used in combination with categoryAxis.max and categoryAxis.roundToBaseUnit to set up a fixed date range.
Configures the minor grid lines. These are the lines that are an extension of the minor ticks through the body of the Chart.
Configures the category axis minor ticks.
name?
string
Sets the unique axis name.
Used to associate a series with a category axis, which utilizes the series.categoryAxis option.
Configures the category axis notes.
pane?
string
Sets the name of the pane in which the category axis has to be rendered. If not set, the axis will be rendered in the first (default) pane.
Sets the plot bands of the category axis.
Configures the date axis date range labels.
reverse?
boolean
Determines if the category axis direction is reversed. By default, categories are listed from left to right and from bottom to top.
roundToBaseUnit?
boolean
Determines if the Chart rounds the first and last date to the nearest base unit.
Configures the selected axis range.
Setting this option enables axis selection and the range is index-based, starting from zero. Categories with indexes in the range (select.from, select.to) will be selected, but the last category in the range will not be included in the selection. If the categories are dates, specify the range with date values. Selection is only supported if the axis is horizontal.
startAngle?
number
Sets the angle (degrees) of the first category on the axis. Angles increase clockwise with zero to the left and negative values are acceptable.
Configures the title of the category axis.
To display the title, set the categoryAxis.title.text option.
type?
"category" | "date"
Sets the category axis type.
Use "category" for a discrete category axis or "date" for a specialized axis for displaying chronological data.
visible?
boolean
Determines if the Chart displays the category axis. By default, the category axis is visible.
Sets the week start day when the baseUnit is set to "weeks".