Cartesian Axes

Common Configuration

All of the included cartesian axes support a number of common options.

NameTypeDefaultDescription
autoSkipBooleantrueIf true, automatically calculates how many labels that can be shown and hides labels accordingly. Turn it off to show all labels no matter what
autoSkipPaddingNumber0Padding between the ticks on the horizontal axis when autoSkip is enabled. Note: Only applicable to horizontal scales.
Number0Distance in pixels to offset the label from the centre point of the tick (in the y direction for the x axis, and the x direction for the y axis). Note: this can cause labels at the edges to be cropped by the edge of the canvas
maxRotationNumber90Maximum rotation for tick labels when rotating to condense labels. Note: Rotation doesn't occur until necessary. Note: Only applicable to horizontal scales.
minRotationNumber0Minimum rotation for tick labels. Note: Only applicable to horizontal scales.
mirrorBooleanfalseFlips tick labels around axis, displaying the labels inside the chart instead of outside. Note: Only applicable to vertical scales.
paddingNumber10Padding between the tick label and the axis. When set on a vertical axis, this applies in the horizontal (X) direction. When set on a horizontal axis, this applies in the vertical (Y) direction.

Axis ID

The properties dataset.xAxisID or dataset.yAxisID have to match the scale properties scales.xAxes.id or scales.yAxes.id. This is especially needed if multi-axes charts are used.

Creating Multiple Axes

In the example below, we are creating two Y axes. We then use the yAxisID property to map the datasets to their correct axes.

  1. var myChart = new Chart(ctx, {
  2. type: 'line',
  3. data: {
  4. datasets: [{
  5. // This binds the dataset to the left y axis
  6. yAxisID: 'left-y-axis'
  7. }, {
  8. data: [0.1, 0.5, 1.0, 2.0, 1.5, 0]
  9. label: 'Right dataset'
  10. // This binds the dataset to the right y axis
  11. yAxisID: 'right-y-axis',
  12. }],
  13. labels: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun']
  14. options: {
  15. scales: {
  16. yAxes: [{
  17. id: 'left-y-axis',
  18. type: 'linear',
  19. position: 'left'
  20. }, {
  21. id: 'right-y-axis',
  22. type: 'linear',
  23. position: 'right'
  24. }]
  25. }
  26. });