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 };