DevExtreme jQuery - Multi-Axis Chart

A multi-axis chart adds extra meanings to visualized data in comparison to a single-axis chart. For example, in a single-axis chart, you have to choose which values to indicate - absolute or percentage. With a multi-axis chart, you are free to indicate both absolute and percentage values on two separate axis.

To configure a multi-axis chart, follow the steps below.

1. Create and name the value axes
   Declare several objects in the valueAxis array. Each object configures a single value axis. Then, give each value axis a unique name.

   jQuery

   JavaScript

   $(function() {
       $("#chartContainer").dxChart({
           // ...
           valueAxis: [{
               name: 'absoluteAxis'
           }, {
               name: 'percentageAxis'
           }]
       });
   });

   Angular

   HTML

   TypeScript

   <dx-chart ... >
       <dxi-value-axis name="absoluteAxis"></dxi-value-axis>
       <dxi-value-axis name="percentageAxis"></dxi-value-axis>
   </dx-chart>

   import { DxChartModule } from "devextreme-angular";
   // ...
   export class AppComponent {
       // ...
   }
   @NgModule({
       imports: [
           // ...
           DxChartModule
       ],
       // ...
   })

2. Bind series to value axes
   Bind each series to a value axis using the axis option. If the axis option is missing from the series configuration, such a series will be bound to the axis declared first in the valueAxis array.

   jQuery

   JavaScript

   $(function() {
       $("#chartContainer").dxChart({
           // ...
           series: [{
               axis: 'percentageAxis'
           }, {
               axis: 'percentageAxis'
           }, {
               // This series will be automatically bound to the 'absoluteAxis'
           }]
       });
   });

   Angular

   HTML

   TypeScript

   <dx-chart ... >
       ...
       <dxi-series axis="percentageAxis"></dxi-series>
       <dxi-series axis="percentageAxis"></dxi-series>
       <dxi-series>
           <!-- This series will be automatically bound to the 'absoluteAxis' -->
       </dxi-series>
   </dx-chart>

   import { DxChartModule } from "devextreme-angular";
   // ...
   export class AppComponent {
       // ...
   }
   @NgModule({
       imports: [
           // ...
           DxChartModule
       ],
       // ...
   })

All value axes in the Chart are synchronized by default, but you can explicitly specify the value at which one axis should be synchronized with others. For this purpose, set the synchronizedValue option. In addition, you can add more space between two side-by-side axes using the multipleAxesSpacing option.

$(function() {
    $("#chartContainer").dxChart({
        // ...
        valueAxis: [{
            name: 'absoluteAxis',
            synchronizedValue: 0
        }, {
            name: 'percentageAxis',
            synchronizedValue: 0,
            multipleAxesSpacing: 10
        }]
    });
});

<dx-chart ... >
    ...
    <dxi-value-axis
        name="absoluteAxis"
        [synchronizedValue]="0">
    </dxi-value-axis>
    <dxi-value-axis
        name="percentageAxis"
        [synchronizedValue]="0"
        [multipleAxesSpacing]="10">
    </dxi-value-axis>
</dx-chart>

import { DxChartModule } from "devextreme-angular";
// ...
export class AppComponent {
    // ...
}
@NgModule({
    imports: [
        // ...
        DxChartModule
    ],
    // ...
})

View Demo

See Also

• Multi-Pane Chart
• Limit and Relocate the Axes
• Chart API Reference