Infobulles

Cette section permet de définir les paramètres d'affichage des infobulles de la couche tels que le contenu à afficher, la couleur de la bulle, etc.

L'interface de configuration des infobulles se présente comme suit :

1	La liste des attributs vous permet de sélectionner des attributs et de les ajouter au contenu de la bulle en appuyant sur le bouton marqué d'une flèche vers le bas.
2	La liste des fonctions vous permet de sélectionner des fonctions de formatage du contenu (gras, italique, etc.) et de les ajouter au contenu de la bulle en appuyant sur le bouton marqué d'une flèche vers le bas.
3	Saisissez le contenu de la bulle. Ce contenu peut être composé de texte statique, ainsi que de fonctions affichant des valeurs d'attributs, des images, etc. Les infobulles supportent aussi la programmation en JavaScript pour effectuer des opérations mathématiques et des opérations sur les chaînes de caractères en utilisant les valeurs des attributs. Pour plus d'information sur la définition du contenu des infobulles, consultez la section Création du contenu des infobulles.
4	Sélectionnez la couleur de fond de la bulle pour cette couche.
5	Ces options modifient le comportement de la bulle Infobulle visible : Permet d'activer ou de désactiver les infobulles pour la couche. Prévenir duplication du texte : Permet d'empêcher des contenus identiques de s'afficher à répétition dans une même bulle.
6	Les seuils de visibilité permettent de définir des échelles entre lesquelles les infobulles s'affichent dans la carte. Si vous ne sélectionnez cette option, l'infobulle s'affiche à toutes les échelles.

Création du contenu des infobulles

Vous devez fournir le texte qui sera utilisé comme contenu de l'infobulle. Ce texte peut être composé de parties statiques (affichées telles quelles), de parties variables (fonctions remplacées par d'autres valeurs lors de l'affichage), de programmes JavaScript simples et de balises HTML. Par exemple, la fonction elementValue(city) ou dans sa forme réduite ev(city), sera remplacée à l'affichage par la valeur de l'attribut city de l'élément pointé.

Le texte de l'infobulle peut s'étendre sur plusieurs lignes. Vous n'avez qu'à entrer du texte sur plus d'une ligne et l'infobulle emploiera le même formatage.

Syntaxe des infobulles

La syntaxe des infobulles est composée de diverses fonctions qui vont déterminer le contenu des bulles. Les fonctions ainsi que leurs paramètres ne sont généralement pas sensibles à la casse. Par exemple, ev(city) est équivalent à Ev(CITY).

Le tableau suivant explique les différentes fonctions disponibles :

elementValue(attrib) ou ev(attrib) attrib : le nom d'un attribut	Remplacé par la valeur de l'attribut lié dont le nom est passé en paramètre, pour l'élément pointé. Par exemple, ev(id) sera remplacé par la valeur de l'attribut id de l'élément.
elementId()	Remplacé par l'identifiant de l'élément.
polygonArea()	Remplacé par l'aire d'un élément pointé de type polygonal.
lineLength()	Remplacé par la longueur d'un élément pointé de type linéaire.
centroid()	Remplacé par la coordonnée du centroïde géométrique de la géométrie de l'élément.
format(attrib, format) attrib : le nom d'un attribut de type date ou numérique format : le format de date souhaité	Remplacé par une date ou un nombre formaté selon un format précis. Exemple format(date_insp, dd/MM/yyyy) où date_insp est le nom d'un attribut contenant une date et dd/MM/yyyy est le format de date souhaité, tel qu'indiqué dans la documentation de la classe Java java.text.SimpleDateFormat. Exemple format(value, ##0,00) où value est le nom d'un attribut contenant un nombre et ##0,00 est le format de nombre souhaité, tel qu'indiqué dans la documentation de la classe Java java.text.NumberFormat.
ifNull(attrib, value) attrib : le nom de l'attribut à tester value : la valeur à afficher si attrib est nulle	Remplacé par la valeur value seulement si la valeur de l'attribut attrib est nulle. Si la valeur de l'attribut est non nulle, rien n'est affiché. Exemple ifNull(temp, N/A) Affiche N/A si la valeur de l'attribut temp est nulle. Exemple ifNull(attrib_a, attrib_b) Affiche la valeur de l'attribut attrib_b si la valeur de attrib_a est nulle.
ifNotNull(attrib, value) attrib : le nom de l'attribut à tester value : la valeur à afficher si attrib est non nulle	Remplacé par la valeur value seulement si la valeur de l'attribut attrib est non nulle. Si la valeur de l'attribut est nulle, rien n'est affiché. Exemple ifNotNull(land_value, $) Affiche $ seulement si la valeur de land_value est non nulle.
subString(attrib, startIx, endIx) attrib : le nom de l'attribut pour lequel on veut extraire une partie startIx : position de départ dans la chaîne de caractères endIx : position de fin dans la chaîne de caractères	Remplacé par une partie de la valeur (comme chaîne de caractères) de l'attribut attrib, entre la position startIx et la position endIx. Exemple subString(name, 0, 5) Remplacé par les 5 premiers caractères de la valeur de l'attribut name. Si cette dernière est Montréal, alors la bulle affichera Montr.
encode(attrib, encoding) attrib : le nom de l'attribut à encoder encoding : le nom de l'encodage	Remplacé par la valeur de l'attribut attrib, une fois encodée avec l'encodage de caractères spécifié (UTF-8, CP437, ISO 8859-1, etc). Exemple encode(name, UTF-8) Remplacé par la valeur de l'attribut name encodée en caractères UTF-8.
<script> code JavaScript </script>	Exécute le code JavaScript qui est à l'intérieur des balises. Dans le code JavaScript, les valeurs des attributs des éléments sont accessibles par la fonction elementValue() ou ev(). Des opérations mathématiques ou sur les chaînes de caractères peuvent être effectuées sur les valeurs des attributs. Pour afficher du contenu dans la bulle, le script doit faire appel à la fonction print(). Exemple <script> print ( ev(population) / ev(area) ); </script> Calcule et affiche le résultat la valeur de l'attribut population divisé par la valeur de l'attribut area. Exemple <script> var KM_IN_MI = 0.621371; var dist_mi = ev(km) * KM_IN_MI; print('ev(osm_name)'); print(dist_mi.toFixed(1) + " mi"); </script> Convertit la distance en kilomètres contenue dans la valeur de l'attribut km en une distance en milles. Affiche la valeur de l'attribut osm_name (notez les ' ' car c'est une chaîne de caractères) et la distance en milles avec un chiffre décimal.
photosAsThumbnails()	Remplacé par des versions réduites des images attachées à l'élément. L'utilisateur peut cliquer sur une image réduite pour ouvrir l'image pleine grandeur. photosAsThumbnails(title) photosAsThumbnails(date) photosAsThumbnails(title,date) Avec ces options, le titre et/ou la date seront affichées avec chaque miniature de photo. Il est très important de ne pas ajouter des espaces entre title, la virgule et date.
projectName()	Remplacé par le nom du projet en cours.
userName()	Remplacé par le code utilisateur de l'utilisateur actuellement connecté.
sessionId()	Remplacé par l'identifiant de la session en cours.
host()	Remplacé par le nom de l'hôte ou l'adresse de l'instance JMap Server à laquelle l'application est connectée.
port()	Remplacé par le numéro du port (http ou direct) de l'instance JMap Server à laquelle l'application est connectée.
date()	Remplacé par la date et l'heure actuelles.

Balises HTML

Il est possible de formater le contenu de la bulle à l'aide de balises HTML simples. Les bulles ne supportent pas les balises avancées telles que <DIV> ni les CSS. Les balises HTML supportées et couramment utilisées dans les infobulles sont les suivantes :

<B>, <I>, <U>, <A>, <IMG>, <TABLE>, <BR>

Vous pouvez insérer des hyperliens dans les bulles. Ceux-ci sont cliquables et permettent d'ouvrir des pages HTML ou d'ouvrir ou télécharger des fichiers.

Exemples

City : ev(CITY) Un exemple simple de texte statique avec la valeur d'un attribut.
City: ev(CITY) (ev(COUNTRY)) Exemple contenant des parties statiques et l'affichage de 2 valeurs d'attributs, sur 2 lignes.
<b>ev(STATION_NAME)</b> <a href="ev(URL)">Site web</a> Un exemple de formatage de base employant des balises HTML de même qu'un hyperlien où l'URL provient de la valeur de l'attribut URL.
<b>ev(DESCRIPTION)</b> <img src="ev(IMAGE_URL)" height="175" width="234" /> Un exemple de balise d'image HTML qui prend l'URL de l'image de la valeur de l'attribut IMAGE_URL.
Area ev(AREA_KM2) km2 <script> var SQ_KM_IN_SQ_MI = 2.58998811; var area_sq_mi = ev(AREA_KM2) / SQ_KM_IN_SQ_MI; print(area_sq_mi.toFixed(1) + " sq. mi"); </script> Un exemple de balise <script> avec du code JavaScript. La valeur de l'attribut AREA_KM2 est convertie de km carrés à milles carrés.
<table style="border:3px solid black; border-radius:5px; background: #1fc8db; color:white"> <thead> <tr> <th style="padding: 5px" class="">Name</th> <th style="padding: 5px" class="actions">FirstName</th> </tr> </thead> <tbody> <tr> <td style="padding: 5px" class="">Gratton</td> <td style="padding: 5px" class="actions">Bob</td> </tr> </tbody> </table> Exemple de formatage avec attribut de style.

Repérage d'éléments de carte ou de coordonnées en utilisant les infobulles

Les infobulles comportent une fonction pour localiser des coordonnées ou des éléments d'une carte en utilisant une syntaxe spéciale d'URL. Un hyperlien est affiché dans la bulle, et lorsqu'il est cliqué, la carte repère la région ou les éléments spécifiés.

Exemple de repérage avec infobulle	Description
<a href="locate:region;-73;45;5;5">Localiser</a>	Affiche un hyperlien Localiser. Lorsque cliqué, cet hyperlien repère dans la même carte la région définie par x=‑73, y = 45, largeur = 5, hauteur = 5. Ces données sont exprimées dans les unités de la carte.
<a href="locate:object;métros;nom;'atwater'">Localiser</a>	Affiche un hyperlien Localiser. Lorsque cliqué, cet hyperlien repère dans la même carte les éléments sur la couche métros dont l'attribut nom est égal à atwater.
<a href="locate:object;métros;nom;'a%'">Localiser</a>	Affiche un hyperlien Localiser. Lorsque cliqué, cet hyperlien repère dans la même carte les éléments sur la couche métros dont l'attribut nom commence par la lettre a.
<a href="locate:object;métros;nom;'atwater';1000">Localiser</a>	Affiche un hyperlien Localiser. Lorsque cliqué, cet hyperlien repère dans la même carte les éléments sur la couche métros dont l'attribut nom est égal à atwater. La carte qui en résulte possède une échelle de 1 : 1000.
<a href="locate:object;métros;nom;'atwater':target=Résultat">Localiser</a>	Affiche un hyperlien Localiser. Lorsque cliqué, cet hyperlien repère dans une nouvelle carte appelée Résultat les éléments de la couche métros dont la valeur de l'attribut name est égal à atwater. Si une carte nommée Résultat existe déjà, elle est réutilisée. Si le nom de la carte était new, une nouvelle carte (avec un nom généré automatiquement) serait créée à chaque fois.

Utilisation d'une URL pour l'affichage de contenu

Vous pouvez spécifier une URL qui affichera le contenu d'une page HTML dans l'infobulle (seulement supportée dans les applications JMap Pro). La bulle sera occupée à 100% par la page HTML. La syntaxe est la suivante :

$URL{http://awebsite.com}

L'URL spécifiée peut être statique ou peut provenir d'un attribut. Elle peut aussi utiliser les valeurs d'attribut en tant que paramètres, comme dans l'exemple ci‑dessous :

$URL{http://awebsite.com?param1=ev(ATTRIB_A)&param2=ev(ATTRIB_B)}