Layer List widget

The Layer List widget provides a list of operational layers and their symbols, and allows you to turn individual layers on and off. Each layer in the list has a check box that allows you to easily control its visibility. Layers having expansion arrows indicate that they contain sublayers or subtypes.

The order in which layers appear in this widget corresponds to the layer order in the map. This widget provides functionality allowing you to change the order of layers in the map.

Configuring the Layer List widget

This widget can be set to open automatically when an app starts. To enable this feature, click the Open this widget automatically when the app starts button on the widget, which turns it dark green.

1. Hover over the widget and click the Configure this widget button to open the configuration properties dialog box.
2. Optionally click Change widget icon if you want to replace the default icon for this widget.

   A file explorer window opens allowing you to browse to a local image file to use as the widget icon.

3. Check or uncheck the Show Legend check box.

   When this check box is checked, clicking the expansion arrow next to a layer displays its symbols.

4. Check or uncheck the following actions to be shown on the layer context menu:
   • Zoom To
   • Transparency
   • Enable / Disable Pop-up
   • Move up / Move down
   • Open Attribute Table
   • Description/Show Item Details/Download
5. Uncheck layers in the map that you don't want to show on the list.
6. Click OK to close this window.

Using the Layer List widget

1. Clicking the Layer List widget in your app displays the layer list or table of contents window.
2. If the Show Legend option is checked, clicking an individual layer shows its symbols.

   

3. Clicking the down arrow on the right side of a layer displays the layer menu, which includes the following functions:
   • Zoom To—Sets the map extent to the extent of the layer.
   • Transparency—Sets the transparency for the layer.
   • Enable Pop-up / Remove Pop-up—Enables or disables the pop-up for the feature layer. If a feature layer does not have a pop-up configured in the map, clicking Enable Pop-up shows all field values for the feature layer.
   • Move up—Moves the layer one level up.

     Note:

     This is for end users to re-order the layers in the app. The order of layers will not be persisted.

   • Move down—Moves the layer one level down.

     Note:

     This is for end users to re-order the layers in the app. The order of layers will not be persisted.

   • Open attribute table—Opens the attribute table for the feature layer.
   • Description / Show Item Details—Opens the service description or the item details page for the service or the item associated with the layer, if available.
4. The Control all layers button controls the behavior of all of the layers in the list. Click the icon to open the menu, which allows you turn on or off all the layers, or expand or collapse all the layers. Alternatively, you can use keyboard shortcuts to do so. Press Ctrl and click the check box of the layer to turn on or off the layers in the same level. Press Ctrl and click the arrow to expand or collapse layers in the same level.
5. Layers are grayed out in the list when zoomed out of their visible ranges.
6. Clicking the X button to close the Layer List window.