All docs
V20.2
24.2
24.1
23.2
23.1
22.2
22.1
21.2
21.1
20.2
20.1
19.2
The page you are viewing does not exist in version 19.2.
19.1
The page you are viewing does not exist in version 19.1.
18.2
The page you are viewing does not exist in version 18.2.
18.1
The page you are viewing does not exist in version 18.1.
17.2
The page you are viewing does not exist in version 17.2.
A newer version of this page is available. Switch to the current version.

JavaScript/jQuery Chart - 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.

DevExtreme HTML5 JavaScript Charts MultipleValueAxes

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
        ],
        // ...
    })
    Vue
    App.vue
    <template> 
        <DxChart ... >
            <DxValueAxis name="absoluteAxis"/>
            <DxValueAxis name="percentageAxis"/>
            <!-- ... -->
        </DxChart>
    </template>
    
    <script>
    import DxChart, {
        DxValueAxis
        // ...
    } from 'devextreme-vue/chart';
    
    export default {
        components: {
            DxChart,
            DxValueAxis
            // ...
        }
    }
    </script>
    React
    App.js
    import React from 'react';
    import Chart, {
        ValueAxis
        // ...
    } from 'devextreme-react/chart';
    
    class App extends React.Component {
        render() {
            return (
                <Chart ... >
                    <ValueAxis name="absoluteAxis"/>
                    <ValueAxis name="percentageAxis"/>
                    {/* ... */}
                </Chart>
            );
        }
    }
    
    export default App;
  2. Bind series to value axes
    Bind each series to a value axis using the axis property. If the axis property 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
        ],
        // ...
    })
    Vue
    App.vue
    <template> 
        <DxChart ... >
            <DxSeries axis="percentageAxis"/>
            <DxSeries axis="percentageAxis"/>
            <DxSeries>
                <!-- This series will be automatically bound to the 'absoluteAxis' -->
            </DxSeries>
            <!-- ... -->
        </DxChart>
    </template>
    
    <script>
    import DxChart, {
        DxSeries
        // ...
    } from 'devextreme-vue/chart';
    
    export default {
        components: {
            DxChart,
            DxSeries
            // ...
        }
    }
    </script>
    React
    App.js
    import React from 'react';
    import Chart, {
        Series
        // ...
    } from 'devextreme-react/chart';
    
    class App extends React.Component {
        render() {
            return (
                <Chart ... >
                    <Series axis="percentageAxis"/>
                    <Series axis="percentageAxis"/>
                    <Series>
                        {/* This series will be automatically bound to the 'absoluteAxis' */}
                    </Series>
                    {/* ... */}
                </Chart>
            );
        }
    }
    
    export default App;

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 property. In addition, you can add more space between two side-by-side axes using the multipleAxesSpacing property.

jQuery
JavaScript
$(function() {
    $("#chartContainer").dxChart({
        // ...
        valueAxis: [{
            name: 'absoluteAxis',
            synchronizedValue: 0
        }, {
            name: 'percentageAxis',
            synchronizedValue: 0,
            multipleAxesSpacing: 10
        }]
    });
});
Angular
HTML
TypeScript
<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
    ],
    // ...
})
Vue
App.vue
<template> 
    <DxChart ... >
        <DxValueAxis
            :synchronized-value="0"
            name="absoluteAxis"
        />
        <DxValueAxis
            :synchronized-value="0"
            :multiple-axes-spacing="10"
            name="percentageAxis"
        />
    </DxChart>
</template>

<script>
import DxChart, {
    DxValueAxis
} from 'devextreme-vue/chart';

export default {
    components: {
        DxChart,
        DxValueAxis
    }
}
</script>
React
App.js
import React from 'react';
import Chart, {
    ValueAxis
} from 'devextreme-react/chart';

class App extends React.Component {
    render() {
        return (
            <Chart ... >
                <ValueAxis
                    name="absoluteAxis"
                    synchronizedValue={0}
                />
                <ValueAxis
                    name="percentageAxis"
                    synchronizedValue={0}
                    multipleAxesSpacing={10}
                />
            </Chart>
        );
    }
}

export default App;

View Demo

See Also