BasemapGallery widget

Explore in the sandboxView live

This sample demonstrates how to display a BasemapGallery widget to allow users to switch between different basemaps.

By default, the BasemapGallery will display a list of basemaps from arcgis.com. If you have a portalUrl defined, then the BasemapGallery will display a list of basemaps defined in your Portal.

To update the list of basemaps displayed, set the source property of the BasemapGallery. This can either point to a different portal source, or a local list of basemaps. See Basemaps with different projections for an example defining a PortalBasemapsSource.

To create a custom list of basemaps from local sources, source should be set to an array of basemaps representing LocalBasemapsSource, as shown in the following code snippet.

Use dark colors for code blocks
         
1
2
3
4
5
6
7
8
9
const customBasemap = new Basemap({
  portalItem: {
    id: "46a87c20f09e4fc48fa3c38081e0cae6"
  }
})
const basemapGallery = new BasemapGallery({
   view: view,
   source: [Basemap.fromId("topo-vector"), Basemap.fromId("hybrid"), customBasemap] // autocasts to LocalBasemapsSource
});

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.