DevExtreme v23.2 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Plain Data Structure

The TreeMap component visualizes data as a set of rectangles (tiles). The tile size corresponds to a data point value relative to other data points.

The TreeMap component works with collections of objects. If objects in your collection have a plain structure, the component visualizes them as tiles. If your data is hierarchical, the TreeMap displays it as a group of nested tiles.

To bind data to the component, assign the collection of objects to the TreeMap's dataSource property.

Once you assign the data source, specify the valueField and labelField properties. If you specify these properties, the component can determine the object fields that indicate TreeMap labels and values in the collection. The default values for these properties are value and name, respectively. This demo uses default values, so there is no need to explicitly specify value and label fields.

You can simulate a hierarchical data structure with a plain data structure as shown in this demo. To implement this technique, specify the idField and parentField properties. This demo specifies idField: 'id' and parentField: 'parentId', respectively.

For example, one group of objects in the demo data appears as follows:

{
    id: '3',
    name: 'Australia',
}, {
    id: '3_1',
    parentId: '3',
    value: 4840600,
    name: 'Sydney',
    country: 'Australia',
}, {
    id: '3_2',
    parentId: '3',
    value: 4440000,
    name: 'Melbourne',
    country: 'Australia',
},

This group of objects produces a tile with the Australia label. The Australia tile has two nested tiles labeled Sydney and Melbourne.

To make the TreeMap more informative, you can specify a title and implement a tooltip.

www.wikipedia.org
Backend API
<dx-tree-map id="treemap" [dataSource]="citiesPopulations" title="The Most Populated Cities by Continents" idField="id" parentField="parentId" > <dxo-tooltip [enabled]="true" format="thousands" [customizeTooltip]="customizeTooltip" ></dxo-tooltip> </dx-tree-map>
import { NgModule, Component, enableProdMode } from '@angular/core'; import { BrowserModule, BrowserTransferStateModule } from '@angular/platform-browser'; import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; import { DxTreeMapModule } from 'devextreme-angular'; import { CitiesPopulation, 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 { citiesPopulations: CitiesPopulation[]; constructor(service: Service) { this.citiesPopulations = service.getCitiesPopulations(); } customizeTooltip(arg) { const data = arg.node.data; let result = null; if (arg.node.isLeaf()) { result = `<span class='city'>${data.name}</span> (${ data.country})<br/>Population: ${arg.valueText}`; } return { text: result, }; } } @NgModule({ imports: [ BrowserModule, BrowserTransferStateModule, DxTreeMapModule, ], declarations: [AppComponent], bootstrap: [AppComponent], }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep #treemap { height: 500px; } ::ng-deep .city { font-weight: 500; }
import { Injectable } from '@angular/core'; export interface CitiesPopulation { id: string; name: string; parentId?: string; value?: number; country?: string; } const citiesPopulations: CitiesPopulation[] = [{ id: '1', name: 'Africa', }, { id: '1_1', parentId: '1', value: 21324000, name: 'Lagos', country: 'Nigeria', }, { id: '1_2', parentId: '1', value: 9735000, name: 'Kinshasa', country: 'Democratic Republic of the Congo', }, { id: '1_3', parentId: '1', value: 9278441, name: 'Cairo', country: 'Egypt', }, { id: '2', name: 'Asia', }, { id: '2_1', parentId: '2', value: 24256800, name: 'Shanghai', country: 'China', }, { id: '2_2', parentId: '2', value: 23500000, name: 'Karachi', country: 'Pakistan', }, { id: '2_3', parentId: '2', value: 21516000, name: 'Beijing', country: 'China', }, { id: '2_4', parentId: '2', value: 16787941, name: 'Delhi', country: 'India', }, { id: '2_5', parentId: '2', value: 15200000, name: 'Tianjin', country: 'China', }, { id: '3', name: 'Australia', }, { id: '3_1', parentId: '3', value: 4840600, name: 'Sydney', country: 'Austraila', }, { id: '3_2', parentId: '3', value: 4440000, name: 'Melbourne', country: 'Austraila', }, { id: '4', name: 'Europe', }, { id: '4_1', parentId: '4', value: 14160467, name: 'Istanbul', country: 'Turkey', }, { id: '4_2', parentId: '4', value: 12197596, name: 'Moscow', country: 'Russia', }, { id: '4_3', parentId: '4', value: 8538689, name: 'London', country: 'United Kingdom', }, { id: '4_4', parentId: '4', value: 5191690, name: 'Saint Petersburg', country: 'Russia', }, { id: '4_5', parentId: '4', value: 4470800, name: 'Ankara', country: 'Turkey', }, { id: '4_6', parentId: '4', value: 3517424, name: 'Berlin', country: 'Germany', }, { id: '5', name: 'North America', }, { id: '5_1', parentId: '5', value: 8874724, name: 'Mexico City', country: 'Mexico', }, { id: '5_2', parentId: '5', value: 8550405, name: 'New York City', country: 'United States', }, { id: '5_3', parentId: '5', value: 3884307, name: 'Los Angeles', country: 'United States', }, { id: '5_4', parentId: '5', value: 2808503, name: 'Toronto', country: 'Canada', }, { id: '6', name: 'South America', }, { id: '6_1', parentId: '6', value: 11895893, name: 'São Paulo', country: 'Brazil', }, { id: '6_2', parentId: '6', value: 8693387, name: 'Lima', country: 'Peru', }, { id: '6_3', parentId: '6', value: 7776845, name: 'Bogotá', country: 'Colombia', }, { id: '6_4', parentId: '6', value: 6429923, name: 'Rio de Janeiro', country: 'Brazil', }]; @Injectable() export class Service { getCitiesPopulations() { return citiesPopulations; } }
// 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/ 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, }, }, paths: { 'npm:': 'https://unpkg.com/', }, map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', '@angular/core': 'npm:@angular/core@12.2.17', '@angular/platform-browser': 'npm:@angular/platform-browser@12.2.17', '@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.17', '@angular/forms': 'npm:@angular/forms@12.2.17', '@angular/common': 'npm:@angular/common@12.2.17', '@angular/compiler': 'npm:@angular/compiler@12.2.17', 'tslib': 'npm:tslib@2.6.2/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', 'devextreme': 'npm:devextreme@23.2.5/cjs', 'devextreme/bundles/dx.all': 'npm:devextreme@23.2.5/bundles/dx.all.js', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.6.4/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.5', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.51', 'devextreme-angular': 'npm:devextreme-angular@23.2.5', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12', '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.4/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.4/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.12/inferno/package.json', 'npm:@angular/*/package.json', 'npm:@angular/common@12.2.17/*/package.json', 'npm:rxjs@7.5.3/package.json', 'npm:rxjs@7.5.3/operators/package.json', 'npm:devextreme-angular@23.2.5/*/package.json', 'npm:devextreme-angular@23.2.5/ui/*/package.json', 'npm:devextreme-angular@23.2.5/package.json', 'npm:devexpress-diagram@2.2.5/package.json', 'npm:devexpress-gantt@4.1.51/package.json', ], }; System.config(window.config);
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <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=1.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.5/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.12.0/dist/zone.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>