Use Leaflet's Control.Layers control to switch between different base layers and to toggle overlays on or off.
<html>
<head>
<meta charset="utf-8" />
<title>Switch between basemap layers (Control.Layers)</title>
<meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no" />
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.9.4/dist/leaflet.css" crossorigin="" />
<script src="https://unpkg.com/leaflet@1.9.4/dist/leaflet.js" crossorigin=""></script>
<!-- Load Esri Leaflet from CDN -->
<script src="https://unpkg.com/esri-leaflet@3.0.10/dist/esri-leaflet.js"></script>
<!-- Load Esri Leaflet Vector from CDN -->
<script src="https://unpkg.com/esri-leaflet-vector@4.2.3/dist/esri-leaflet-vector.js" crossorigin=""></script>
<style>
html,
body,
#map {
padding: 0;
margin: 0;
height: 100%;
width: 100%;
font-family: Arial, Helvetica, sans-serif;
font-size: 14px;
color: #323232;
}
</style>
</head>
<body>
<div id="map"></div>
<script>
const apiKey = "YOUR_API_KEY";
const gray = L.esri.Vector.vectorBasemapLayer("arcgis/light-gray", {
apikey: apiKey
});
const states = L.esri.featureLayer({
url: "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3",
style: function (feature) {
return { color: "#bada55", weight: 2 };
}
});
const map = L.map("map", {
center: [39, -97.5],
zoom: 4,
layers: [gray, states]
});
const baseLayers = {
Grayscale: gray,
Newspaper: L.esri.Vector.vectorBasemapLayer("arcgis/newspaper", {
apikey: apiKey
})
};
const overlays = {
"U.S. States": states
};
// https://leafletjs.com/reference.html#control-layers
L.control.layers(baseLayers, overlays).addTo(map);
</script>
</body>
</html>