Learn how to use a View with map components and Calcite components, to create an application with a header, thumbnail and web map. The key aspect here is to show how to use map components, and then access the created map in your script code.
In this tutorial, you will load and display a pre-configured web map stored in ArcGIS Online, and use Calcite Components to lay out your application with a header and logo at top, and the map below. The title and logo to display in the header will come from the web map item. You will also learn to display a loading indicator until the map is ready.
Steps
Create a new pen
- Go to CodePen to create a new pen for your mapping application.
Add basic HTML
Define a basic HTML page.
- In CodePen > HTML, add HTML to create a basic page.
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no" />
<title>ArcGIS Maps SDK for JavaScript Tutorials: Using a View with map components and Calcite components.</title>
<style>
html,
body,
arcgis-map {
padding: 0;
margin: 0;
height: 100%;
width: 100%;
}
</style>
</head>
<body>
</body>
</html>Add references
- In the
<head>tag, add references to the ArcGIS core library and CSS, Calcite components and map components packages.
<link rel="stylesheet" href="https://js.arcgis.com/4.29/esri/themes/light/main.css">
<script src="https://js.arcgis.com/4.29/"></script>
<script type="module" src="https://js.arcgis.com/calcite-components/2.5.1/calcite.esm.js"></script>
<link rel="stylesheet" type="text/css" href="https://js.arcgis.com/calcite-components/2.5.1/calcite.css" />
<script type="module" src="https://js.arcgis.com/map-components/4.29/arcgis-map-components.esm.js"></script>
Create layout using Calcite
- Add the
<calcite-shell>component. - Add the
<calcite-navigation>component, placing it in the shell'sheaderslot. - Add the
<calcite-navigation-logo>component, placing it in thelogoslot of the<calcite-navigation>. - Add the
<calcite-loader>component below the<calcite-shell>component.
<calcite-shell>
<calcite-navigation slot="header">
<calcite-navigation-logo slot="logo" target="_blank"/>
</calcite-navigation>
</calcite-shell>
<calcite-loader></calcite-loader>
Add arcgis-map component
- Add the
<arcgis-map>component after the<calcite-navigation>component. - Add the
<arcgis-legend>component inside the<arcgis-map>component.
<calcite-shell>
<calcite-navigation slot="header">
<calcite-navigation-logo slot="logo" target="_blank"/>
</calcite-navigation>
<arcgis-map item-id="05e015c5f0314db9a487a9b46cb37eca">
<arcgis-legend position="bottom-right"/>
</arcgis-map>
</calcite-shell>
<calcite-loader></calcite-loader>
Add script logic
- Add a
<script>section in the<body>. - Add an eventListener to wait for when the "view" of the Map component is ready.
- Create variables for the view and the portal item used to create it.
- Set the heading, description and thumbnail of the
calcite-navigation-logo.
<script>
document.querySelector("arcgis-map").addEventListener("arcgisViewReadyChange", (event) => {
const { portalItem } = event.target.map;
const navigationLogo = document.querySelector("calcite-navigation-logo");
navigationLogo.heading = portalItem.title;
navigationLogo.description = portalItem.snippet;
navigationLogo.thumbnail = portalItem.thumbnailUrl;
navigationLogo.href = portalItem.itemPageUrl;
navigationLogo.label = "Thumbnail of map";
});
</script>
Hide loader
- Hide the loader once the view is ready
<script>
document.querySelector("arcgis-map").addEventListener("arcgisViewReadyChange", (event) => {
const { portalItem } = event.target.map;
const navigationLogo = document.querySelector("calcite-navigation-logo");
navigationLogo.heading = portalItem.title;
navigationLogo.description = portalItem.snippet;
navigationLogo.thumbnail = portalItem.thumbnailUrl;
navigationLogo.href = portalItem.itemPageUrl;
navigationLogo.label = "Thumbnail of map";
// turn off the loader once the view is ready
document.querySelector("calcite-loader").hidden = true;
});
</script>
Run the app
In CodePen, run your code to display the map.
The app should display a map showing predominant educational attainment in New York, with a thumbnail and title at the top.
What's next?
- Go to the component reference for more detailed information about components.