Chart.js

# Interface: CartesianScaleOptions

# Hierarchy

# Properties

# alignToPixels

• alignToPixels: boolean

Align pixel values to device pixels

# Inherited from

CoreScaleOptions.alignToPixels

# Defined in

types/index.d.ts:1179 (opens new window)

# axis

• axis: "x" | "y" | "r"

Which type of axis this is. Possible values are: 'x', 'y', 'r'. If not set, this is inferred from the first character of the ID which should be 'x', 'y' or 'r'.

# Defined in

types/index.d.ts:3241 (opens new window)

# backgroundColor

• backgroundColor: Color

Background color of the scale area.

# Inherited from

CoreScaleOptions.backgroundColor

# Defined in

types/index.d.ts:1183 (opens new window)

# border

• border: BorderOptions

# Defined in

types/index.d.ts:3261 (opens new window)

# bounds

• bounds: "data" | "ticks"

Scale boundary strategy (bypassed by min/max time options)

  • data: make sure data are fully visible, ticks outside are removed
  • ticks: make sure ticks are fully visible, data outside are truncated

Since

2.7.0

Default

'ticks'

# Defined in

types/index.d.ts:3220 (opens new window)

# clip

• clip: boolean

Clip the dataset drawing against the size of the scale instead of chart area.

Default

true

# Inherited from

CoreScaleOptions.clip

# Defined in

types/index.d.ts:1193 (opens new window)

# display

• display: boolean | "auto"

Controls the axis global visibility (visible when true, hidden when false). When display: 'auto', the axis is visible only if at least one associated dataset is visible.

Default

true

# Inherited from

CoreScaleOptions.display

# Defined in

types/index.d.ts:1175 (opens new window)

# grid

• grid: Partial<GridLineOptions>

# Defined in

types/index.d.ts:3259 (opens new window)

# max

• max: number

User defined maximum value for the scale, overrides maximum value from data.

# Overrides

CoreScaleOptions.max

# Defined in

types/index.d.ts:3251 (opens new window)

# min

• min: number

User defined minimum value for the scale, overrides minimum value from data.

# Overrides

CoreScaleOptions.min

# Defined in

types/index.d.ts:3246 (opens new window)

# offset

• offset: boolean

If true, extra space is added to the both edges and the axis is scaled to fit into the chart area. This is set to true for a bar chart by default.

Default

false

# Defined in

types/index.d.ts:3257 (opens new window)

# position

• position: "center" | "left" | "top" | "bottom" | "right" | { [scale: string]: number; }

Position of the axis.

# Defined in

types/index.d.ts:3225 (opens new window)

# reverse

• reverse: boolean

Reverse the scale.

Default

false

# Inherited from

CoreScaleOptions.reverse

# Defined in

types/index.d.ts:1188 (opens new window)

# stack

• Optional stack: string

Stack group. Axes at the same position with same stack are stacked.

# Defined in

types/index.d.ts:3230 (opens new window)

# stackWeight

• Optional stackWeight: number

Weight of the scale in stack group. Used to determine the amount of allocated space for the scale within the group.

Default

1

# Defined in

types/index.d.ts:3236 (opens new window)

# stacked

• Optional stacked: boolean | "single"

If true, data will be comprised between datasets of data

Default

false

# Defined in

types/index.d.ts:3290 (opens new window)

# suggestedMax

• suggestedMax: unknown

Adjustment used when calculating the minimum data value.

# Inherited from

CoreScaleOptions.suggestedMax

# Defined in

types/index.d.ts:1214 (opens new window)

# suggestedMin

• suggestedMin: unknown

Adjustment used when calculating the maximum data value.

# Inherited from

CoreScaleOptions.suggestedMin

# Defined in

types/index.d.ts:1210 (opens new window)

# ticks

• ticks: CartesianTickOptions

# Defined in

types/index.d.ts:3292 (opens new window)

# title

• title: Object

Options for the scale title.

# Type declaration

Name Type Description
align Align Alignment of the axis title.
color Color Color of the axis label.
display boolean If true, displays the axis title.
font ScriptableAndScriptableOptions<Partial<FontSpec>, ScriptableCartesianScaleContext> Information about the axis title font.
padding number | { bottom: number ; top: number ; y: number } Padding to apply around scale labels.
text string | string[] The text for the title, e.g. "# of People" or "Response Choices".

# Defined in

types/index.d.ts:3264 (opens new window)

# weight

• weight: number

The weight used to sort the axis. Higher weights are further away from the chart area.

Default

true

# Inherited from

CoreScaleOptions.weight

# Defined in

types/index.d.ts:1198 (opens new window)

# Methods

# afterBuildTicks

▸ afterBuildTicks(axis): void

Callback that runs after ticks are created. Useful for filtering ticks.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.afterBuildTicks

# Defined in

types/index.d.ts:1242 (opens new window)

# afterCalculateLabelRotation

▸ afterCalculateLabelRotation(axis): void

Callback that runs after tick rotation is determined.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.afterCalculateLabelRotation

# Defined in

types/index.d.ts:1258 (opens new window)

# afterDataLimits

▸ afterDataLimits(axis): void

Callback that runs after data limits are determined.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.afterDataLimits

# Defined in

types/index.d.ts:1234 (opens new window)

# afterFit

▸ afterFit(axis): void

Callback that runs after the scale fits to the canvas.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.afterFit

# Defined in

types/index.d.ts:1266 (opens new window)

# afterSetDimensions

▸ afterSetDimensions(axis): void

Callback that runs after dimensions are set.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.afterSetDimensions

# Defined in

types/index.d.ts:1226 (opens new window)

# afterTickToLabelConversion

▸ afterTickToLabelConversion(axis): void

Callback that runs after ticks are converted into strings.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.afterTickToLabelConversion

# Defined in

types/index.d.ts:1250 (opens new window)

# afterUpdate

▸ afterUpdate(axis): void

Callback that runs at the end of the update process.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.afterUpdate

# Defined in

types/index.d.ts:1270 (opens new window)

# beforeBuildTicks

▸ beforeBuildTicks(axis): void

Callback that runs before ticks are created.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.beforeBuildTicks

# Defined in

types/index.d.ts:1238 (opens new window)

# beforeCalculateLabelRotation

▸ beforeCalculateLabelRotation(axis): void

Callback that runs before tick rotation is determined.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.beforeCalculateLabelRotation

# Defined in

types/index.d.ts:1254 (opens new window)

# beforeDataLimits

▸ beforeDataLimits(axis): void

Callback that runs before data limits are determined.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.beforeDataLimits

# Defined in

types/index.d.ts:1230 (opens new window)

# beforeFit

▸ beforeFit(axis): void

Callback that runs before the scale fits to the canvas.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.beforeFit

# Defined in

types/index.d.ts:1262 (opens new window)

# beforeSetDimensions

▸ beforeSetDimensions(axis): void

Callback that runs before dimensions are set.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.beforeSetDimensions

# Defined in

types/index.d.ts:1222 (opens new window)

# beforeTickToLabelConversion

▸ beforeTickToLabelConversion(axis): void

Callback that runs before ticks are converted into strings.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.beforeTickToLabelConversion

# Defined in

types/index.d.ts:1246 (opens new window)

# beforeUpdate

▸ beforeUpdate(axis): void

Callback called before the update process starts.

# Parameters

Name Type
axis Scale<CoreScaleOptions>

# Returns

void

# Inherited from

CoreScaleOptions.beforeUpdate

# Defined in

types/index.d.ts:1218 (opens new window)

← CartesianScaleTypeRegistry →