Fonctionnalités de la librairie jsFF

Documentation de la librairie jsFF : validation

La méthode jsFF.setValidation(form) permet de mettre en place un modèle de validation côté client du formulaire passé en paramètre.

Elle prend un seul argument obligatoire : l'identifiant du formulaire à valider, mais optionnellement une fonction de rappel qui sera invoquée en cas de réussite de la validation.
Si cette fonction de rappel, qui fournit en paramètre l'objet formulaire validé, retourne FALSE, le formulaire ne sera pas soumis, ce qui permet d'intercepter dans du javascript la demande de soumission.

Exemple d'appel de la demande de validation d'un formulaire 'form_test' avec sa fonction de rappel :

jsFF.setValidation('form_test', function (form) { 
		... code de traitement ...
		return false;
		});

Le mécanisme de validation est basé sur l'ajout de classes aux contrôles à faire valider, ces classes peuvent être multiples et parmi les suivantes :

classe fonction exemple
isValidEmpty Saisie optionnelle, cette classe peut être combinée avec d'autres validateurs pour autoriser les valeurs manquanttes.
isValidNotEmpty Saisie obligatoire
isValidRequired Saisie obligatoire (alias de isValidNotEmpty)
isValidBoolean Saisie d'un booléen (valeurs acceptées : 0, 1, true, false)
isValidDate Contrôle de validité du format de la date saisie.
isValidDatetime Contrôle de validité du format de la date et de l'heure saisies.
isValidTime Contrôle de validité du format de l'heure saisie.
isValidInteger Saisie d'un nombre entier
isValidCustom_xxxx Validateur personnalisé
dans ce cas, le validateur va appeler la fonction déduite à partir du caractère '_', soit xxxx pour procéder à la validation.
function c1(value)
{
	if  (parseInt(value) > 100)
		return true;
	else
		return false;
}
isValidCustom_xxxx Validateur personnalisé
par appel de la fonction c2 :
function c2(value)
{
	(value.trim() == 'custom') ? return true : return false;
}
isValidNumeric Validateur pour un nombre (réels y compris)
isValidNumeric isValidCustom_c3 Validateur nombre et fonction personalisée
function c3(value)
{
	if (value >= 5.0 && value <= 7.0)
				return true;
			else
				return false;
}
isValidAplhaNumeric Validateur alpha-numtérique
isValidRegexp Validité de la date saisie
isValidIPv4 Validité d'une adresse IP v4
isValidEmail Validité d'une adresse e-mail
isValidSelectRequired Validité d'une sélection (nécessite une option 'chaine vide' pour l'élément invalide)
isValidDate Validité de la date saisie poire
orange
pomme
isValidRadioRequired Au moins un radio bouton coché (Attention mettre les radios dans un div conteneur qui sera entouré en cas d'erreur.)
on off
isValidSameAs_XXXXXXX Vérifie que la valeur saisie soit identique à celle du champ nommé XXXX dans le nom de la classe.
Exemple : Pour une vérification de mot de passe, si vous avez 2 champs passwd et passwd2, ajouter la classe isValidSameAs_passwd sur le champ passwd2, impliquera que l'utilisateur devra saisir les mêmes informations dans passwd et passwd2 pour pouvoir valider le formulaire.