Hide Table of Contents
Analysis
Data Reviewer
Dynamic Layers
Editing
Feature Layers
Feature Table
Graphics
Map
Mobile
Online and Portal
Popups and Info Windows
Query and Select
Renderers, Symbols, Visualization
Search
Show loading icon
Explore in the sandbox
Open in CodePen
View live sample
Download as a zip file
Description
This sample demonstrates how you can use an animated image to show that the map is loading. In this sample, the image is a small animated GIF. The image appears when the map first loads and also when the user zooms or pans. The image goes away when all the layers have loaded.
This sample is driven by events. The map's onUpdateStart event fires when a layer begins updating its content, so we display the "loading" icon when this event fires. The map's onUpdateEnd event fires when the layers have finished updating content so we use this event to hide the icon.
The image path is referenced in the HTML body. You can use the namespace methods esri.show and esri.hide to toggle the visibility of the image.
Code
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="viewport" content="initial-scale=1, maximum-scale=1,user-scalable=no">
<title>Map loading image</title>
<link rel="stylesheet" href="https://js.arcgis.com/3.29/dijit/themes/claro/claro.css">
<link rel="stylesheet" href="https://js.arcgis.com/3.29/esri/css/esri.css">
<script src="https://js.arcgis.com/3.29/"></script>
<script>
var map, loading;
require(["esri/map",
"esri/layers/ArcGISDynamicMapServiceLayer",
"dojo/on",
"dojo/dom",
"dojo/ready",
"dojo/domReady!"
], function(Map, ArcGISDynamicMapServiceLayer, on, dom, ready){
function init() {
loading = dom.byId("loadingImg"); //loading image. id
map = new Map("map", {
basemap: "topo",
center: [117.773, 28.498],
zoom: 6
});
on(map, "update-start", showLoading);
on(map, "update-end", hideLoading);
//Takes a URL to a non cached map service.
var dynamicMapServiceLayer = new ArcGISDynamicMapServiceLayer("https://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Population_World/MapServer");
dynamicMapServiceLayer.setOpacity(0.4);
map.addLayer(dynamicMapServiceLayer);
}
function showLoading() {
esri.show(loading);
map.disableMapNavigation();
map.hideZoomSlider();
}
function hideLoading(error) {
esri.hide(loading);
map.enableMapNavigation();
map.showZoomSlider();
}
ready(init);
});
</script>
</head>
<body class="claro">
<div id="map" style="position:relative; width:1024px; height:512px; border:1px solid #000;">
<img id="loadingImg" src="images/loading.gif" style="position:absolute; right:512px; top:256px; z-index:100;" />
</div>
</body>
</html>