https://en.wikipedia.org
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you for the feedback!
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Backend API
<dx-chart
id="chart"
[dataSource]="dataSource"
[rotated]="true"
[barGroupPadding]="0.2"
>
<dxo-argument-axis [categories]="['Royal Houses']">
<dxo-tick [visible]="false"></dxo-tick>
</dxo-argument-axis>
<dxo-title
text="The British Monarchy"
subtitle="An Abbreviated Timeline"
></dxo-title>
<dxo-animation [enabled]="false"></dxo-animation>
<dxo-legend verticalAlignment="bottom" horizontalAlignment="center">
<dxo-title text="Royal Houses"></dxo-title>
</dxo-legend>
<dxo-series-template nameField="house"></dxo-series-template>
<dxo-common-series-settings
argumentField="monarch"
type="rangeBar"
rangeValue1Field="start"
rangeValue2Field="end"
barOverlapGroup="monarchs"
[minBarSize]="4"
>
</dxo-common-series-settings>
</dx-chart>
import { NgModule, Component, enableProdMode } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxChartModule } from 'devextreme-angular';
import { Data, Service } from './app.service';
if (!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
selector: 'demo-app',
templateUrl: `app/app.component.html`,
styleUrls: [`app/app.component.css`],
providers: [Service],
})
export class AppComponent {
dataSource: Data[];
constructor(service: Service) {
this.dataSource = service.getData();
}
}
@NgModule({
imports: [
BrowserModule,
DxChartModule,
],
declarations: [AppComponent],
bootstrap: [AppComponent],
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep #chart {
height: 440px;
}
import { Injectable } from '@angular/core';
export class Data {
house: string;
monarch: string;
start: Date;
end: Date;
}
const dataSource = [
{
monarch: 'Anne',
start: new Date(1701, 4, 1),
end: new Date(1714, 7, 1),
house: 'Stuart',
},
{
monarch: 'George I',
start: new Date(1714, 7, 1),
house: 'Hanover',
end: new Date(1727, 5, 11),
},
{
monarch: 'George II',
start: new Date(1727, 5, 11),
house: 'Hanover',
end: new Date(1760, 9, 25),
},
{
monarch: 'George III',
start: new Date(1760, 9, 25),
house: 'Hanover',
end: new Date(1820, 0, 29),
},
{
monarch: 'George IV',
start: new Date(1820, 0, 29),
house: 'Hanover',
end: new Date(1830, 5, 26),
},
{
monarch: 'William IV',
start: new Date(1830, 5, 26),
house: 'Hanover',
end: new Date(1837, 5, 20),
},
{
monarch: 'Victoria',
start: new Date(1837, 5, 20),
end: new Date(1901, 0, 22),
house: 'Hanover',
},
{
monarch: 'Edward VII',
start: new Date(1901, 0, 22),
house: 'Saxe-Coburg and Gotha',
end: new Date(1910, 4, 6),
},
{
monarch: 'George V',
start: new Date(1910, 4, 6),
house: 'Saxe-Coburg and Gotha',
end: new Date(1917, 5, 17),
},
{
monarch: 'George V',
start: new Date(1917, 5, 17),
house: 'Windsor',
end: new Date(1936, 0, 20),
},
{
monarch: 'Edward VIII',
start: new Date(1936, 0, 20),
house: 'Windsor',
end: new Date(1936, 11, 11),
},
{
monarch: 'George VI',
start: new Date(1936, 11, 11),
house: 'Windsor',
end: new Date(1952, 1, 6),
},
{
monarch: 'Elizabeth II',
house: 'Windsor',
start: new Date(1952, 1, 6),
end: new Date(2022, 8, 8),
},
{
monarch: 'Charles III',
house: 'Windsor',
start: new Date(2022, 8, 8),
end: new Date(),
},
{
house: 'Stuart',
start: new Date(1701, 4, 1),
end: new Date(1714, 7, 1),
monarch: 'Royal Houses',
},
{
end: new Date(1901, 0, 22),
house: 'Hanover',
start: new Date(1714, 7, 1),
monarch: 'Royal Houses',
},
{
start: new Date(1901, 0, 22),
end: new Date(1917, 5, 17),
house: 'Saxe-Coburg and Gotha',
monarch: 'Royal Houses',
},
{
house: 'Windsor',
start: new Date(1917, 5, 17),
end: new Date(),
monarch: 'Royal Houses',
},
];
@Injectable()
export class Service {
getData(): Data[] {
return dataSource;
}
}
// In real applications, you should not transpile code in the browser.
// You can see how to create your own application with Angular and DevExtreme here:
// https://js.devexpress.com/Documentation/Guide/Angular_Components/Getting_Started/Create_a_DevExtreme_Application/
const componentNames = [
'accordion',
'action-sheet',
'autocomplete',
'bar-gauge',
'box',
'bullet',
'button-group',
'button',
'calendar',
'chart',
'check-box',
'circular-gauge',
'color-box',
'context-menu',
'data-grid',
'date-box',
'date-range-box',
'defer-rendering',
'diagram',
'draggable',
'drawer',
'drop-down-box',
'drop-down-button',
'file-manager',
'file-uploader',
'filter-builder',
'form',
'funnel',
'gallery',
'gantt',
'html-editor',
'linear-gauge',
'list',
'load-indicator',
'load-panel',
'lookup',
'map',
'menu',
'multi-view',
'nested',
'number-box',
'pie-chart',
'pivot-grid-field-chooser',
'pivot-grid',
'polar-chart',
'popover',
'popup',
'progress-bar',
'radio-group',
'range-selector',
'range-slider',
'recurrence-editor',
'resizable',
'responsive-box',
'sankey',
'scheduler',
'scroll-view',
'select-box',
'slider',
'sortable',
'sparkline',
'speed-dial-action',
'splitter',
'switch',
'tab-panel',
'tabs',
'tag-box',
'text-area',
'text-box',
'tile-view',
'toast',
'toolbar',
'tooltip',
'tree-list',
'tree-map',
'tree-view',
'validation-group',
'validation-summary',
'validator',
'vector-map',
];
window.exports = window.exports || {};
window.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
},
meta: {
'typescript': {
'exports': 'ts',
},
'devextreme/time_zone_utils.js': {
'esModule': true,
},
'devextreme/localization.js': {
'esModule': true,
},
'devextreme/viz/palette.js': {
'esModule': true,
},
'@angular/platform-browser-dynamic': {
'esModule': true,
},
'@angular/platform-browser': {
'esModule': true,
},
'@angular/core': {
'esModule': true,
},
'@angular/common': {
'esModule': true,
},
'@angular/common/http': {
'esModule': true,
},
'@angular/compiler': {
'esModule': true,
},
'@angular/animations': {
'esModule': true,
},
'@angular/forms': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
'bundles:': '../../../../bundles/',
},
map: {
'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
/* @angular */
'@angular/compiler': 'bundles:@angular/compiler.umd.js',
'@angular/platform-browser-dynamic': 'bundles:@angular/platform-browser-dynamic.umd.js',
'@angular/core': 'bundles:@angular/core.umd.js',
'@angular/core/primitives/signals': 'bundles:@angular/core.primitives.signals.umd.js',
'@angular/common': 'bundles:@angular/common.umd.js',
'@angular/common/http': 'bundles:@angular/common-http.umd.js',
'@angular/platform-browser': 'bundles:@angular/platform-browser.umd.js',
'@angular/platform-browser/animations': 'bundles:@angular/platform-browser.umd.js',
'@angular/forms': 'bundles:@angular/forms.umd.js',
/* devextreme */
'devextreme': 'npm:devextreme@24.1.7/cjs',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.13',
'devextreme/bundles/dx.all': 'npm:devextreme@24.1.7/bundles/dx.all.js',
'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.13',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.56',
/* devextreme-angular umd maps */
'devextreme-angular': 'bundles:devextreme-angular/devextreme-angular.umd.js',
'devextreme-angular/core': 'bundles:devextreme-angular/devextreme-angular-core.umd.js',
'devextreme-angular/http': 'bundles:devextreme-angular/devextreme-angular-http.umd.js',
...componentNames.reduce((acc, name) => {
acc[`devextreme-angular/ui/${name}`] = `bundles:devextreme-angular/devextreme-angular-ui-${name}.umd.js`;
return acc;
}, {}),
'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js',
'tslib': 'npm:tslib@2.6.1/tslib.js',
'rxjs': 'npm:rxjs@7.5.3/dist/bundles/rxjs.umd.js',
'rxjs/operators': 'npm:rxjs@7.5.3/dist/cjs/operators/index.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.8/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js',
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts',
},
'devextreme': {
defaultExtension: 'js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
'rxjs': {
defaultExtension: 'js',
},
'rxjs/operators': {
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.13/inferno/package.json',
'npm:rxjs@7.5.3/package.json',
'npm:rxjs@7.5.3/operators/package.json',
'npm:devexpress-diagram@2.2.13/package.json',
'npm:devexpress-gantt@4.1.56/package.json',
],
};
System.config(window.config);
// System.import('@angular/compiler').catch(console.error.bind(console));
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<title>DevExtreme Demo</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.7/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.13.3/bundles/zone.umd.min.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.13/Reflect.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script src="config.js"></script>
<script>
System.import("app").catch(console.error.bind(console));
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<demo-app>Loading...</demo-app>
</div>
</body>
</html>
The exact timeline chart implementation steps depend on the data source. Below are general recommendations on how to create a timeline chart.
-
Choose a series type
Each event is represented by its name and start/end dates. In this case, the series type should have points with one argument and two values, for example, the Range Bar. -
Bind the series to data
You can bind the series to data directly or use a series template (depending on the data source). These approaches and their differences are described in the Bind Series to Data article. In this demo, we use a series template. -
Line up bars
Specify the barOverlapGroup to arrange bars in a line that displays a combined timeline. -
Rotate the chart
A range bar chart's bars are vertical. To make them horizontal, set the rotated property to true. -
Sort the events chronologically
Arguments maintain objects' order in the data source. If this order is not chronological, use the axis' categories array to specify the order.