Map tips provide the user with the ability to quickly retrieve information about entities underneath the mouse cursor.
They use data definitions to supply the data, meaning that the data available to the user can come from any provider, not just the attributes attached to the underlying spatial feature.
The map tip tool can query any entity and is not dependent upon the active entity. The user chooses from the map tip menu what data they're interested in and when they move the mouse around the map that's what the data they 'll will be presented withshown.
ID
weave.maptips
Properties
...
name
...
description
...
minScale
...
Name | Type | Required | Default | Description |
---|---|---|---|---|
minScale | number | no | 0 | The default minimum scale below which no map tips will be shown to the user. |
maxScale |
number | no | infinity | The default maximum scale above which no map tips will be shown to the user. |
radius |
number | no | 3 | The default radius, in map units, of the area to be searched |
, centred on the mouse location. | ||||
pressed | boolean | no | false | This sets the initial state of the map |
tips. Setting it to |
'true' will turn on map |
tips at startup. |
multipleMaximum | number | no | 1 | If the search returns more than this many results |
then |
multipleText | string | no | There are too many features at that location | The text to show to the user if more than |
. |
isDefault
Should be set to 'true' in the tip that should be enabled by default.
tip | tip | yes | A tip tag must be created for each set of data that's to be made available to the user for display in a map tip |
. |
data
The name of a Data configured that provides the data for this particular tip. Only available at the tip level.
datadefinition
The name of a Data Definition configured that provides the data for this particular tip. Only available at the tip level.
entity
The Entity that the data definition for the tip is associated with. Only available at the tip level.
label
The label to display for this particular tip. Only available at the tip level.
autoSize | boolean | no | false | true/false indicating if the popup window should try and adjust its size. |
minSize | size | no | 105,10 | The minimum width and height in pixels that the popup window should use when auto-sizing. |
maxSize | size | no | 1200,660 | The maximum width and height in pixels that the popup window should use when auto-sizing. |
size | size | no | 200,200 | The default width and height in pixels that the popup windows should use. |
hideDelay | number | no | 2000 | The number of milliseconds to wait before hiding the popup window |
. | ||||
selectedOnly | boolean | no | false | Restrict the map tip to the selected features only |
. | ||||
selectedOnlyMenu | boolean | no | false | Add a menu to the map tips tool to allow the user to turn on or off the selectedOnly flag |
. | ||||
visibleOnly | boolean | no | false | Restrict the map tip to display only if the associated layer is turned on in the ToC |
. Only available |
since 2.5.26 |
visibleOnlyMenu | boolean | no | false | Add a menu to the map tips tool to allow the user to turn on or off the visibleOnly flag |
. Only available since 2.5.26 | ||||
showGeometry | boolean | no | true | Should the geometry of the related entity be drawn. Only available |
since 2.5.26 |
Notes
- Only one of
data
ordatadefinition
should be set - If
datadefintion
is set thenentity
andlabel
should also be set - If
data
is set thenentity
does not need to be set (and will be ignored) - If
data
is set thenlabel
isn't required, but will override the label set for the given data if set
Examples
...
Sub-Tags
tip
Name | Type | Required | Description |
---|---|---|---|
minScale | number | no | The minimum scale below which no map tips will be shown to the user. |
maxScale | number | no | The maximum scale above which no map tips will be shown to the user. |
radius | number | no | The radius, in map units, of the area to be searched, centred on the mouse location. |
isDefault | boolean | no | Should be set to 'true' in the tip that should be enabled by default. |
data | yes, if | The id of a Data configuration that provides the data for this particular tip. | |
datadefinition | yes, if | The id of a Data Definition configuration that provides the data for this particular tip. | |
entity | yes, if | The id of the Entity that the Data Definition should generate the data for. | |
label | string | yes, if no, if | The label to display as this tip in the menu. Will override the label provided by the Data if |
autoSize | boolean | no | Indicating if the popup window should try and adjust its size |
minSize | size | no | The minimum width and height in pixels that the popup window should use when auto-sizing. |
maxSize | size | no | The maximum width and height in pixels that the popup window should use when auto-sizing. |
size | size | no | The default width and height in pixels that the popup windows should use |
selectedOnly | boolean | no | Restrict the map tip to the selected features only. |
visibleOnly | boolean | no | Restrict the map tip to display only if the associated layer is turned on in the ToC. |
group | string | no | A map tip with a group set will be placed under a sub-menu where the text of the sub-menu item will be taken from the group value, if a group isn't specified then the map tip will appear directly in the menu. Only available since 2.5.26 |
template | string | no | Used to apply HTML formatting to the tip for display in the popup. |
size
Name | Type | Required | Description |
---|---|---|---|
width | number | yes | The width of the "size", in pixels |
height | number | yes | The height of the "size' in pixels |
Notes
Only one of data or
datadefinition
should be set for a tip, but one of them must be set.The default values for tips are taken from the matching attribute in the parent tag.
Examples
Code Block | ||
---|---|---|
| ||
<item action="weave.maptips"> <tip> <data>property_details</data> <isDefault>true</isDefault> </tip> <tip> <data>road_details</data> </tip> </item> |
Code Block | ||||
---|---|---|---|---|
| ||||
<item action="weave.maptips"> <multipleMaximum>2</multipleMaximum> <multipleText>Too many features</multipleText> <minScale>1000</minScale> <maxScale>50000</maxScale> <radius>3</radius> <tip> <data>property_details</data> <isDefault>true</isDefault> </tip> <tip> <data>road_details</data> </tip> </item> |
Code Block | ||||
---|---|---|---|---|
| ||||
<item action="weave.maptips"> <pressed>true</pressed> <tip> <label>Property</label> <entity>property</entity> <datadefinition>property_details</datadefinition> <isDefault>true</isDefault> <minScale>1000</minScale> <maxScale>10000</maxScale> </tip> <tip> <label>Road<<datadefinition>road_details</label>datadefinition> <entity>roads</entity> <datadefinition>road_details<<label>Road</datadefinition>label> <radius>5</radius> <minScale>250</minScale> <maxScale>1000</maxScale> </tip> </item> | ||||
language | xml | title |
Adjusting the size of the popup
Code Block | ||
---|---|---|
| ||
<item action="weave.maptips"> <autoSize>true</autoSize> <minSize width="100" height="100"/> <maxSize width="200" height="400"/> <size width="150" height="150"/> <tips> <tip label="Property" entity="property" datadefinition="property_details" isDefault="true"/> <tip label="Image" entity="property" datadefinition="property_images"> <maxSize width="800" height="800"/> </tip> </tips> </item> |
Formatting the text in the popup
Code Block | ||
---|---|---|
| ||
<item action="weave.maptips">
<tip>
<data>property_details</data>
<template><![CDATA[<div><h1><i>ADDRESS DETAILS:</i></h1>{address_num} {street_name} {street_type}<br>{suburb}</div>]]></template>
</tip>
</item> |
Map tips with groups
Code Block | ||
---|---|---|
| ||
<item action="weave.maptips">
<tip>
<data>property_details</data>
<isDefault>true</isDefault>
<group>Property</group>
</tip>
<tip>
<data>property_summary</data>
<group>Property</group>
</tip>
<tip>
<data>property_owner</data>
<group>Property</group>
</tip>
<tip>
<data>road_details</data>
</tip>
<tip>
<data>serwer_details</data>
<group>Sewer</group>
</tip>
<tip>
<data>sewer_summary</data>
<group>Sewer</group>
</tip>
</item> |
The above example will result in a menu like the following
Property
Property Details
Property Summary
Property Owner
Road Details
Sewer
Sewer Details
Sewer Summary