You can configure context-sensitive menus throughout the viewer interface. Context menus allow users to perform common tasks that relate to the selected viewer element. For example, right-clicking or long-pressing on the map activates the map context menu. The map context menu displays tasks that a user might want to perform at a location on the map, like plotting a coordinate.
Context menus can appear in a number of circumstances. For example, users can access context menus when they:
Right-click or long-press (on a touchscreen) on the map or map objects
Open the Panel Actions menu
Open a specific feature or results action menu
Click or tap an Actions icon
Open a map tip
Map context menu in the desktop interface (left) and handheld interface (right)
The following context menus are configurable. The Context column describes how users open the context menu.
Menu |
Context |
---|---|
Additional Actions |
Click the Additional Actions menu |
Coordinate Actions |
Click the More button |
Coordinates List Actions |
Open the Panel Actions menu |
Feature Actions |
Open the Panel Actions menu Open the Feature Actions menu |
Global Menu |
Open the I Want To Menu. The Global Menu appears as four icons across the top of the open menu. The default menu items included are for Sign In or Sign Out, Open Project, Save Project, and Save Project As. The Global Menu is designed to hold a maximum of four items. Users are discouraged from configuring the menu in a manner that allows for more than four items to be visible at the same time. |
Layer Actions |
Open the Actions menu |
Layer List Actions |
Open the Panel Actions menu |
Legend Actions |
Open the Panel Actions menu To show the Legend panel, open the Layers panel, open the Panel Actions menu |
Map Context Menu |
Right-click or long-press any point on the map. The Map Context Menu has additional features that you can enable or disable. For more information see Additional Settings for the Map Context Menu. |
Map Service Actions |
Open the Actions menu |
Map Tip Actions |
Appear as a list of links on the active map tip. |
Project Actions |
Open the Actions menu |
Projects List Actions |
Open the Panel Actions menu |
Results Actions |
Open the Results Actions menu |
Results List Actions |
Open the Panel Actions menu |
Results Table Actions |
Open the Panel Actions menu |
Selection Actions |
When the Results List is the active panel or the Results Table is activated, open the Panel Actions menu See Selection Module for more information about selections. |
For further information about the configuration of context menus, see the description of the commandParameter
in the IWantToMenu Module, Map Module, Menu Module, and Selection Module.
To open an HTML5 viewer's Context Menus page in Manager:
In beside the viewer.
In Manager's side panel, click Context Menus.
To customize a particular context menu, open the Context Menus page and click the link for the type of context menu you want to customize. This opens the page for that type of context menu. Once you have opened the page:
To add a new menu item, click Add Menu Item and configure the menu item's settings.
To edit an existing menu item, click the Edit icon next to the item and configure the menu item's settings.
To remove a menu item, click the Remove icon next to the item.
To re-order the menu, click and drag the Sort icon for each menu item that you want to move.
Some menu items do not always appear in a context menu. For example, if a layer is not editable, then a feature's Panel Actions menu would not show the Edit Feature menu item. Similarly, some menu items appear only if the user has is signed in using an identity with the appropriate permissions.
The Command and Command Parameter settings are not available when a menu item uses multiple commands via the batch
property. In this case, those settings are hidden. You must edit batch commands directly in the Desktop.json.js
, Tablet.json.js
, and Handheld.json.js
configuration files.
Context menu items have the following settings:
Text: The menu item's text.
Description: Optional. A short description of what the menu item does.
Command: The name of the command to run when the user selects the menu item. Available commands are suggested if you have the command text box selected.
Command Parameter: The parameter value to pass to the command when it runs. Parameters may either be simple strings or complex objects containing any number of parameters. The Command Parameter setting is grayed out for commands that cannot take a parameter.
Icon URI: Optional. The URI of the image to display next to the menu item. The image should be the size that you want it in the viewer. Valid file formats are PNG, BMP, JPG, and JPEG. Click Browse to choose an icon that exists in your site's virtual directory.
Hide When Disabled: Select this checkbox to hide menu items if they are disabled. For example, if a user does not have permission to edit a feature, the Edit Feature action would be hidden from the user.
The Map Context Menu has additional settings that the other context menus do not have:
Enable Context Menu: To display the Map Context Menu when the user right-clicks or long-presses a point on the map, select this checkbox. This checkbox is selected by default.
Show Coordinates: To display the coordinates of the point right-clicked or long-pressed, select this checkbox. This checkbox is selected by default.
Show Reverse Geocoder: To display the address of the point right-clicked or long-pressed, select this checkbox. This checkbox is selected by default.
For this option to work, your site must have at least one Geocoder configured with the Default Reverse Geocoder setting selected. For more information, see Geocoding Services.
Show Menu: To display the menu items of the Map Context Menu, select this checkbox. This checkbox is selected by default.
Title: If your viewer is going to be available in one language only, type the menu title. This title appears in the Bottom Panel of the Handheld interface.
If your viewer is going to be available in more than one language, enter the text key that the menu title is assigned to. See Configure User Interface Text for more information on using text keys.
Title for the Map Context Menu