The basemap gallery widget allows you to change basemaps in the JavaScript Viewer. The widget only supports tiled map services.

Learn more about supported basemap types

The following properties allow you to customize the basemap gallery widget for use with your offline maps:

• isEnabled—This property allows you to turn the basemap gallery on or off.
• showArcGISBasemaps—Set this property to false since ArcGIS Online basemaps are not accessible in a disconnected environment.
• defaultBasemap—Update this property with the name of your custom basemap.
• nextBasemap—Update this property with the name of your secondary custom basemap.
• customBasemaps—Update this property with to point to your local basemap services. Remove streets, hybrid, and topographic basemaps that are references to ArcGIS Online services. The following is an example:

  customBasemaps : [
    {
      id: “localbasemap",
      title: "localbasemap",
      layers: [{
        url: "https://[hostname].[domain]/arcgis/rest/services/[localbasemap]/MapServer"
      }],
      thumbnailUrl: "js/widget/gis/BasemapGallery/images/localbasemap.jpg"
    }
  ]

The following properties allow you to configure a non-tiled map service to be used as the application’s basemap. This configuration is used when the basemap gallery option is unavailable.

• type—Update this property with the type of non-tiled map service used by your custom basemap. Supported types include mapimage and imagery.
• url—Update this property with the REST URL of your map service.
• options.id—Update this property with the ID of your map service.
• options.opacity—Specifies the opacity of the map service.

[your customized locator services]