DevExtreme v26.1 is now available.

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

Your search did not match any results.

Angular Vector Map - Legend

The VectorMap component allows you to use color and size indicators to better illustrate the values associated with areas/markers. Use map legends to provide additional information on colors and marker size.

Backend API
<dx-vector-map id="vector-map" [bounds]="[-180, 85, 180, -75]"> <dxo-vector-map-tooltip [enabled]="true" [customizeTooltip]="customizeTooltip" ></dxo-vector-map-tooltip> <dxi-vector-map-layer [dataSource]="worldMap" name="areas" palette="Violet" [colorGroups]="[0, 0.5, 0.8, 1, 2, 3, 100]" colorGroupingField="population" [customize]="customizeLayers" > <dxo-vector-map-label [enabled]="true" dataField="name" ></dxo-vector-map-label> </dxi-vector-map-layer> <dxi-vector-map-layer [dataSource]="markers" name="markers" elementType="bubble" dataField="value" [sizeGroups]="[0, 8000, 10000, 50000]" opacity="0.8" > <dxo-vector-map-label [enabled]="false"></dxo-vector-map-label> </dxi-vector-map-layer> <dxi-vector-map-legend title="World Population<br/>Percentages" horizontalAlignment="left" verticalAlignment="bottom" [customizeItems]="customizeItems" [customizeText]="customizeText" > <dxo-vector-map-source layer="areas" grouping="color" ></dxo-vector-map-source> </dxi-vector-map-legend> <dxi-vector-map-legend title="City Population" markerShape="circle" horizontalAlignment="right" verticalAlignment="bottom" [customizeItems]="customizeItems" [customizeText]="customizeMarkers" > <dxo-vector-map-source layer="markers" grouping="size" ></dxo-vector-map-source> </dxi-vector-map-legend> </dx-vector-map>
import { bootstrapApplication } from '@angular/platform-browser'; import { Component, enableProdMode, provideZoneChangeDetection } from '@angular/core'; import { DxVectorMapModule } from 'devextreme-angular'; import * as mapsData from 'devextreme-dist/js/vectormap-data/world.js'; import { FeatureCollection, Service } from './app.service'; if (!/localhost/.test(document.location.host)) { enableProdMode(); } @Component({ selector: 'demo-app', providers: [Service], templateUrl: './app.component.html', styleUrls: ['./app.component.css'], imports: [ DxVectorMapModule, ], }) export class AppComponent { worldMap = mapsData.world; markers: FeatureCollection; populations: Object; constructor(service: Service) { this.markers = service.getMarkers(); this.populations = service.getPopulations(); this.customizeLayers = this.customizeLayers.bind(this); } customizeText({ index, start, end }) { if (index === 0) { return '< 0.5%'; } return (index === 5) ? '> 3%' : `${start}% to ${end}%`; } customizeTooltip = (arg: { attribute: Function }) => ({ text: arg.attribute('text'), }); customizeItems = (items: unknown[]) => items.reverse(); customizeLayers(elements: { attribute: Function }[]) { elements.forEach((element) => { const name = element.attribute('name'); const population = this.populations[name]; if (population) { element.attribute('population', population); } }); } customizeMarkers = ({ index }) => ['< 8000K', '8000K to 10000K', '> 10000K'][index]; } bootstrapApplication(AppComponent, { providers: [ provideZoneChangeDetection({ eventCoalescing: true, runCoalescing: true }), ], });
::ng-deep #vector-map { height: 700px; }
import { Injectable } from '@angular/core'; export class FeatureCollection { type: string; features: Feature[]; } export class Feature { type: string; properties: FeatureProperty; geometry: FeatureGeometry; } export class FeatureProperty { value: number; text: string; } export class FeatureGeometry { type: string; coordinates: number[]; } const populations = { China: 19, India: 17.4, 'United States': 4.44, Indonesia: 3.45, Brazil: 2.83, Nigeria: 2.42, Bangladesh: 2.18, Russia: 2.04, Japan: 1.77, Mexico: 1.67, Philippines: 1.39, Vietnam: 1.25, Ethiopia: 1.23, Egypt: 1.21, Germany: 1.13, Turkey: 1.07, 'Democratic Republic of the Congo': 0.94, France: 0.92, Thailand: 0.9, 'United Kingdom': 0.89, Italy: 0.85, Burma: 0.84, 'South Africa': 0.74, 'South Korea': 0.7, Colombia: 0.66, Spain: 0.65, Tanzania: 0.63, Kenya: 0.62, Ukraine: 0.6, Argentina: 0.59, Algeria: 0.54, Poland: 0.54, Sudan: 0.52, Canada: 0.49, Uganda: 0.49, Morocco: 0.46, Uzbekistan: 0.43, }; const markers: FeatureCollection = { type: 'FeatureCollection', features: [ { coordinates: [-74, 40.7], text: 'New York City', value: 8406, }, { coordinates: [100.47, 13.75], text: 'Bangkok', value: 8281, }, { coordinates: [37.62, 55.75], text: 'Moscow', value: 12111, }, { coordinates: [121.5, 31.2], text: 'Shanghai', value: 24150, }, { coordinates: [-43.18, -22.9], text: 'Rio de Janeiro', value: 6429, }, { coordinates: [31.23, 30.05], text: 'Cairo', value: 8922, }, { coordinates: [28.95, 41], text: 'Istanbul', value: 14160, }, { coordinates: [127, 37.55], text: 'Seoul', value: 10388, }, { coordinates: [139.68, 35.68], text: 'Tokyo', value: 9071, }, { coordinates: [103.83, 1.28], text: 'Singapore', value: 5399, }, { coordinates: [30.3, 59.95], text: 'Saint Petersburg', value: 5131, }, { coordinates: [28.03, -26.2], text: 'Johannesburg', value: 4434, }, { coordinates: [144.95, -37.8], text: 'Melbourne', value: 4252, }, ].map((data) => ({ type: 'Feature', geometry: { type: 'Point', coordinates: data.coordinates, }, properties: { value: data.value, text: data.text, }, })), }; @Injectable() export class Service { getPopulations() { return populations; } getMarkers(): FeatureCollection { return markers; } }
<!DOCTYPE html> <html 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/26.1.5/css/dx.light.css" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> </head> <body class="dx-viewport"> <div class="demo-container"> <demo-app>Loading...</demo-app> </div> <script src="https://cdn.jsdelivr.net/npm/zone.js@0.16.2/bundles/zone.umd.js"></script> <script src="./bundle.js" type="module"></script> </body> </html>