Free Trial Buy

Range Series

Range Area and Range Bar series emphasize the difference between a point's high and low value using a shaded area or a set of bars respectively.

Assign "rangearea" or "rangebar" to the series[].type option to specify the corresponding series type. You can configure:

  • Each series individually using the series array;
  • All series in the Chart using the commonSeriesSettings object;
  • All Range Area or Range Bar series using the commonSeriesSettings.rangearea or commonSeriesSettings.rangebar object respectively.

Note that the range series require two value fields: rangeValue1Field and rangeValue2Field.

jQuery
JavaScript
$(function () {
    $("#chartContainer").dxChart({
        series: [{
            type: "rangearea",
            rangeValue1Field: "low",
            rangeValue2Field: "high"
        }, {
            // ...
        }],
        commonSeriesSettings: {
            rangearea: { ... },
            rangebar: { ... }
        }
    });
});
Angular
HTML
TypeScript
<dx-chart ... >
    <dxi-series
        type="rangearea"
        rangeValue1Field="low"
        rangeValue2Field="high">
    </dxi-series>
    <dxi-series ... ></dxi-series>
    ...
    <dxo-common-series-settings>
        <dxo-rangearea ... ></dxo-rangearea>
        <dxo-rangebar ... ></dxo-rangebar>
    </dxo-common-series-settings>
</dx-chart>
import { DxChartModule } from "devextreme-angular";
// ...
export class AppComponent {
    // ...
}
@NgModule({
    imports: [
        // ...
        DxChartModule
    ],
    // ...
})

See the RangeAreaSeries and RangeBarSeries API Reference sections for a full list of options available to a range series.

Range Series Demos

See Also