Infobulles
Dernière mise à jour
Dernière mise à jour
Dans JMap, les infobulles servent à afficher de l’information sur les éléments pointés. Cette information comprend du texte, des valeurs d’attributs, des hyperliens, des images, etc. L’administrateur JMap détermine quelle information est affichée dans les bulles de chaque couche.
Le contenu des infobulles peut être formaté à l’aide de balises HTML et peut aussi contenir des programmes JavaScript.
L'onglet Infobulle de l'interface de configuration de la couche offre les outils pour configurer les infobulles.
Infobulle
Entrez le contenu de l’infobulle. Consultez les sections ci-dessous pour obtenir une explication de la syntaxe.
Couleur de fond
Sélectionnez la couleur de fond de l’infobulle.
Prévenir la duplication du texte
Sélectionnez cette option pour éviter qu’un même texte soit répété plusieurs fois dans une même bulle, ce qui peut se produire lorsque vous pointez vers beaucoup d’éléments de carte sur une même couche qui possèdent le même contenu d’infobulle (p. ex. segments de rue à une intersection).
Échelle minimale
Activez cette option et entrez l’échelle minimale à partir de laquelle l’infobulle doit s’afficher.
Échelle maximale
Activez cette option et entrez l’échelle maximale à partir de laquelle l’infobulle doit s’afficher.
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) sera remplacée à l’affichage par la valeur de l’attribut city de l’élément pointé.
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 :
Fonction
Description
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 ou de nombre souhaité
Remplacé par une date ou un nombre formaté selon un format précis.
Exemple
format(date_insp, dd/MM/yyyy)
Exemple
format(attrib, ##0,00)
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ère sendIx : 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 l’infobulle 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 et la distance en milles avec un chiffre décimal.
<a href=“download:file URL”>some text</a>
JMap supporte une syntaxe spéciale d’hyperlien qui permet à l’utilisateur de télécharger un fichier en cliquant sur le lien. Le fichier à télécharger peut provenir d’une URL de type http: ou file:.
Exemple
<a href="download:http://someserver/123/report.pdf">Télécharger</a>
Affiche une lien qui permet de télécharger le fichier report.pdf du web.
Exemple
<a href="download:file://D:/123/report.pdf">Télécharger</a>
Affiche une lien qui permet de télécharger le fichier report.pdf d’un dossier du système de fichiers Windows.
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.
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.
Contenu de l’infobulle
Affichage
City : ev(CITY)
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>
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" />
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>
Exemple de balise
<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.
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. Cette fonction est disponible dans JMap Pro seulement.
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.
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)¶m2=ev(ATTRIB_B)}
La figure illustre un exemple de contenu HTML dans une infobulle, référencé au moyen d’une URL.
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 .
où attrib 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 .
