The Overview element provides control over an overview map, similar to the OpenLayers Overview control. This element though is easier to use when custom styling is needed.
You can define the size of your overview window and a position. Refer to a layerset that you defined before for the services to display in the overview map. The overview map can be fixed or zoom in/ out in the main map. You also can define whether the overview map is minimized or maximized on start of the application.
The Overview element must be placed in the Configuration underneath the Map element.
The configuration dialog:
- Maximize: true/false to open/close on start, default is true.
- Fix: true/false to fix the overview extent, default is true.
- Title: Title of the element. The title will be listed in “Layouts” and allows to distinguish between different buttons. It will be indicated if “Show label” is activated.
- Tooltip: text to use as tooltip.
- Layerset: refer to a layerset f.e. overview, define the layerset first and refer to it.
- Target: Id of Map element to query.
- Anchor: overview alignment, default is ‘right-top’.
- Width/ Height: overview width and height.
There are different settings for the overview element:
In the configuration example we implement the element (Title) “Overview”. With Layerset we can select all previously implemented layersets. In this example we have two to choose from:
For the overview we choose the layerset overview. As Target we choose the element referenced. Anchor defines where the overview will be implemented (left-top, left-bottom, right-top or right-bottom). In this instance we choose right-bottom. Width and Height define the size of the window displaying the overview. Default settings are 200 and 100. Additionally it is possible to check the boxes Maximize and Fix. For the configuration example both checkmarks are set. Because of this the application will be maximized when opened. Additionally the map view is fixed. The excerpt shown in the overview window won’t change if the map is dragged and shows the maximum extend defined in Map Element <map.html>.
If the overview isn’t fixed (unchecked Fix), the overview will change if the map is zoomed or dragged. The default view is the defined start extend. For the following parameter (no check of Fix, Anchor, left-bottom, Width 400 and Height 200):
The overview will look like this:
tooltip: 'Overview' # text to use as tooltip target: ~ # Id of Map element to query layerset: ~ # refer to a layerset f.e. overview, define the layerset first and refer to it width: 200 # overview width height: 100 # overview height anchor: 'right-top' # overview alignment, default is 'right-top' # use inline f.e. in sidebar # Options: 'inline', 'left-top', 'right-top', 'left-bottom', 'right-bottom' position: ['0px', '0px'] # overview position in relation to anchor, default: x=0px, y=0px maximized: true # true/false to open/close on start, default is true fixed: true # true/false to fix the overview extent, default is true
Class, Widget & Style¶
- Class: Mapbender\CoreBundle\Element\Overview
- Widget: mapbender.element.overview.js
- Style: mapbender.element.overview.css