Afficher des tooltips (infobulles) sur des objets [part 3]#
Date de publication initiale : 15 décembre 2008
Introduction#
La librairie OpenLayers fournit un mécanisme intéressant permettant de facilement créer de nouvelles classes en fonction de ses besoins. Une fonctionnalité qui à mon sens faisait défaut, à cette merveilleuse librairie, était la possibilité d'afficher des tooltips au passage de la souris sur des objets. Google maps propose déjà ce genre de fonctionnalité directement dans son API : Exemple.
Je me suis donc lancé, il y a quelques mois, dans la création de ma propre classe. Celle-ci à depuis considérablement évoluée. Les changements majeurs de cette nouvelle version sont une refont complète du code qui hérite dorénavant de la classe OpenLayers.Control, une meilleure intégration des fonctions natives d'OpenLayers, ainsi qu'un placement automatique du tooltips en fonction de la position du curseur.
Mise en application#
Pour ajouter le script il vous suffit simplement, après l'avoir téléchargé (ou la version compressée*), de le déclarer dans le Header de votre page. Cela se fait de la manière suivante :
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<title>OpenLayers exemples</title>
<script src="./js/OpenLayers/OpenLayers.js" type="text/javascript"></script>
<script src="./js/OpenLayers/lib/OpenLayers/Control/toolTips.js" type="text/javascript"></script>
</head>
Pour utiliser les tooltips, il faut ensuite ajouter un objet de type controle (Etape 1), puis définir une action de type mouseover (Etape 2) pour les objets sur lesquels vous souhaitez voir les tooltips s'afficher . Enfin pour chacune des actions définir les méthodes show() et hide() de la classe (Etape 3) :
ttips = new OpenLayers.Control.ToolTips({shadow:true});
map.addControl(ttips); // Etape 1
markers.events.register("mouseover", markers, toolTipsOver);
markers.events.register("mouseout", markers, toolTipsOut); // Etape 2
function toolTipsOver(e) {
ttips.show({html:"My first ToolTips <br /><br /><br /><br />"});
}
function toolTipsOut(e){
ttips.hide();
} // Etape 3
Propriétés et méthodes#
Vous pouvez à loisir customiser l'apparence du tooltips, ses propriétés sont :
- textColor (string) Ex : "black"
- bold (boolean) : false
- opacity (float between 0 to 1) Ex : 1
- bgColor (string) Ex : "#FFFFFF"
- html (string) : "some content"
- shadow (boolean) : true
Exemple#
Ci-dessous un exemple de ce qu'il est possible de réaliser :
Info
Le serveur hébergeant la démonstration n'étant plus disponible depuis de nombreuses années, la démonstration, autre fois intégrée en iFrame est désactivée.
<iframe src="http://geotribu.net/applications/tutoriaux/openlayers/tooltips_v3/toolTips_v3.html" scrolling="no" width="100%" height="600px"></iframe>
- La version compressée a été obtenue grâce au formidable outil Packer
Auteur·ice#
Arnaud Vandecasteele#
Bien qu'issu à l'origine d'un parcours universitaire (doctorat et post-doc), j'ai finalement tenté l'aventure entrepreunariale au travers de Geolab.
Mes principaux centres d'intêrets dans le domaine de la géomatique portent sur les logiciels Open Source et plus particulièrement QGIS.
J'aime également le développement informatique avec une forte préférence à tout ce qui se passe côté serveur (base de données, traitements, etc.). Côté techno, mes choix se portent habituellement sur du (Geo)Django et PostgreSQL/PostGIS.
Pendant mon temps libre, vous me trouverez un GPS à la main afin de contribuer à OpenStreetMap ou sur un tatami en train de pratiquer le Jiu-Jitsu Brésilien.
Si vous êtes intéressé par l'un ou tous ces sujets, n'hésitez pas à me contacter !
Commentaires
Une version minimale de la syntaxe markdown est acceptée pour la mise en forme des commentaires.
Propulsé par Isso.
Ce contenu est sous licence Creative Commons BY-NC-SA 4.0 International