Help us shape the 2021 DevExtreme Roadmap.
Take our 5 minute survey.
Dynamic Viewport
Documentation
This demo illustrates how to change the map’s viewport from code. Choose a continent using the drop-down menu under the map. In response to that, the map changes the visible area so that the chosen continent is displayed optimally. This is performed in code by calling the viewport(viewportCoordinates) method. After that, callback functions assigned to the centerChanged and zoomFactorChanged options are triggered. These functions place the current values of the map’s center and zoom factor in the text boxes under the map.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<dx-vector-map
id="vector-map" #vectorMap
[bounds]="[-180, 85, 180, -60]"
(onZoomFactorChanged)="zoomChanged($event)"
(onCenterChanged)="centerChanged($event)">
<dxi-layer [dataSource]="worldMap"></dxi-layer>
</dx-vector-map>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<span>Continent</span>
<dx-select-box
[dataSource]="viewportData"
[width]="210"
displayExpr="continent"
valueExpr="coordinates"
[value]="viewportData[0].coordinates"
(onValueChanged)="onValueChanged($event)"></dx-select-box>
</div>
<div class="option">
<span>Zoom factor</span>
<dx-text-box [value]="zoomFactorValue" [readOnly]="true" [width]="210">
</dx-text-box>
</div>
<div class="option">
<span>Center</span>
<dx-text-box [value]="centerValue" [readOnly]="true" [width]="210"></dx-text-box>
</div>
</div>
import { NgModule, Component, enableProdMode, ViewChild } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxVectorMapModule, DxSelectBoxModule, DxTextBoxModule } from 'devextreme-angular';
import * as mapsData from 'devextreme/dist/js/vectormap-data/world.js';
import { ViewportCoordinate, Service } from './app.service';
if(!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
selector: 'demo-app',
providers: [ Service ],
templateUrl: 'app/app.component.html',
styleUrls: ['app/app.component.css'],
preserveWhitespaces: true
})
export class AppComponent {
worldMap: any = mapsData.world;
zoomFactorValue: string;
centerValue: string;
viewportData: ViewportCoordinate[];
@ViewChild("vectorMap", { static: false }) map: DxVectorMapComponent
constructor(service: Service) {
this.centerValue = "0.000, 46.036";
this.zoomFactorValue = "1.00";
this.viewportData = service.getCoordinates();
}
onValueChanged(e){
this.map.instance.viewport(e.value);
}
zoomChanged(e) {
this.zoomFactorValue = e.zoomFactor.toFixed(2);
}
centerChanged(e) {
this.centerValue = e.center[0].toFixed(3) +
", " + e.center[1].toFixed(3);
}
}
@NgModule({
imports: [
BrowserModule,
DxVectorMapModule,
DxSelectBoxModule,
DxTextBoxModule
],
declarations: [AppComponent],
bootstrap: [AppComponent]
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep #vector-map {
height: 420px;
}
::ng-deep .options {
padding: 20px;
background-color: rgba(191, 191, 191, 0.15);
margin-top: 20px;
}
::ng-deep .caption {
font-size: 18px;
font-weight: 500;
}
::ng-deep .option {
margin-top: 10px;
}
::ng-deep .option > span {
width: 140px;
display: inline-block;
}
::ng-deep .option > .dx-widget {
display: inline-block;
vertical-align: middle;
}
import { Injectable } from '@angular/core';
export class ViewportCoordinate {
continent: string;
coordinates: number[];
}
let viewportCoordinates: ViewportCoordinate[] = [{
continent: "all",
coordinates: "null"
}, {
continent: "NorthAmerica",
coordinates: [-180, 84.52, -22.11, -1.57]
}, {
continent: "SouthAmerica",
coordinates: [-112.47, 14.26, -27.52, -57.44]
}, {
continent: "Africa",
coordinates: [-29.34, 39.09, 55.60, -39.00]
}, {
continent: "Europe",
coordinates: [-2.35, 70.91, 61.35, 35.84]
}, {
continent: "Asia",
coordinates: [27.62, 83.11, 180, -19.36]
}, {
continent: "Australia",
coordinates: [104.87, -6.61, 149.98, -45.87]
}]
@Injectable()
export class Service {
getCoordinates(): ViewportCoordinate[] {
return viewportCoordinates;
}
}
// 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/
System.config({
transpiler: 'ts',
typescriptOptions: {
module: "system",
emitDecoratorMetadata: true,
experimentalDecorators: true
},
meta: {
'typescript': {
"exports": "ts"
},
'devextreme/dist/js/vectormap-data/*': {
'esModule': true
},
'devextreme/localization.js': {
"esModule": true
}
},
paths: {
'npm:': 'https://unpkg.com/'
},
map: {
'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@3.5.3/lib/typescript.js',
'@angular': 'npm:@angular',
'tslib': 'npm:tslib@2.0.3/tslib.js',
'rxjs': 'npm:rxjs@6.3.3',
'devextreme/dist/js/vectormap-data': 'js/vectormap-data',
'rrule': 'npm:rrule@2.6.6/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.25.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@20.2.4',
'jszip': 'npm:jszip@3.5.0/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@0.9.7/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.0.5',
'devexpress-gantt': 'npm:devexpress-gantt@2.0.8',
'devextreme-angular': 'npm:devextreme-angular@20.2.4',
'preact': 'npm:preact@10.5.7/dist/preact.js',
'preact/hooks': 'npm:preact@10.5.7/hooks/dist/hooks.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'
}
},
packageConfigPaths: [
"npm:@angular/*/package.json",
"npm:@angular/common/*/package.json",
"npm:rxjs/package.json",
"npm:rxjs/operators/package.json",
"npm:devextreme-angular/*/package.json",
"npm:devextreme-angular/ui/*/package.json",
"npm:devextreme-angular/package.json",
"npm:devexpress-diagram/package.json",
"npm:devexpress-gantt/package.json",
]
});
<!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/20.2.4/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.4/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.4.1/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.10.2/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.3/Reflect.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script src="https://unpkg.com/jquery@3.5.1/dist/jquery.min.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>