API: propriétés et méthodes
Propriétés de validation
Ces propriétés sont présentes et utilisables sur tous les éléments de formulaire
|
Propriété |
Description |
Type |
|---|---|---|
|
validity |
Fournit un objet qui contient des informations sur l'état de validité du champ de formulaire. Cela inclut des propriétés telles que valid, valueMissing, typeMismatch, etc., qui indiquent si le champ est valide ou non. |
ValidityState |
|
validationMessage |
Contient un message d'erreur qui décrit pourquoi le champ n'est pas valide. Ce message est généralement affiché à l'utilisateur lorsque le champ échoue à la validation. |
string |
Méthodes de validation
Ces méthodes sont présentes et utilisables sur tous les éléments de formulaire
|
Méthode |
Description |
Type de retour |
|---|---|---|
|
checkValidity |
Cette méthode vérifie si le champ de formulaire respecte toutes les règles de validation définies par ses attributs. Elle retourne true si le champ est valide et false sinon. Cela permet de valider le champ sans soumettre le formulaire. |
boolean |
|
getForm |
Cette méthode retourne l'élément de formulaire auquel le champ appartient. Si le champ n'est pas associé à un formulaire, elle retourne null. Cela peut être utile pour accéder aux propriétés ou méthodes du formulaire parent. |
HTMLFormElement | null |
|
reportValidity |
Cette méthode vérifie la validité du champ et, si le champ n'est pas valide, affiche un message d'erreur à l'utilisateur. Elle retourne true si le champ est valide et false sinon. C'est une manière pratique de valider et d'informer l'utilisateur en une seule opération. |
boolean |
|
setCustomValidity |
Cette méthode permet de définir un message d'erreur personnalisé pour le champ. Si un message est défini, le champ sera considéré comme invalide, et le message sera affiché lors de la validation. Si vous souhaitez supprimer le message d'erreur, vous pouvez appeler cette méthode avec une chaîne vide. Cela offre une flexibilité pour personnaliser les messages d'erreur en fonction des besoins de l'application. |
void |