plop
[cl7.git] / js / util.js
1 // coding: utf-8
2
3
4 /**
5 * Cet objet regroupe des fonctions utilitaires (helpers) permettant notamment de :
6 * - afficher une boite de message
7 * - afficher une bulle d'aide lié à un élément
8 * - manipuler le curseur et réaliser des sélections sur des zones de saisie (<input>)
9 */
10 cl7.Util = function () {
11 $("#info .fermer").click(function() {
12 $("#info").slideUp(50);
13 });
14
15 $("body").append('<div id="flecheBulle"></div>').append('<div id="messageBulle"><p></p></div>');
16
17 this.bulleActive = true;
18 };
19
20 cl7.Util.messageType = {informatif: 0, question: 1, erreur: 2};
21
22 /**
23 * Affiche une boite de dialogue avec un message à l'intérieur.
24 * @param message le message (string)
25 * @param type voir 'messageType'. par défaut messageType.informatif
26 * @param les boutons sous la forme d'un objet ou les clefs sont les labels des boutons
27 * et les valeurs les fonctions executées lorsqu'un bouton est activé.
28 * @param formate faut-il formaté le message ? true par défaut
29 */
30 cl7.Util.prototype.messageDialogue = function(message, type, boutons, formate) {
31 var thisUtil = this;
32
33 type = type || cl7.Util.messageType.informatif;
34 formate = formate || true;
35
36 if (this.timeoutMessageDialogue) {
37 clearTimeout(this.timeoutMessageDialogue);
38 }
39
40 var fermer = function() { $("#info").slideUp(100); };
41 fermer();
42
43 $("#info .message").html(message);
44
45 switch(type) {
46 case cl7.Util.messageType.informatif : $("#info #icone").attr("class", "information"); break;
47 case cl7.Util.messageType.question : $("#info #icone").attr("class", "interrogation"); break;
48 case cl7.Util.messageType.erreur : $("#info #icone").attr("class", "exclamation"); break;
49 }
50
51 $("#info .boutons").html("");
52 objectEach(boutons, function(nom, bouton) {
53 $("#info .boutons").append("<div>" + nom + "</div>").find("div:last").click(bouton).click(fermer);
54 });
55
56 $("#info").slideDown(200);
57 this.timeoutMessageDialogue = setTimeout(fermer, 3000);
58 };
59
60 cl7.Util.positionTypeX = {gauche: 0, gaucheRecouvrement: 1, centre: 2, droiteRecouvrement: 3, droite: 4};
61 cl7.Util.positionTypeY = {haut: 0, hautRecouvrement: 1, centre: 2, basRecouvrement: 3, bas: 4};
62
63 /**
64 * Afficher une boite flottante (élément) par rapport à une cible.
65 * La boite est affichée de manière à ne pas dépasser de la fenêtre.
66 * @boite l'élément à afficher
67 * @cible l'élément sur lequel est affiché la boite
68 * @positionX de type positionTypeX
69 * @positionY de type positionTypeY
70 */
71 cl7.Util.prototype.afficherBoite = function(boite, cible, positionX, positionY) {
72 var positionCible = cible.offset();
73 var positionBoite = {
74 left : positionX === cl7.Util.positionTypeX.gauche ? positionCible.left - boite.width() :
75 (positionX === cl7.Util.positionTypeX.gaucheRecouvrement ? positionCible.left - boite.width() + cible.width() :
76 (positionX === cl7.Util.positionTypeX.droitelsRecouvrement ? positionCible.left :
77 (positionX === cl7.Util.positionTypeX.droite ? positionCible.left + cible.width() :
78 positionCible.left + cible.width() / 2 - boite.width() / 2 ))), // centre
79 top : positionY === cl7.Util.positionTypeY.haut ? positionCible.top - boite.height() :
80 (positionY === cl7.Util.positionTypeY.hautRecouvrement ? positionCible.top - boite.height() + cible.height() :
81 (positionY === cl7.Util.positionTypeY.basRecouvrement ? positionCible.top :
82 (positionY === cl7.Util.positionTypeY.bas ? positionCible.top + cible.height() :
83 positionCible.top + cible.height() / 2 - boite.height() / 2 ))) // centre
84 };
85
86 // calcul les décalages en x et en y pour éviter que la boite ne sorte de la fenêtre, tient compte de la position des barres de défilement
87 var marge = 10;
88 positionBoite.left = positionBoite.left < marge + window.pageXOffset ? marge + window.pageXOffset :
89 (boite.width() - $(window).width() + (positionBoite.left - window.pageXOffset) + marge > 0 ? $(window).width() - boite.width() - marge + window.pageXOffset : positionBoite.left);
90 positionBoite.top = positionBoite.top < marge + window.pageYOffset ? marge + window.pageYOffset :
91 (boite.height() - $(window).height() + (positionBoite.top - window.pageYOffset) + marge > 0 ? $(window).height() - boite.height() - marge + window.pageYOffset : positionBoite.top);
92
93 boite.css("top", positionBoite.top).css("left", positionBoite.left).show();
94 };
95
96 cl7.Util.positionBulleType = {haut : 0, droite : 1, bas : 2, gauche : 3};
97
98 /**
99 * Affiche un info bulle lorsque le curseur survole l'élément donné.
100 * @param message le message à afficher
101 * @param element l'élément DOM sur lesquel afficher la bulle
102 * @param la position de la bulle, voir positionBulleType. Par défaut à 0 (haut)
103 */
104 cl7.Util.prototype.infoBulle = function(message, element, position) {
105 var thisUtil = this;
106 var cacherBulle = function() {
107 $("#flecheBulle").hide();
108 $("#messageBulle").hide();
109 };
110
111 position = position || cl7.Util.positionBulleType.haut;
112
113 element.hover(
114 function() {
115 if (!thisUtil.bulleActive) {
116 return;
117 }
118
119 var m = $("#messageBulle");
120 var f = $("#flecheBulle");
121 f.removeClass().addClass(position === cl7.Util.positionBulleType.haut ? "flecheBulleHaut" :
122 (position === cl7.Util.positionBulleType.droite ? "flecheBulleDroite" :
123 (position === cl7.Util.positionBulleType.bas ? "flecheBulleBas" : "flecheBulleGauche" )));
124
125 // remplie le paragraphe de la bulle avec le message
126 $("p", m).html(message);
127
128 // réinitialise la position, évite le cas ou la boite est collé à droite et remplie avec un texte la faisant dépassé
129 // dans ce cas la hauteur n'est pas calculé correctement
130 m.css("top", 0).css("left", 0);
131
132 var positionFleche = {
133 left : position === cl7.Util.positionBulleType.haut || position === cl7.Util.positionBulleType.bas ?
134 element.offset().left + element.outerWidth() / 2 - f.width() / 2 :
135 (position === cl7.Util.positionBulleType.gauche ? element.offset().left - f.width() : element.offset().left + element.outerWidth()),
136 top : position === cl7.Util.positionBulleType.gauche || position === cl7.Util.positionBulleType.droite ?
137 element.offset().top + element.outerHeight() / 2 - f.height() / 2 :
138 (position === cl7.Util.positionBulleType.haut ? element.offset().top - f.height() : element.offset().top + element.outerHeight())
139 };
140 var positionMessage = {
141 left : position === cl7.Util.positionBulleType.haut || position === cl7.Util.positionBulleType.bas ?
142 element.offset().left + element.width() / 2 - m.width() / 2 :
143 (position === cl7.Util.positionBulleType.gauche ? element.offset().left - f.width() - m.width() : element.offset().left + f.width() + element.outerWidth()),
144 top : position === cl7.Util.positionBulleType.gauche || position === cl7.Util.positionBulleType.droite ?
145 element.offset().top + element.outerHeight() / 2 - m.height() / 2 :
146 (position === cl7.Util.positionBulleType.haut ? element.offset().top - f.height() - m.height() : element.offset().top + f.height() + element.outerHeight())
147 };
148 var depassementDroit = (positionMessage.left + m.width()) - $("body").width();
149 if (depassementDroit > 0) {
150 positionMessage.left -= depassementDroit;
151 } else if (positionMessage.left < 0) {
152 positionMessage.left = 0;
153 }
154
155 m.css("top", positionMessage.top).css("left", positionMessage.left).show();
156 f.css("top", positionFleche.top).css("left", positionFleche.left).show();
157 },
158 cacherBulle
159 ).click(cacherBulle);
160 };
161
162 /**
163 * Rot13 d'une chaine, voir : http://fr.wikipedia.org/wiki/ROT13
164 */
165 cl7.Util.prototype.rot13 = function(chaine) {
166 var ACode = 'A'.charCodeAt(0);
167 var aCode = 'a'.charCodeAt(0);
168 var MCode = 'M'.charCodeAt(0);
169 var mCode = 'm'.charCodeAt(0);
170 var ZCode = 'Z'.charCodeAt(0);
171 var zCode = 'z'.charCodeAt(0);
172
173 var f = function(ch, pos) {
174 if (pos === ch.length) {
175 return "";
176 }
177
178 var c = ch.charCodeAt(pos);
179 return String.fromCharCode(
180 c +
181 (c >= ACode && c <= MCode || c >= aCode && c <= mCode ? 13 :
182 (c > MCode && c <= ZCode || c > mCode && c <= zCode ? -13 : 0))
183 ) + f(ch, pos + 1);
184 };
185 return f(chaine, 0);
186 };