Infobulles
Dernière mise à jour
Dernière mise à jour
K2 Geospatial 2022
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.
Pour de configurer les infobulles d’une couche, appuyez sur Infobulles depuis la section des détails de la couche.
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, |
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
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
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 java.text.DecimalFormat. |
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
Affiche N/A si la valeur de l’attribut temp est nulle. Exemple
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
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
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
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 Exemple
Calcule et affiche le résultat la valeur de l’attribut population divisé par la valeur de l’attribut area. Exemple
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
Affiche une lien qui permet de télécharger le fichier report.pdf du web. Exemple
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.
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 |
| |
| |
| |
| |
| |
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 |
| 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. |
| 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. |
| 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. |
| 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. |
| 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.
