The Bookmark widget stores a collection of spatial bookmarks for a selected map. Specify 2D or 3D geographic locations with different extents, view angles (for 3D), layer visibility, and drawing marks. Each bookmark can display additional information such as a title, image, and description. You can also include the map’s existing bookmarks, when applicable. Optionally, you can allow end users to add bookmarks at run time so they can return to locations of interest.
Examples
Use this widget to support app design requirements such as the following:
- You want to draw attention to particular areas in a map.
- You want to present specific places in a map to support the narrative.
- You want end users to specify and return to a study area in a map.
Usage notes
This widget requires a connection to a Map widget with a configured data source. The Map widget can be in a different page than the bookmark. When you add a Bookmark widget, first choose a template design for the bookmark content, and click Next. Click Add bookmark to open a map view window with the content of the connected Map widget. You can keep the map view open while specifying locations and editing multiple bookmarks.
The Simple templates have fixed content for quicker configuration. The Advanced templates allow you to customize the bookmark content by changing and adding widgets for a unique design with more detailed information. For advanced templates, you must configure each widget in the bookmark layout to set up bookmark content.
Depending on the template you select, you can configure a variety of settings. The following table compares the differences between the available templates, which include Card, List, Gallery, three Slide templates, and two Advanced templates:
| Settings | Card template | List template | Gallery template | Slide templates | Advanced templates |
|---|---|---|---|---|---|
| Enable adding bookmark at run time |  | | | ||
| Display bookmarks from the map | | | | | |
| Configure paging style | | | |||
| Enable automatically navigating to the map's first bookmark | | | |||
| Enable auto-play | | | |||
| Customize content area | |
Settings
The Bookmark widget includes the following settings:
-
Select a template—Choose from predefined bookmark designs. To customize the content within the bookmarks, choose an advanced template so you can change or add nested widgets.
-
Select a Map widget—Select a Map widget that is connected to data. The widget automatically connects to the first map in the current page and displays any bookmarks from that map by default.
-
Add bookmark—Create one or more bookmarks. You can drag individual bookmarks to reorder them.
- Set bookmark view—This window appears when you add a bookmark. Zoom to or search for a location using the map. You can define the extent and layer visibility and add drawing marks. For 3D scenes, you can define the view angle. You can resize and move the window, if needed. To reopen this window, click the Change the bookmark view button for each bookmark.
- Bookmark title—Click the bookmark's name to enter a new name for the bookmark. This name also appears in the widget in some templates. Click the Delete button to remove a bookmark.
- Image source (all templates except list and advanced)—By default, when you save a bookmark, a snapshot of the map is created to illustrate the defined map extent. You can also click Custom to provide your own image for the bookmark. For Image Position, choose Fill or Fit to adjust the layout.
- Description (slide templates)—Provide a detailed description for the bookmark.
-
General settings—Configure the following general settings. Some settings only appear for certain templates.
- Bookmark drawing display—Choose whether to display all bookmark drawings in the connected Map widget or only display the drawing for the selected bookmark.
- Allow to add bookmark in widget—Control whether end users can add their own bookmarks.
- Display bookmarks from web map—Include bookmarks from the map. You can review the existing bookmarks when you check the box.
- Ignore layer visibility—Check this box to have the widget ignore layer visibility. The widget remembers which layers are visible at the time a bookmark is created. If you uncheck this box, clicking a bookmark may change the visibility of layers.
- Display bookmark name (grid, gallery, and slices templates)—Include each bookmark's name in the widget at run time.
- Hide icon (list template)—Remove the icons from each bookmark at run time.
-
Arrangement—Configure settings related to the widget's arrangement style. Different settings appear for different templates.
-
The following arrangement setting appears for the grid template:
- Item size—Honor the bookmark size settings from the connected web map, or enter a custom height and width.
-
The following arrangement settings appear for the gallery template:
- Direction—Display the bookmarks in a horizontal or vertical gallery.
- Horizontal spacing (px)—Define the amount of horizontal space between bookmarks. You can use the slider or enter a number of pixels.
- Item size—Honor bookmark size settings from the connected web map, or enter a custom width. For this template, the bookmark height is controlled by the height of the widget.
-
The following arrangement settings appear for the slide templates, including the advanced templates:
-
Paging style—Define how to display and interact with the bookmark slides in the widget. You have two choices.
-
Scroll—Display multiple bookmark slides, filling the widget container. More bookmark slides load as users scroll through them.
- Direction—Display and scroll the bookmarks horizontally or vertically.
- Item width or Item height—Specify the size of bookmark slides in pixels. For horizontal scrolling, define the slide’s width by typing a precise pixel number. The slide’s height is controlled by the widget’s height. For vertical scrolling, define the slide’s height by typing a precise pixel number. The slide’s width is controlled by the widget’s width.
- Horizontal spacing or Vertical spacing—Define the amount of space between bookmark slides in pixels, or use the slider.
-
Paging—Display one bookmark slide at a time.
- Active on loading—Automatically display the first bookmark in the connected map when the Bookmark widget appears in the page view. When turned off, end users must manually click the Bookmark widget for the connected map to navigate to the corresponding bookmark.
- Auto play—Automatically navigate between bookmarks after a predetermined interval time that you specify in seconds. You can also turn off looping so the widget doesn't continually navigate between bookmarks.
- Transition—Animate the bookmark slides as users navigate through them. Click the Preview button to see the selected transition in action.
-
-
-
-
Appearance—Change the background color of the widget panel. If the template supports bookmark names or descriptions, you can customize the font, style, color, and size.