All docs
V20.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.

jQuery Chart - Error Bars

Error bars are used on charts to indicate an error or uncertainty in a reported measurement. They give a general idea of how precise the measurement is.

DevExtreme HTML5 JavaScript Charts Error Bars

Error bars can be generated either from concrete or calculated values. To generate one error bar, two values, high and low, are needed. If your data source provides concrete high and low values, assign the required data source fields to the highValueField and lowValueField properties of the series.valueErrorBar object.

jQuery
JavaScript
$(function() {
    $("#chartContainer").dxChart({
        // ...
        dataSource: [
            { arg: 1, val: 200, highError: 5, lowError: 3 },
            // ...
        ],
        series: {
            // ...
            valueErrorBar: {
                highValueField: 'highError',
                lowValueField: 'lowError'
            }
        }
    });
});
Angular
HTML
TypeScript
<dx-chart [dataSource]="chartDataSource">
    <dxi-series ... >
        <dxo-value-error-bar
            highValueField="highError"
            lowValueField="lowError">
        </dxo-value-error-bar>
    </dxi-series>
</dx-chart>
import { DxChartModule } from "devextreme-angular";
// ...
export class AppComponent {
    chartDataSource = [
        { arg: 1, val: 200, highError: 5, lowError: 3 },
        // ...
    ]
}
@NgModule({
    imports: [
        // ...
        DxChartModule
    ],
    // ...
})
Vue
App.vue
<template> 
    <DxChart
        :data-source="chartDataSource"
        ...
    >
        <DxSeries ... >
            <DxValueErrorBar
                high-value-field="highError"
                low-value-field="lowError"
            />
        </DxSeries>
    </DxChart>
</template>

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

export default {
    components: {
        DxChart,
        DxSeries,
        DxValueErrorBar
    },
    data() {
        return {
            chartDataSource: [
                { arg: 1, val: 200, highError: 5, lowError: 3 },
                // ...
            ]
        };
    }
}
</script>
React
App.js
import React from 'react';
import Chart, {
    Series,
    ValueErrorBar
} from 'devextreme-react/chart';

const chartDataSource = [
    { arg: 1, val: 200, highError: 5, lowError: 3 },
    // ...
];

class App extends React.Component {
    render() {
        return (
            <Chart
                dataSource={chartDataSource}
                ...
            >
                <Series ... >
                    <ValueErrorBar
                        highValueField="highError"
                        lowValueField="lowError"
                    />
                </Series>
            </Chart>
        );
    }
}

export default App;

Alternatively, error bar values can be calculated according to an algorithm. In this case, choose the needed algorithm using the type property and specify the value to be used in calculation using the value property.

jQuery
JavaScript
$(function() {
    $("#chartContainer").dxChart({
        // ...
        series: {
            // ...
            valueErrorBar: {
                type: 'percent',
                value: 5
            }
        }
    });
});
Angular
HTML
TypeScript
<dx-chart ... >
    <dxi-series ... >
        <dxo-value-error-bar
            type="percent"
            [value]="5">
        </dxo-value-error-bar>
    </dxi-series>
</dx-chart>
import { DxChartModule } from "devextreme-angular";
// ...
export class AppComponent {
    // ...
}
@NgModule({
    imports: [
        // ...
        DxChartModule
    ],
    // ...
})
Vue
App.vue
<template> 
    <DxChart ... >
        <DxSeries ... >
            <DxValueErrorBar
                :value="5"
                type="percent"
            />
        </DxSeries>
    </DxChart>
</template>

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

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

class App extends React.Component {
    render() {
        return (
            <Chart ... >
                <Series ... >
                    <ValueErrorBar
                        value={5}
                        type="percent"
                    />
                </Series>
            </Chart>
        );
    }
}

export default App;

If error bars should have uniform settings, you can specify them using one of the commonSeriesSettings.valueErrorBar object. Individual series settings override common settings.

jQuery
JavaScript
$(function() {
    $("#chartContainer").dxChart({
        // ...
        series: {
            valueErrorBar: {
                // high priority
            }
        },
        commonSeriesSettings: {
            valueErrorBar: {
                // low priority
            }
        }
    });
});
Angular
HTML
TypeScript
<dx-chart ... >
    <dxi-series>
        <dxo-value-error-bar>
            <!-- high priority -->
        </dxo-value-error-bar>
    </dxi-series>
    <dxo-common-series-settings>
        <dxo-value-error-bar>
            <!-- low priority -->
        </dxo-value-error-bar>
    </dxo-common-series-settings>
</dx-chart>
import { DxChartModule } from "devextreme-angular";
// ...
export class AppComponent {
    // ...
}
@NgModule({
    imports: [
        // ...
        DxChartModule
    ],
    // ...
})
Vue
App.vue
<template> 
    <DxChart ... >
        <DxSeries ... >
            <DxValueErrorBar ... >
                <!-- high priority -->
            </DxValueErrorBar>
        </DxSeries>

        <DxCommonSeriesSettings ... >
            <DxValueErrorBar ... >
                <!-- low priority -->
            </DxValueErrorBar>
        </DxCommonSeriesSettings>
    </DxChart>
</template>

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

export default {
    components: {
        DxChart,
        DxSeries,
        DxCommonSeriesSettings,
        DxValueErrorBar
    }
}
</script>
React
App.js
import React from 'react';
import Chart, {
    Series,
    CommonSeriesSettings,
    ValueErrorBar
} from 'devextreme-react/chart';

class App extends React.Component {
    render() {
        return (
            <Chart ... >
                <Series ... >
                    <ValueErrorBar ... >
                        {/* high priority */}
                    </ValueErrorBar>
                </Series>

                <CommonSeriesSettings ... >
                    <ValueErrorBar ... >
                        {/* low priority */}
                    </ValueErrorBar>
                </CommonSeriesSettings>
            </Chart>
        );
    }
}

export default App;

For information about all properties of the error bars, visit the valueErrorBar section of the API reference.

View Demo