Chart3DAxis

23 Sep 20258 minutes to read

Configures the axes in the chart.

Properties

columnIndex number

Specifies the index of the column where the axis is associated,
when the chart area is divided into multiple plot areas by using columns.

<div id='Chart3D'></div>

let chart3D: Chart3D = new Chart3D({
...
    columns: [{ width: '50%' },
              { width: '50%' }],
    axes: [{
               name: 'xAxis 1',
               columnIndex: 1,
    }],
...
});
chart3D.appendTo('#Chart3D');

Defaults to 0

desiredIntervals number

With this property, you can request axis to calculate intervals approximately equal to your specified interval.

Defaults to null

edgeLabelPlacement EdgeLabelPlacement

Specifies the position of labels at the edge of the axis.They are,

None: No action will be performed.
Hide: Edge label will be hidden.
Shift: Shifts the edge labels.

Defaults to ‘None’

enableTrim boolean

Specifies the Trim property for an axis.

Defaults to false

interval number

Specifies the interval for an axis.

Defaults to null

intervalType IntervalType

Specifies the types like Years, Months, Days, Hours, Minutes, Seconds in date time axis.They are,

Auto: Defines the interval of the axis based on data.
Years: Defines the interval of the axis in years.
Months: Defines the interval of the axis in months.
Days: Defines the interval of the axis in days.
Hours: Defines the interval of the axis in hours.
Minutes: Defines the interval of the axis in minutes.

Defaults to ‘Auto’

isIndexed boolean

Specifies indexed category axis.

Defaults to false

isInversed boolean

It specifies whether the axis to be rendered in inversed manner or not.

Defaults to false

labelFormat string

Used to format the axis label that accepts any global string format like ‘C’, ‘n1’, ‘P’ etc.
It also accepts placeholder like ‘{value}°C’ in which value represent the axis label, e.g, 20°C.

Defaults to ’’

labelIntersectAction LabelIntersectAction

Specifies the actions like None, Hide, Trim, Wrap, MultipleRows, Rotate45, and Rotate90
when the axis labels intersect with each other.They are,

None: Shows all the labels.
Hide: Hides the label when it intersects.
Trim: Trim the label when it intersects.
Wrap: Wrap the label when it intersects.
MultipleRows: Shows the label in MultipleRows when it intersects.
Rotate45: Rotates the label to 45 degree when it intersects.
Rotate90: Rotates the label to 90 degree when it intersects.

Defaults to Trim

labelPadding number

Specifies the labelPadding from axis.

Defaults to 5

labelPlacement LabelPlacement

Specifies the placement of a label for category axis. They are,

betweenTicks: Renders the label between the ticks.
onTicks: Renders the label on the ticks.

Defaults to ‘OnTicks’

labelRotation number

The angle to which the axis label gets rotated.

Defaults to 0

labelStyle Chart3DTextFontModel

Options to customize the axis label.

logBase number

The base value for logarithmic axis. It requires valueType to be Logarithmic.

Defaults to 10

majorGridLines Chart3DMajorGridLinesModel

Options for customizing major grid lines.

majorTickLines Chart3DMajorTickLinesModel

Options for customizing major tick lines.

maximum Object

Specifies the maximum range of an axis.

Defaults to null

maximumLabelWidth number

Specifies the maximum width of an axis label.

Defaults to 34.

maximumLabels number

The maximum number of label count per 100 pixels with respect to the axis length.

Defaults to 3

minimum Object

Specifies the minimum range of an axis.

Defaults to null

minorGridLines Chart3DMinorGridLinesModel

Options for customizing minor grid lines.

minorTickLines Chart3DMinorTickLinesModel

Options for customizing minor tick lines.

minorTicksPerInterval number

Specifies the number of minor ticks per interval.

Defaults to 0

name string

Unique identifier of an axis.
To associate an axis with the series, set this name to the xAxisName/yAxisName properties of the series.

Defaults to ’’

opposedPosition boolean

If set to true, the axis will render at the opposite side of its default position.

Defaults to false

plotOffset number

Left and right padding for the plot area in pixels.

Defaults to 0

plotOffsetBottom number

Bottom padding for the plot area in pixels.

Defaults to null

plotOffsetLeft number

Left padding for the plot area in pixels.

Defaults to null

plotOffsetRight number

Right padding for the plot area in pixels.

Defaults to null

plotOffsetTop number

Top padding for the plot area in pixels.

Defaults to null

rangePadding ChartRangePadding

Specifies the padding for the axis range in terms of interval.They are,

none: Padding cannot be applied to the axis.
normal: Padding is applied to the axis based on the range calculation.
additional: Interval of the axis is added as padding to the minimum and maximum values of the range.
round: Axis range is rounded to the nearest possible value divided by the interval.

Defaults to ‘Auto’

rowIndex number

Specifies the index of the row where the axis is associated, when the chart area is divided into multiple plot areas by using rows.

<div id='Chart3D'></div>

let chart3D: Chart3D = new Chart3D({
...
    rows: [{ height: '50%' },
           { height: '50%' }],
    axes: [{
               name: 'yAxis 1',
               rowIndex: 1,
     }],
...
});
chart3D.appendTo('#Chart3D');

Defaults to 0

skeleton string

Specifies the skeleton format in which the dateTime format will process.

Defaults to ’’

skeletonType SkeletonType

It specifies the type of format to be used in dateTime format process.

Defaults to ‘DateTime’

span number

Specifies the number of columns or rows an axis has to span horizontally or vertically.

Defaults to 1

startFromZero boolean

It specifies whether the axis to be start from zero.

Defaults to true

title string

Specifies the title of an axis.

Defaults to ’’

titlePadding number

Specifies the titlePadding from axis label.

Defaults to 5

titleRotation number

Defines an angle to rotate axis title. By default, angle auto calculated based on position and orientation of axis.

Defaults to null

titleStyle Chart3DTextFontModel

Options for customizing the axis title.

valueType ValueType

Specifies the data types that the axis can handle:

Double: This type is used for rendering a numeric axis to accommodate numeric data.
DateTime: This type is utilized for rendering a date-time axis to manage date-time data.
Category: This type is employed for rendering a category axis to manage categorical data.
Logarithmic: This type is applied for rendering a logarithmic axis to handle a wide range of values.
DateTimeCategory: This type is used to render a date time category axis for managing business days.

Defaults to ‘Double’

visible boolean

If set to true, axis label will be visible.

Defaults to true

Methods

findLabelSize

Finds the size of labels with specified inner padding within the 3D chart.

Parameter	Type	Description
innerPadding	`number`	The inner padding value for labels.
chart	`Chart3D`	The 3D chart for which label size is calculated.

Returns number

triggerRangeRender

Triggers the axis range calculated event with specified minimum, maximum, and interval values.

Parameter	Type	Description
chart	`Chart3D`	The 3D chart for which the range is being calculated.
minimum	`number`	The minimum value of the range.
maximum	`number`	The maximum value of the range.
interval	`number`	The interval value for the range.

Returns void