Plugin prototype.js d'optimisation des formulaires
Nom : bs_forms.js
Auteur : Bruno Sabot
Version : 1.0
Requits : prototype.js
bs_forms.js est un plugin pour prototype.js qui ajoute des fonctionnalités manquantes aux formulaires. Trois fonctions sont pour le moment disponible dans ce plugin, mais je vous laisse faire des suggestions dans l'espace de commentaires, en bas de la page. Vous pouvez aussi consulter un exemple plus complet à l'adresse suivante : Exemple du plugin bs_forms.js
Description :
FocusCreate permet de vider un formulaire lors de la prise du focus d'un élément. Il permet en outre de remettre la valeur initiale si l'utilisateur n'entre aucune valeur dans le formulaire.
Paramètres :
e : Le paramètre e est un objet au format JSON.
Listes des paramètres de l'objet e :
elements : Liste des id des éléments auxquels appliquer la fonction
onFocus : Fonction executée lors de la prise de focus de l'élément (facultatif)
onBlur : Fonction exectuée lors de la perte de focus de l'élément (facultatif)
Utilisation de la fonction :
// Affectuer la fonction à l'élement
Form.FocusCreate({
elements:['e1','e2'],
onFocus:function () { alert('Prise du focus !'); },
onBlur:function () { alert('Perte du focus...'); }
});
Description :
isBad s'execute lorsque vous jugez que l'élement entré par l'utilisateur n'est pas correct. Il met en forme la boite de dialogue choisie afin d'avertir l'utilisateur de son erreur.
Paramètres :
e : Le paramètre e est un objet au format JSON.
Listes des paramètres de l'objet e :
id : Id de l'élement auquel on doit appliquer la fonction
color : Couleur du fond de la boite de dialogue (défaut : #ff0000)
text : Texte de remplacement affiché (défaut : Cette valeur n'est pas correcte)
duration : Durée d'execution de la fonction d'avertissement (défault : 2000 ms)
Utilisation de la fonction :
// Affectuer la fonction à l'élement
Event.observe('e1','keypress',function {
if ($('e1').value='JavaScript') {
Form.isBad({
id:'e1',
color:'#A00000',
text:'JavaScript est interdit !',
duration:1000
});
}
});
Description :
isDefault permet de tester si l'élement analysé correspond à la valeur par défaut du champ et d'effectuer diverses opérations selon le cas.
Valeur de retour :
Liste des éléments dont la valeur est celle par défaut
Paramètres :
e : Le paramètre e est un objet au format JSON.
Listes des paramètres de l'objet e :
elements : Liste des élements à tester
onTrue : Fonction executée si la valeur est la valeur par défaut
onFalse : Fonction executée si la valeur n'est pas la valeur par défaut
onEnd : Fonction executée à la fin des tests. Possède deux paramètres : Est-ce que l'une des valeurs est celle par défaut et la liste des élements dont la valeur est celle par défaut.
Utilisation de la fonction :
// Affectuer la fonction à l'élement
Event.observe('e1','blur',function {
Form.isDefault({
elements:['e1'],
onTrue:function () { alert('Valeur par défaut détectée !') },
onFalse:function () { alert('La valeur à été changée.');
onEnd:function(resultat,liste) {
if (resultat) {
alert('Ils y a des champs par défaut.');
liste._each(function (el) {
alert(el);
}
}
}
});
});
