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

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.