MOD début de la Grande Restructuration JavaScript (pas fini)
[euphorik.git] / js / util.js
diff --git a/js/util.js b/js/util.js
new file mode 100644 (file)
index 0000000..62d127b
--- /dev/null
@@ -0,0 +1,266 @@
+
+/**
+  * Cette classe regroupe des fonctions utilitaires (helpers).
+  * @formateur est permet de formater les messages affichés à l'aide de messageDialogue (facultatif)
+  */
+euphorik.Util = function (formateur)
+{
+   $("#info .fermer").click(function(){
+      $("#info").slideUp(50) 
+   })
+   
+   $("body").append('<div id="flecheBulle"></div>').append('<div id="messageBulle"><p></p></div>')
+   
+   this.formateur = formateur
+   this.bulleActive = true
+}
+
+euphorik.Util.messageType = {informatif: 0, question: 1, erreur: 2}
+
+/**
+  * Affiche une boite de dialogue avec un message à l'intérieur.
+  * @param message le message (string)
+  * @param type voir 'messageType'. par défaut messageType.informatif
+  * @param les boutons sous la forme d'un objet ou les clefs sont les labels des boutons
+  *        et les valeurs les fonctions executées lorsqu'un bouton est activé.
+  * @param formate faut-il formaté le message ? true par défaut
+  */
+euphorik.Util.prototype.messageDialogue = function(message, type, boutons, formate)
+{
+   var thisUtil = this
+
+   type = type || euphorik.Util.messageType.informatif
+      
+   if (formate == undefined)
+      formate = true
+
+   if (this.timeoutMessageDialogue != undefined)
+      clearTimeout(this.timeoutMessageDialogue)
+      
+   var fermer = function(){$("#info").slideUp(100)}
+   fermer()   
+   
+   $("#info .message").html(thisUtil.formateur == undefined || !formate ? message : thisUtil.formateur.traitementComplet(message))
+   switch(type)
+   {
+      case euphorik.Util.messageType.informatif : $("#info #icone").attr("class", "information"); break
+      case euphorik.Util.messageType.question : $("#info #icone").attr("class", "interrogation"); break
+      case euphorik.Util.messageType.erreur : $("#info #icone").attr("class", "exclamation"); break
+   }   
+   $("#info .boutons").html("")
+   for (var b in boutons)
+      $("#info .boutons").append("<div>" + b + "</div>").find("div:last").click(boutons[b]).click(fermer)
+   
+   $("#info").slideDown(200)
+   this.timeoutMessageDialogue = setTimeout(fermer, euphorik.conf.tempsAffichageMessageDialogue)   
+}
+
+euphorik.Util.positionTypeX = {gauche: 0, gaucheRecouvrement: 1, centre: 2, droiteRecouvrement: 3, droite: 4}
+euphorik.Util.positionTypeY = {haut: 0, hautRecouvrement: 1, centre: 2, basRecouvrement: 3, bas: 4}
+
+/**
+  * Afficher une boite flottante (élément) par rapport à une cible.
+  * La boite est affichée de manière à ne pas dépasser de la fenêtre.
+  * @boite l'élément à afficher
+  * @cible l'élément sur lequel est affiché la boite
+  * @positionX de type positionTypeX
+  * @positionY de type positionTypeY
+  */
+euphorik.Util.prototype.afficherBoite = function(boite, cible, positionX, positionY)
+{
+    var positionCible = cible.offset()
+    var positionBoite = 
+      {
+         left : positionX == euphorik.Util.positionTypeX.gauche ? positionCible.left - boite.width() :
+            (positionX == euphorik.Util.positionTypeX.gaucheRecouvrement ? positionCible.left - boite.width() + cible.width() : 
+            (positionX == euphorik.Util.positionTypeX.droitelsRecouvrement ? positionCible.left :
+            (positionX == euphorik.Util.positionTypeX.droite ? positionCible.left + cible.width() :
+            positionCible.left + cible.width() / 2 - boite.width() / 2 ))), // centre
+         top : positionY == euphorik.Util.positionTypeY.haut ? positionCible.top - boite.height() :
+            (positionY == euphorik.Util.positionTypeY.hautRecouvrement ? positionCible.top - boite.height() + cible.height() : 
+            (positionY == euphorik.Util.positionTypeY.basRecouvrement ? positionCible.top :
+            (positionY == euphorik.Util.positionTypeY.bas ? positionCible.top + cible.height() :
+            positionCible.top + cible.height() / 2 - boite.height() / 2 ))) // centre
+      }
+      
+    // 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
+    var marge = 10    
+    positionBoite.left = positionBoite.left < marge + window.pageXOffset ? marge + window.pageXOffset :
+      (boite.width() - $(window).width() + (positionBoite.left - window.pageXOffset) + marge > 0 ? $(window).width() - boite.width() - marge + window.pageXOffset : positionBoite.left)
+    positionBoite.top = positionBoite.top < marge + window.pageYOffset ? marge + window.pageYOffset :
+      (boite.height() - $(window).height() + (positionBoite.top - window.pageYOffset) + marge > 0 ? $(window).height() - boite.height() - marge + window.pageYOffset : positionBoite.top)
+    
+    boite.css("top", positionBoite.top).css("left", positionBoite.left).show()
+}
+
+euphorik.Util.positionBulleType = {haut : 0, droite : 1, bas : 2, gauche : 3}
+
+/**
+  * Affiche un info bulle lorsque le curseur survole l'élément donné.
+  * @param message le message à afficher
+  * @param element l'élément DOM sur lesquel afficher la bulle
+  * @param la position de la bulle, voir positionBulleType. Par défaut à 0 (haut)
+  */
+euphorik.Util.prototype.infoBulle = function(message, element, position)
+{
+   var thisUtil = this
+   position = position || euphorik.Util.positionBulleType.haut
+
+   var cacherBulle = function()
+      {   
+         $("#flecheBulle").hide()
+         $("#messageBulle").hide()
+      }
+
+   element.hover(
+      function()
+      {
+         if (!thisUtil.bulleActive)
+            return
+                  
+         var m = $("#messageBulle")
+         var f = $("#flecheBulle")
+         f.removeClass().addClass(position == euphorik.Util.positionBulleType.haut ? "flecheBulleHaut" :
+            (position == euphorik.Util.positionBulleType.droite ? "flecheBulleDroite" : 
+            (position == euphorik.Util.positionBulleType.bas ? "flecheBulleBas" : "flecheBulleGauche" )))
+         
+         // remplie le paragraphe de la bulle avec le message
+         $("p", m).html(message)
+         
+         // réinitialise la position, évite le cas ou la boite est collé à droite et remplie avec un texte la faisant dépassé
+         // dans ce cas la hauteur n'est pas calculé correctement
+         m.css("top", 0).css("left", 0)
+         
+         var positionFleche = {
+            left : position == euphorik.Util.positionBulleType.haut || position == euphorik.Util.positionBulleType.bas ?
+                element.offset().left + element.outerWidth() / 2 - f.width() / 2 :
+                (position == euphorik.Util.positionBulleType.gauche ? element.offset().left - f.width() : element.offset().left + element.outerWidth()),
+            top : position == euphorik.Util.positionBulleType.gauche || position == euphorik.Util.positionBulleType.droite ?
+                element.offset().top + element.outerHeight() / 2 - f.height() / 2 :
+                (position == euphorik.Util.positionBulleType.haut ? element.offset().top - f.height() : element.offset().top + element.outerHeight())
+         }
+         var positionMessage = {
+            left : position == euphorik.Util.positionBulleType.haut || position == euphorik.Util.positionBulleType.bas ?
+                element.offset().left + element.width() / 2 - m.width() / 2 :
+                (position == euphorik.Util.positionBulleType.gauche ? element.offset().left - f.width() - m.width() : element.offset().left + f.width() + element.outerWidth()),
+            top : position == euphorik.Util.positionBulleType.gauche || position == euphorik.Util.positionBulleType.droite ?
+                element.offset().top + element.outerHeight() / 2 - m.height() / 2 :
+                (position == euphorik.Util.positionBulleType.haut ? element.offset().top - f.height() - m.height() : element.offset().top + f.height() + element.outerHeight())
+         }
+         var depassementDroit = (positionMessage.left + m.width()) - $("body").width()
+         if (depassementDroit > 0)
+            positionMessage.left -= depassementDroit
+         else
+         {
+            if (positionMessage.left < 0)
+               positionMessage.left = 0
+         }
+         
+         m.css("top", positionMessage.top).css("left", positionMessage.left).show()
+         f.css("top", positionFleche.top).css("left", positionFleche.left).show()
+      },
+      cacherBulle
+   ).click(cacherBulle)
+}
+
+/**
+  * Utilisé pour l'envoie de donnée avec la méthode ajax de jQuery.
+  */
+euphorik.Util.prototype.jsonVersAction = function(json)
+{
+   return {action : JSON.stringify(json) }
+}
+
+euphorik.Util.prototype.md5 = function(chaine)
+{
+   return hex_md5(chaine)
+}
+
+// pompé de http://www.faqts.com/knowledge_base/view.phtml/aid/13562/fid/130
+euphorik.Util.prototype.setSelectionRange = function(input, selectionStart, selectionEnd)
+{
+   if (input.setSelectionRange)
+   {
+      input.focus()
+      input.setSelectionRange(selectionStart, selectionEnd)
+   }
+   else if (input.createTextRange)
+   {
+      var range = input.createTextRange()
+      range.collapse(true)
+      range.moveEnd('character', selectionEnd)
+      range.moveStart('character', selectionStart)
+      range.select()
+   }
+}
+
+euphorik.Util.prototype.setCaretToEnd = function(input)
+{
+   this.setSelectionRange(input, input.value.length, input.value.length)
+}
+euphorik.Util.prototype.setCaretToBegin = function(input)
+{
+   this.setSelectionRange(input, 0, 0)
+}
+euphorik.Util.prototype.setCaretToPos = function(input, pos)
+{
+   this.setSelectionRange(input, pos, pos)
+}
+euphorik.Util.prototype.selectString = function(input, string)
+{
+   var match = new RegExp(string, "i").exec(input.value)
+   if (match)
+   {
+      this.setSelectionRange (input, match.index, match.index + match[0].length)
+   }
+}
+euphorik.Util.prototype.replaceSelection = function(input, replaceString) {
+   if (input.setSelectionRange)
+   {
+      var selectionStart = input.selectionStart
+      var selectionEnd = input.selectionEnd
+      input.value = input.value.substring(0, selectionStart) + replaceString + input.value.substring(selectionEnd)
+      
+      if (selectionStart != selectionEnd) // has there been a selection
+         this.setSelectionRange(input, selectionStart, selectionStart + replaceString.length)
+      else // set caret
+         this.setCaretToPos(input, selectionStart + replaceString.length)
+   }
+   else if (document.selection)
+   {
+      input.focus()
+      var range = document.selection.createRange()
+      if (range.parentElement() == input)
+      {
+         var isCollapsed = range.text == ''
+         range.text = replaceString
+         if (!isCollapsed)
+         {
+            range.moveStart('character', -replaceString.length);
+         }
+      }
+   }
+}
+
+euphorik.Util.prototype.rot13 = function(chaine)
+{
+   var ACode = 'A'.charCodeAt(0)
+   var aCode = 'a'.charCodeAt(0)
+   var MCode = 'M'.charCodeAt(0)
+   var mCode = 'm'.charCodeAt(0)
+   var ZCode = 'Z'.charCodeAt(0)
+   var zCode = 'z'.charCodeAt(0)
+
+   var f = function(ch, pos) {
+      if (pos == ch.length)
+         return ""
+      
+      var c = ch.charCodeAt(pos);
+      return String.fromCharCode(
+         c +
+         (c >= ACode && c <= MCode || c >= aCode && c <= mCode ? 13 :
+         (c > MCode && c <= ZCode || c > mCode && c <= zCode ? -13 : 0))
+      ) + f(ch, pos + 1)
+   }
+   return f(chaine, 0)
+}