Script forms.js
Le script forms.js permet de formater, de contrôler et de
récupérer le contenu des formulaires HTML.
Plusieurs fonctions permettent d'effectuer du traitement de chaînes
et de formater un nom ou une adresse e-mail. D'autres fonctions permettent
de vérifier qu'un champ est rempli ou qu'une adresse e-mail est
valide. Une fonction permet de valider un formulaire puis de
l'expédier.
Enfin, trois fonctions offrent la possibilité de
récupérer les paramètres de l'URL de la page.
Lorsqu'un formulaire est expédié
avec la méthode GET, Les paramètres se situent à la fin de l'URL
(forme protocole://machine:port/chemin/fichier?clé=valeur&clé=valeur&...).
On appelle paramètre un couple clé=valeur, où
la clé est le nom d'un champ du formulaire préalablement
soumis, et la valeur le contenu de ce champ.
- Depuis :
- JsLib 1.0
Résumé des fonctions |
|
envoyerFormulaire(objet formulaire)
Vérifie que le formulaire spécifié est rempli puis l'expédie. |
|
formaterChampEmail(objet champ)
Formate le contenu d'un champ de formulaire de type "Email". |
|
formaterChampNom(objet champ)
Formate le contenu d'un champ de formulaire de type "Nom". |
chaîne |
formaterParametres()
Formate et retourne les paramètres contenus dans l'URL de la page. |
entier |
nombreParametres()
Retourne le nombre de paramètres contenus dans l'URL de la page. |
chaîne |
valeurParametre(chaîne cle)
Retourne la valeur du paramètre correspondant à la clé indiquée. |
booléen |
verifierEmail(chaîne email)
Vérifie que l'adresse e-mail spécifiée est valide. |
booléen |
verifierPresence(chaîne chaine)
Vérifie que la chaîne spécifiée n'est pas vide. |
envoyerFormulaire
envoyerFormulaire(objet formulaire)
-
Vérifie que le formulaire spécifié est rempli puis l'expédie.
Le formulaire doit être défini dans la page Web courante.
Aucun des champs du formulaire ne doit être vide : dans le cas inverse, un message d'erreur
s'affiche et le formulaire n'est pas expédié.
- Paramètres :
- formulaire - une référence sur le formulaire à expédier.
formaterChampEmail
formaterChampEmail(objet champ)
-
Formate le contenu d'un champ de formulaire de type "Email". Les espaces avant et après sont
supprimés, les lettres majuscules deviennent des lettres minuscules, les caractères superflus
sont supprimés. Attention : cette fonction ne vérifie pas la validité de l'adresse e-mail.
- Paramètres :
- champ - une référence sur le champ de formulaire qui contient l'adresse e-mail à formater.
formaterChampNom
formaterChampNom(objet champ)
-
Formate le contenu d'un champ de formulaire de type "Nom". Les espaces avant et après sont
supprimés, la première lettre de chaque partie du nom est mise en majuscule, les autres lettres
sont mises en minuscules.
- Paramètres :
- champ - une référence sur le formulaire qui contient le nom à formater.
formaterParametres
chaîne formaterParametres()
-
Formate et retourne les paramètres contenus dans l'URL de la page. On appelle paramètre un couple
clé=valeur, où la clé est le nom d'un champ du formulaire préalablement soumis,
et la valeur le contenu de ce champ. Cette fonction retourne les paramètres sous la forme
d'un tableau HTML, chaque ligne du tableau étant de la forme "clé : valeur".
- Retourne :
- une chaîne de code HTML contenant les paramètres de l'URL de la page.
nombreParametres
entier nombreParametres()
-
Retourne le nombre de paramètres contenus dans l'URL de la page. On appelle paramètre un couple
clé=valeur, où la clé est le nom d'un champ du formulaire préalablement soumis,
et la valeur le contenu de ce champ.
- Retourne :
- un entier positif ou nul correspondant au nombre de paramètres dans l'URL de la page.
valeurParametre
chaîne valeurParametre(chaîne cle)
-
Retourne la valeur du paramètre correspondant à la clé indiquée. On appelle paramètre un couple
clé=valeur, où la clé est le nom d'un champ du formulaire préalablement soumis,
et la valeur le contenu de ce champ.
- Paramètres :
- cle - la clé du paramètre dont on veut connaître la valeur.
- Retourne :
- une chaîne de caractères contenant la valeur associée à la clé.
verifierEmail
booléen verifierEmail(chaîne email)
-
Vérifie que l'adresse e-mail spécifiée est valide.
Une adresse e-mail valide est une chaîne de caractères
de la forme nom@domaine.extension,
où le nom et le domaine sont de la forme partie1[.partie2[...]] et où le domaine et
l'extension se composent d'au moins deux caractères.
- Paramètres :
- email - la chaîne contenant l'adresse e-mail à vérifier.
- Retourne :
- true si l'adresse e-mail est valide, false sinon.
verifierPresence
booléen verifierPresence(chaîne chaine)
-
Vérifie que la chaîne spécifiée n'est pas vide. Une chaîne vide est une chaîne de longueur nulle
ou composée uniquement d'espaces.
- Paramètres :
- chaine - la chaîne à vérifier.
- Retourne :
- true si la chaîne n'est pas vide, false sinon.
Erreurs, critiques, améliorations, questions :
écrivez à l'auteur.
JsLib version 1.4 - bibliothèque JavaScript distribuée sous licence GNU LGPL
Auteur : Etienne CHEVILLARD
Mise à jour : 12/12/2007