X-Git-Url: http://git.euphorik.ch/?p=euphorik.git;a=blobdiff_plain;f=js%2Futil.js;h=7ba8e6036992158cf4b3e5becceebc3f62744a95;hp=62d127beb0cb0da21780f86312a6caa2c3aa2b7e;hb=0cca28444881b1a405525b10960915a638936fdd;hpb=55b0291a691e56465277811aac749e930509fea2 diff --git a/js/util.js b/js/util.js index 62d127b..7ba8e60 100644 --- a/js/util.js +++ b/js/util.js @@ -1,266 +1,289 @@ - -/** - * 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('
').append('

') - - 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 +// coding: utf-8 +// Copyright 2008 Grégory Burri +// +// This file is part of Euphorik. +// +// Euphorik is free software: you can redistribute it and/or modify +// it under the terms of the GNU General Public License as published by +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// Euphorik is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU General Public License for more details. +// +// You should have received a copy of the GNU General Public License +// along with Euphorik. If not, see . + +/*jslint laxbreak:true */ + +/** + * Cet objet regroupe des fonctions utilitaires (helpers) permettant notamment de : + * - afficher une boite de message + * - afficher une bulle d'aide lié à un élément + * - manipuler le curseur et réaliser des sélections sur des zones de saisie () + * @formateur permet de formater les messages affichés à l'aide de messageDialogue (facultatif), voir "formateur.js". + */ +euphorik.Util = function (formateur) { + $("#info .fermer").click(function() { + $("#info").slideUp(50); + }); + + $("body").append('
').append('

'); + + 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é. + * Lorsqu'un bouton est activé le message se ferme. * @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("
" + b + "
").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) -} + * @param temps le temps d'affichage du message en seconde, -1 pour une durée infinie + */ +euphorik.Util.prototype.messageDialogue = function(message, type, boutons, formate, temps) { + var thisUtil = this; + + type = type || euphorik.Util.messageType.informatif; + formate = formate === undefined ? true : formate; + + if (this.timeoutMessageDialogue) { + clearTimeout(this.timeoutMessageDialogue); + } + + var fermer = function() { $("#info").slideUp(100); }; + fermer(); + + $("#info .message").html(!thisUtil.formateur || !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(""); + objectEach(boutons, function(nom, bouton) { + $("#info .boutons").append("
" + nom + "
").find("div:last").click(bouton).click(fermer); + }); + + $("#info").slideDown(200); + if (temps !== -1) { + this.timeoutMessageDialogue = setTimeout(fermer, temps || 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}; /** - * Utilisé pour l'envoie de donnée avec la méthode ajax de jQuery. + * Affiche ou cache la barre d'attente. */ -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) -} +euphorik.Util.prototype.showWaitBar = function() { + $("#waitbar").show(); +}; +euphorik.Util.prototype.hideWaitBar = function() { + $("#waitbar").hide(); +}; + +/** + * 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; + var cacherBulle = function() { + $("#flecheBulle").hide(); + $("#messageBulle").hide(); + }; + + position = position || euphorik.Util.positionBulleType.haut; + + 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ées avec la méthode ajax de jQuery. + * Obsolète : à virer + */ +/*euphorik.Util.prototype.jsonVersAction = function(json) { + return { action : JSON.stringify(json) }; +};*/ + +/** + * Retourne un hash md5 d'une chaine, dépend de md5.js. + * @param chaine un string quelconque + * @return un string hashé + */ +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); + } + } + } +}; + +/** + * Rot13 d'une chaine, voir : http://fr.wikipedia.org/wiki/ROT13 + */ +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); +};