From faa96e657621455284245018b8a3b5050b613e6b Mon Sep 17 00:00:00 2001
From: julieng Ce n'est pas tout d'envoyer des données — il faut aussi s'assurer que les données mises dans un formulaire par un utilisateur sont dans un format correct pour pouvoir être traitées correctement et qu'elles ne vont pas casser nos applications. Nous voulons également aider les utilisateurs à compléter les formulaires correctement et à ne pas ressentir de frustration en essayant d'utiliser les applications. La validation des données de formulaire vous aide à remplir ces objectifs — cet article indique ce qu'il est nécessaire de savoir. Allez sur n'importe quel site à la mode avec un formulaire d'inscription et vous remarquerez des retours si vous n'entrez pas les données dans le format attendu. Vous aurez des messages comme : C'est ce qu'on appelle la validation de formulaire — lorsque vous saisissez des données, l'application Web vérifie si elles sont correctes. Si elles sont correctes, l'application permet que les données soient soumises au serveur et (généralement) sauvegardées dans une base de données ; si ce n'est pas le cas, elle émet des messages d'erreur pour expliquer ce que vous avez fait de mal (pour autant que vous l'ayez fait). La validation des formulaires peut être mise en œuvre de différentes manières. La vérité est qu'aucun d'entre nous n'aime remplir des formulaires — les formulaires ennuient les utilisateurs, tout le prouve : cela les incite à partir et à aller voir ailleurs s'ils sont mal faits. Bref, les formulaires, c'est nullissime. Remplir des formulaires web doit être aussi facile que possible. Alors pourquoi être tatillons et bloquer les utilisateurs à chaque fois ? Il y a trois raisons principales : Vous rencontrerez différents types de validation de formulaires sur le Web : Dans le monde réel, les développeurs ont tendance à utiliser une combinaison de validations côté client et côté serveur, pour être du côté sûr. Une des caractéristiques de HTML5 est la possibilité de valider la plupart des données utilisateur sans avoir recours à des scripts. Ceci se fait en utilisant des attributs de validation sur les éléments de formulaire ; ils vous permettent de spécifier des règles pour une entrée de formulaire comme : une valeur doit‑elle être remplie ? y a-t-il une longueur minimale et/ou maximale des données ? doit‑elle être un nombre, une adresse e-mail ou autre chose ? doit‑elle correspondre à un modèle ? Si les données saisies suivent toutes ces règles, elles sont considérées comme valides ; si ce n'est pas le cas, elles sont considérées comme non valides. Quand un élément est invalide : Dans cette section, nous examinerons quelques unes des diverses fonctionnalités HTML5 peuvant être utilisées pour valider des éléments d'{{HTMLElement("input")}}. Commençons par un exemple simple — une entrée ouvrant un choix, selon votre préférence, entre banane ou cerise. Il faut un texte {{HTMLElement("input")}} simple avec une étiquette correspondante et un {{htmlelement("button")}} de soumission. Le code source est sur GitHub à l'adresse fruit-start.html et un exemple « live » ci-dessous : {{EmbedLiveSample("Contraintes_de_validation_sur_les_éléments_input_—_simple_début", "100%", 55)}} Pour commencer, faites une copie de fruit-start.html dans un nouveau répertoire sur votre disque dur. La fonctionnalité de validation HTML5 la plus simple à utiliser est l'attribut {{htmlattrxref("required", "input")}}} — si vous voulez rendre une entrée obligatoire, vous pouvez marquer l'élément en utilisant cet attribut. Lorsque cet attribut est mis, le formulaire ne sera pas soumis (et affichera un message d'erreur) si l'entrée est vide (l'entrée sera également considérée comme invalide). Ajoutez un attribut Notez aussi le CSS incorporé dans le fichier exemple : L'entrée a une bordure en pointillés rouge vif lorsqu'elle n'est pas valide, et une bordure noire plus subtile lorsqu'elle est valide. Essayez le nouveau comportement dans l'exemple ci-dessous : {{EmbedLiveSample("Attribut_required", "100%", 55)}} Une autre fonctionnalité de validation très courante est l'attribut {{htmlattrxref("pattern", "input")}}, qui attend une expression régulière comme valeur. Une expression régulière (regex) est un modèle qui peut être utilisé pour faire correspondre des combinaisons de caractères dans des chaînes de texte, de sorte qu'elles sont idéales pour la validation de formulaires (ainsi que diverses autres utilisations en JavaScript). Les Regex sont assez complexes et nous n'avons pas l'intention de vous les enseigner de manière exhaustive dans cet article. Vous trouverez ci-dessous quelques exemples pour vous donner une idée de base de leur fonctionnement : Vous pouvez utiliser des nombres ou d'autres caractères dans ces expressions, comme : Vous pouvez combiner cela pratiquement comme vous l'entendez en précisant les différentes parties les unes après les autres : Voyons un exemple — mettons à jour notre HTML en y ajoutant un attribut {{EmbedLiveSample("Validation_selon_une_expression_régulière", "100%", 55)}} Dans cet exemple, l'élément {{HTMLElement("input")}}} accepte l'une des deux valeurs possibles : la chaîne « banane » ou la chaîne « cerise ». Maintenant, essayez de changer la valeur à l'intérieur de l'attribut Note : Certains types d'éléments {{HTMLElement("input")}} n'ont pas besoin d'un attribut {{htmlattrxref("pattern", "input")}} pour être validés. Spécifier le type Note : L'élément {{HTMLElement("textarea")}} ne prend pas en charge l'attribut {{htmlattrxref("pattern", "input")}}. Tous les champs de texte créés avec ({{HTMLElement("input")}} ou {{HTMLElement("textarea")}}) peuvent être limités en taille avec les attributs {{htmlattrxref("minlength", "input")}} et {{htmlattrxref("maxlength", "input")}}. Le champ sera invalide si sa taille est inférieure à la valeur {{htmlattrxref("minlength", "input")}} ou supérieure la valeur {{htmlattrxref("maxlength", "input")}}. Souvent, les navigateurs ne permettent pas aux utilisateurs de saisir des textes de grande longueur dans les champs texte, mais il peut être utile de disposer d'un contrôle plus fin. Pour les champs numériques (c'est à dire, <type d'entrée="nombre">), les attributs {{htmlattrxref("min", "input")}} et {{htmlattrxref("max", "input")}} permettent également des contraintes de validité. Si la valeur du champ est inférieure à l'attribut {{htmlattrxref("min", "input")}} ou supérieure à l'attribut {{htmlattrxref("max", "input")}}, le champ ne sera pas valide. Prenons un autre exemple. Créez une nouvelle copie du fichier fruit-start.html. Supprimez maintenant le contenu de l'élément Voici cet exemple s'exécutant en « live » : {{EmbedLiveSample('Limitation_de_la_taille_des_entrées', "100%", 100)}} Note : Voici un exemple complet montrant l'utilisation des fonctionnalités HTML intégrées pour la validation :
-
-
-
-
- Prérequis :
- Notions concernant les ordinateurs, une bonne compréhension du HTML, des CSS et de JavaScript.
-
-
-
+
+ Objectif :
- Comprendre ce qu'est la validation d'un formulaire, pourquoi c'est important et comment la mettre en œuvre.
-
+
+ Prérequis :
+
+ Notions concernant les ordinateurs, une bonne compréhension du
+ HTML, des
+ CSS et de
+ JavaScript.
+
+
+
+
Objectif :
+
+ Comprendre ce qu'est la validation d'un formulaire, pourquoi c'est
+ important et comment la mettre en œuvre.
+
+ Qu'est‑ce qu'une validation de formulaire?
+## Qu'est‑ce qu'une validation de formulaire?
-
-
+- « Ce champ est obligatoire » (vous ne pouvez pas le laisser vide)
+- « Veuillez entrer votre numéro de téléphone au format xxx-xxxx » (il attend trois chiffres suivis d'un tiret, suivi de quatre chiffres).
+- « Veuillez entrer une adresse e-mail valide » (ce que vous avez saisi ne ressemble pas à une adresse e-mail valide).
+- « Votre mot de passe doit comporter entre 8 et 30 caractères et contenir une majuscule, un symbole et un chiffre » (sérieusement ?).
-
-
+- **obtenir de bonnes données dans un bon format** — les applications ne tourneront pas correctement si les données utilisateur sont stockées dans un format fantaisiste, ou si les bonnes informations ne sont pas aux bons endroits ou totalement omises.
+- **protéger nos utilisateurs** — s'ils entrent un mot de passe facile à deviner ou aucun, des utilisateurs malveillants peuvent aisément accéder à leurs comptes et voler leurs données.
+- **nous protéger nous‑mêmes** — il existe de nombreuses façons dont les utilisateurs malveillants peuvent utiliser les formulaires non protégés pour endommager l'application dans laquelle ils se trouvent (voir [Sécurité du site Web](/fr/docs/Learn/Server-side/First_steps/Website_security)).
-Les divers types de validation de formulaire
+### Les divers types de validation de formulaire
-
-
+- La validation côté client est la validation qui est effectuée dans le navigateur, avant que les données n'aient été soumises au serveur. Cette méthode est plus conviviale que la validation côté serveur car elle donne une réponse instantanée. Il est possible de la subdiviser encore avec :
-
-
-
-
+ - la validation JavaScript, codée en JavaScript, entièrement personnalisable.
+ - la validation de formulaire intégrée avec les fonctions de validation de formulaire HTML5. Elle ne nécessite généralement pas de JavaScript, a de meilleures performances, mais elle n'est pas aussi personnalisable.
-
-
+
-Utiliser la validation intégrée au formulaire
+- La validation côté serveur est la validation opérée sur le serveur, après que les données ont été soumises — le code côté serveur est utilisé pour valider les données avant de les mettre dans la base de données. Si elles sont erronées, une réponse est envoyée au client pour dire à l'utilisateur ce qui a mal tourné. La validation côté serveur n'est pas aussi conviviale que la validation côté client, car elle nécessite un aller-retour vers le serveur, mais c'est la dernière ligne de défense de votre application contre les mauvaises données (c'est-à-dire les données incorrectes, voire malveillantes). Tous les modèles de canevas de vérification courants côté serveur ont des fonctions de validation et de nettoyage des données (ce qui les sécurise).
-
- Quand un élément est valide :
-
+## Utiliser la validation intégrée au formulaire
-
-
+- l'élément correspond à la pseudo‑classe CSS {{cssxref(":valid")}} ; cela vous permet d'appliquer une composition de style distinctive.
+- si l'utilisateur essaie d'envoyer les données, le navigateur soumet le formulaire pour autant qu'il n'y ait rien d'autre qui l'empêche de le faire (par ex. du JavaScript).
-Contraintes de validation sur les éléments input — simple début
+Quand un élément est invalide :
-Attribut required
+### Attribut required
-required
à votre saisie, comme montré ci‑dessous :<form>
- <label for="choose">Préférez-vous la banane ou la cerise ?</label>
- <input id="choose" name="i_like" required>
- <button>Soumettre</button>
-</form>
+```html
+
+```
-input:invalid {
+```css
+input:invalid {
border: 2px dashed red;
}
input:valid {
border: 1px solid black;
-}
+}
+```
-Validation selon une expression régulière
+### Validation selon une expression régulière
-
-
+- `a` — correspond à un caractère qui doit être un a (ni b, ni aa, etc.)
+- `abc` — correspond à `a`, suivi de `b`, suivi de `c`.
+- `a*` — correspond au caractère a, absent ou présent plusieurs fois (`+` correspond à un caractère une ou plusieurs fois).
+- `[^a]` — correspond à un caractère qui **n'est pas** un a.
+- `a|b` — correspond à un caractère qui est a ou b.
+- `[abc]` — correspond à un caractère qui est a, b ou c.
+- `[^abc]` — correspond à un caractère qui **n'est pas** a, b ou c.
+- `[a-z]` — correspond à tout caractère de la plage a–z, en minuscules seulement (utilisez `[A-Za-z]` pour minuscules et majuscules et `[A-Z]` pour les majuscules uniquement).
+- `a.c` — correspond à a, suivi par n'importe quel caractère,suivi par c.
+- `a{5}` — correspond à a, 5 fois.
+- `a{5,7}` — correspond à a, 5 à 7 fois, mais ni plus, ni moins.
-a
— correspond à un caractère qui doit être un a (ni b, ni aa, etc.)abc
— correspond à a
, suivi de b
, suivi de c
.a*
— correspond au caractère a, absent ou présent plusieurs fois (+
correspond à un caractère une ou plusieurs fois).[^a]
— correspond à un caractère qui n'est pas un a.a|b
— correspond à un caractère qui est a ou b.[abc]
— correspond à un caractère qui est a, b ou c.[^abc]
— correspond à un caractère qui n'est pas a, b ou c.[a-z]
— correspond à tout caractère de la plage a–z, en minuscules seulement (utilisez [A-Za-z]
pour minuscules et majuscules et [A-Z]
pour les majuscules uniquement).a.c
— correspond à a, suivi par n'importe quel caractère,suivi par c.a{5}
— correspond à a, 5 fois.a{5,7}
— correspond à a, 5 à 7 fois, mais ni plus, ni moins.
-
+- `[ -]` — correspond à une espace ou un tiret.
+- `[0-9]` — correspond à tout nombre compris entre 0 et 9.
-[ -]
— correspond à une espace ou un tiret.[0-9]
— correspond à tout nombre compris entre 0 et 9.
-
+- `[Ll].*k` — Un seul caractère L en majuscules ou minuscules, suivi de zéro ou plusieurs caractères de n'importe quel type, suivis par un k minuscules.
+- `[A-Z][A-Za-z' -]+` — Un seul caractère en majuscules suivi par un ou plusieurs caractères en majuscules ou minuscules, un tiret, une apostrophe ou une espace. Cette combinaison peut s'utiliser pour valider les nom de villes dans les pays anglo‑saxons ; ils débutent par une majuscule et ne contiennent pas d'autre caractère. Quelques exemples de ville de GB correspondant à ce schéma : Manchester, Ashton-under-lyne et Bishop's Stortford.
+- `[0-9]{3}[ -][0-9]{3}[ -][0-9]{4}` — Un schéma pour un numéro de téléphone intérieur américain — trois chiffres, suivis par une espace ou un tiret, suivis par trois nombres, suivis par une espace ou un tiret, suivis par quatre nombres. Vous aurez peut-être à faire plus compliqué, car certains écrivent leur numéro de zone entre parenthèses, mais ici il s'agit simplement de faire une démonstration.
-[Ll].*k
— Un seul caractère L en majuscules ou minuscules, suivi de zéro ou plusieurs caractères de n'importe quel type, suivis par un k minuscules.[A-Z][A-Za-z' -]+
— Un seul caractère en majuscules suivi par un ou plusieurs caractères en majuscules ou minuscules, un tiret, une apostrophe ou une espace. Cette combinaison peut s'utiliser pour valider les nom de villes dans les pays anglo‑saxons ; ils débutent par une majuscule et ne contiennent pas d'autre caractère. Quelques exemples de ville de GB correspondant à ce schéma : Manchester, Ashton-under-lyne et Bishop's Stortford.[0-9]{3}[ -][0-9]{3}[ -][0-9]{4}
— Un schéma pour un numéro de téléphone intérieur américain — trois chiffres, suivis par une espace ou un tiret, suivis par trois nombres, suivis par une espace ou un tiret, suivis par quatre nombres. Vous aurez peut-être à faire plus compliqué, car certains écrivent leur numéro de zone entre parenthèses, mais ici il s'agit simplement de faire une démonstration.pattern
, ainsi :<form>
- <label for="choose">Préférez‑vous la banane ou la cerise ?</label>
- <input id="choose" name="i_like" required pattern="banane|cerise">
- <button>Soumettre</button>
-</form>
+```html
+
+```
-input:invalid {
+```css
+input:invalid {
border: 2px dashed red;
}
input:valid {
border: 1px solid black;
-}
+}
+```
-pattern
suivant certains exemples vus plus haut et regardez comment les valeurs entrées en sont affectées pour rester valides. Écrivez vos propres textes et voyez comment vous vous en sortez ! Restez dans le domaine des fruits dans la mesure du possible, afin que vos exemples aient du sens !email
, par exemple, valide la valeur saisie par rapport à une expression régulière correspondant à une adresse e‑mail bien formée (ou une liste d'adresses e‑mail séparées par des virgules si elle possède l'attribut {{htmlattrxref("multiple", "input")}}. Comme autre exemple, les champs de type url
vont automatiquement nécessiter une URL correctement formée.Limitation de la taille des entrées
+### Limitation de la taille des entrées
-<body>
et remplacez-le par le suivant :<form>
- <div>
- <label for="choose">Préférez‑vous la banane ou la cerise ?</label>
- <input id="choose" name="i_like" required minlength="6" maxlength="6">
- </div>
- <div>
- <label for="number">Combien en voulez‑vous ?</label>
- <input type="number" id="number" name="amount" value="1" min="1" max="10">
- </div>
- <div>
- <button>Soumettre</button>
- </div>
-</form>
+```html
+
+```
-
-
+- Ici, nous avons donné au champ de texte une taille minimale et maximale de 6 caractères — la même que celle de _banane_ ou _cerise_. La saisie de moins de 6 caractères s'affichera comme non valide et la saisie de plus de 6 caractères ne sera pas possible dans la plupart des navigateurs.
+- Nous avons également contraint le champ `number` à un `min` de 1 et un `max `de 10 — les nombres entrés hors de cette plage seront affichés comme non valides, et vous ne pourrez pas utiliser les flèches d'incrémentation/décrémentation pour porter la valeur en dehors de cette plage.
-
+}
+```
-number
à un min
de 1 et un max
de 10 — les nombres entrés hors de cette plage seront affichés comme non valides, et vous ne pourrez pas utiliser les flèches d'incrémentation/décrémentation pour porter la valeur en dehors de cette plage.<input type="number">
(et d'autres types, comme range
) acceptent aussi un attribut {{htmlattrxref("step", "input")}} qui spécifie l'incrément en plus ou en moins de la valeur quand les contrôles d'entrée sont utilisés (comme les boutons ^ et v).Exemple complet
+### Exemple complet
-<form>
- <p>
- <fieldset>
- <legend>Qualité<abbr title="Ce champ est obligatoire">*</abbr></legend>
- <input type="radio" required name="title" id="r1" value="Mr"><label for="r1">M.</label>
- <input type="radio" required name="title" id="r2" value="Ms"><label for="r2">Mme.</label>
- </fieldset>
- </p>
- <p>
- <label for="n1">Quel est votre âge ?</label>
- <!-- L'attribut pattern peut servir de recours pour les navigateurs dont le type number n'est
+```html
+
+ + + +
++ + + +
++ + +
++ + +
++ +
+ +``` + +```css +body { font: 1em sans-serif; padding: 0; margin : 0; @@ -306,7 +306,7 @@ form { padding: 0 5px; } -p > label { +p > label { display: block; } @@ -336,60 +336,42 @@ input:invalid { input:focus:invalid { outline: none; -} - -{{EmbedLiveSample("Exemple_complet", "100%", 450)}}
- - - -Comme nous avons vu dans les exemples précédents, à chaque fois qu'un utilisateur tente d'envoyer un formulaire invalide, le navigateur affiche un message d'erreur. La manière dont le message est affiché dépend du navigateur.
- -Ces messages automatiques présentent deux inconvénients:
- -Navigateur | -Affichage | -
---|---|
Firefox 17 (Windows 7) | -![]() |
-
Chrome 22 (Windows 7) | -![]() |
-
Opera 12.10 (Mac OSX) | -![]() |
-
Pour personnaliser l'apparence et le texte de ces messages, vous devez utiliser JavaScript ; il n'est pas possible de l'implémenter en utilisant uniquement HTML et CSS.
+Comme nous avons vu dans les exemples précédents, à chaque fois qu'un utilisateur tente d'envoyer un formulaire invalide, le navigateur affiche un message d'erreur. La manière dont le message est affiché dépend du navigateur. -HMTL5 fournit une API de contraintes de validation pour vérifier et personnaliser l'état des élément d'un formulaire. Il est possible, entre autres, de changer le texte des messages d'erreur. Voici un court exemple :
+Ces messages automatiques présentent deux inconvénients: -<form> - <label for="mail">Pourriez-vous nous fournir une adresse mail ?</label> - <input type="email" id="mail" name="mail"> - <button>Envoyer</button> -</form>+- Il n'y a pas de façon standard de changer leur apparence avec CSS. +- Ils dépendent des paramètres régionaux du navigateur, ce qui signifie que vous pouvez avoir une page dans une langue mais les messages d'erreurs affichés dans une autre. -
En JavaScript, il faut appeler la méthode setCustomValidity()
:
var email = document.getElementById("mail"); +Pour personnaliser l'apparence et le texte de ces messages, vous devez utiliser JavaScript ; il n'est pas possible de l'implémenter en utilisant uniquement HTML et CSS. + +HMTL5 fournit une [API de contraintes de validation](https://www.w3.org/TR/html5/forms.html#the-constraint-validation-api) pour vérifier et personnaliser l'état des élément d'un formulaire. Il est possible, entre autres, de changer le texte des messages d'erreur. Voici un court exemple : + +```html ++``` + +En JavaScript, il faut appeler la méthode [`setCustomValidity()`]( "/en-US/docs/HTML/HTML5/Constraint_validation#Constraint_API's_element.setCustomValidity()"): + +```js +var email = document.getElementById("mail"); email.addEventListener("keyup", function (event) { if(email.validity.typeMismatch) { @@ -397,126 +379,72 @@ email.addEventListener("keyup", function (event) { } else { email.setCustomValidity(""); } -}); - -
{{EmbedLiveSample("Messages_adaptés_pour_les_erreurs", "100%", 50)}}
- -Si vous souhaitez avoir le contrôle de l'apparence des messages d'erreur, ou si vous voulez gérer le comportement des navigateurs n'ayant pas implémenté la validation de formulaire HTML5, vous n'avez pas d'autre choix que d'utiliser JavaScript.
- -De plus en plus de navigateurs prennent maintenant en charge l'API de validation des contraintes, et elle devient fiable. Cette API se compose d'un ensemble de méthodes et de propriétés disponibles sur chaque élément de formulaire.
- -Propriétés de l'API de validation des contraintes
- -Propriétés | -Description | -
---|---|
validationMessage |
- Un message (dans la langue locale) décrivant les contraintes de validation que le contrôle ne satisfait pas (si c'est le cas), ou une chaîne vide si le contrôle n'est pas soumis à validation (willValidate est alors false ), ou bien la valeur de l'élément satisfait ses contraintes. |
-
validity |
- Un objet {{domxref("ValidityState")}} qui décrit l'état de validité de l'élément. | -
validity.customError |
- Renvoie true si l'élément à une erreur personnalisée, false a contrario. |
-
validity.patternMismatch |
- Renvoie true si la valeur de l'élément ne correspond pas au motif fourni, false dans le cas contraire. Si la méthode renvoie true , l'élément fera partie de la pseudo-classe CSS {{cssxref(":invalid")}}. |
-
validity.rangeOverflow |
- Renvoie true si la valeur de l'élément est supérieure au maximum défini, false dans le cas contraire. Si le retour est true , l'élément fera partie des pseudo-classes CSS {{cssxref(":invalid")}} et {{cssxref(":out-of-range")}}. |
-
validity.rangeUnderflow |
- Renvoie true si la valeur de l'élément est plus petite que le minimum défini, false dans le cas contraire. Si le retour est true , l'élément fera partie des pseudo-classes CSS {{cssxref(":invalid")}} et {{cssxref(":out-of-range")}}. |
-
validity.stepMismatch |
- Renvoie true si la valeur de l'élément ne correspond pas aux règles définies par l'attribut step ,false a contrario. Si le retour est true , l'élément fera partie des pseudo-classes CSS {{cssxref(":invalid")}} et {{cssxref(":out-of-range")}}. |
-
validity.tooLong |
- Renvoie true si la taille de l'élément est supérieure à la longueur maximum définie, false dans le cas contraire. Si le retour est true , l'élément fera partie des pseudo-classes CSS {{cssxref(":invalid")}} et {{cssxref(":out-of-range")}}. |
-
validity.typeMismatch |
- Renvoie true si la syntaxe de la valeur de l'élément n'est pas correcte ; false dans le cas contraire. Si le retour est true , l'élément sera de la pseudo-classe CSS {{cssxref(":invalid")}}. |
-
validity.valid |
- Renvoie true si la valeur de l'élément n'a pas de problème de validité, sinon false . L'élément sera de la pseudo-classe CSS {{cssxref(":valid")}} si le retour est true ; de la pseudo-classe CSS {{cssxref(":invalid")}} si le retour est false . |
-
validity.valueMissing |
- Renvoie true si l'élément n'a pas de valeur alors que le champ est requis, sinonfalse . L'élément sera de la pseudo-classe CSS {{cssxref(":invalid")}} si le retour est true . |
-
willValidate |
- Retourne true si l'élément est validé lorsque le formulaire est soumis, false dans le cas contraire. |
-
Méthodes | -Description | -
---|---|
checkValidity() |
- Renvoie true si la valeur de l'élément n'a pas de problème de validation, false autrement. Si l'élément est invalide, cette méthode déclenche aussi un événement {{event("invalid")}} sur cet élément. |
-
setCustomValidity(message) |
- Ajoute un message d'erreur personnalisé à l'élément ; si vous définissez un message d'erreur personnalisé, l'élément est considéré comme invalide, et le message spécifié est affiché. Cela vous permet d'utiliser du code JavaScript pour établir une erreur de validation autre que celles offertes par l'API standard des contraintes de validation. Le message est affiché à l'utilisateur lorsque le problème est rapporté. Si l'argument est une chaîne de caractères vide, l'erreur personnalisée est considérée comme effacée. | -
Pour les anciens navigateurs, il existe une prothèse d'émulation (polyfill) comme Hyperform, pour compenser le défaut de prise en charge de cette API. Comme vous utilisez déjà JavaScript, l'utilisation d'une prethèse d'émulation n'est pas un souci supplémentaire pour la conception ou l'implémentation de votre site ou application Web.
+Pour les anciens navigateurs, il existe [une prothèse d'émulation (_polyfill_) comme Hyperform](https://hyperform.js.org/), pour compenser le défaut de prise en charge de cette API. Comme vous utilisez déjà JavaScript, l'utilisation d'une prethèse d'émulation n'est pas un souci supplémentaire pour la conception ou l'implémentation de votre site ou application Web. -Voyons comment utiliser l'API pour créer des messages d'erreur personnalisés. Tout d'abord, le HTML :
+Voyons comment utiliser l'API pour créer des messages d'erreur personnalisés. Tout d'abord, le HTML : -<form novalidate> - <p> - <label for="mail"> - <span>Veuillez saisir une adresse e-mail :</span> - <input type="email" id="mail" name="mail"> - <span class="error" aria-live="polite"></span> - </label> - <p> - <button>Envoyer</button> -</form>+```html + +``` -
Ce formulaire simple utilise l'attribut {{htmlattrxref("novalidate","form")}} pour désactiver la validation automatique par le navigateur ; cela permet donc à notre script d'avoir le contrôle sur la validation. Toutefois, cela ne désactive la prise en charge par l'API de validation des contraintes, ni l'application des pseudo-classes CSS {{cssxref(":valid")}}, {{cssxref(":invalid")}}, {{cssxref(":in-range")}} et {{cssxref(":out-of-range")}}. Cela signifie que, même si le navigateur ne vérifie pas automatiquement la validité du formulaire avant l'envoi des données, vous pouvez toujours effectuer cette validation et définir l'apparence du formulaire par vous-même.
+Ce formulaire simple utilise l'attribut {{htmlattrxref("novalidate","form")}} pour désactiver la validation automatique par le navigateur ; cela permet donc à notre script d'avoir le contrôle sur la validation. Toutefois, cela ne désactive la prise en charge par l'API de validation des contraintes, ni l'application des pseudo-classes CSS {{cssxref(":valid")}}, {{cssxref(":invalid")}}, {{cssxref(":in-range")}} et {{cssxref(":out-of-range")}}. Cela signifie que, même si le navigateur ne vérifie pas automatiquement la validité du formulaire avant l'envoi des données, vous pouvez toujours effectuer cette validation et définir l'apparence du formulaire par vous-même. -L'attribut aria-live
garantit que nos messages d'erreur personnalisés seront affichés à tout le monde, y compris les personnes utilisant des techniques d'assistance comme des lecteurs d'écran.
Ce CSS compose le formulaire et les messages d'erreur pour les rendre plus attrayants.
+Ce CSS compose le formulaire et les messages d'erreur pour les rendre plus attrayants. -/* Juste pour que notre exemple soit plus joli */ +```css +/* Juste pour que notre exemple soit plus joli */ body { font: 1em sans-serif; padding: 0; @@ -571,13 +499,15 @@ input:focus:invalid { .error.active { padding: 0.3em; -}+} +``` -
Le code JavaScript suivant gère la validation personnalisée des erreurs.
+Le code JavaScript suivant gère la validation personnalisée des erreurs. -// Il y a plusieurs façon de sélectionner un nœud DOM ; ici on récupère +```js +// Il y a plusieurs façon de sélectionner un nœud DOM ; ici on récupère // le formulaire et le champ d'e-mail ainsi que l'élément span // dans lequel on placera le message d'erreur @@ -606,60 +536,61 @@ form.addEventListener("submit", function (event) { // Et on empêche l'envoi des données du formulaire event.preventDefault(); } -}, false);+}, false); +``` + +Voici le résultat: -
Voici le résultat:
+{{EmbedLiveSample("Exemple_utilisant_la_validation_des_contraintes", "100%", 130)}} -{{EmbedLiveSample("Exemple_utilisant_la_validation_des_contraintes", "100%", 130)}}
+L'API de validation des contraintes fournit un outil puissant pour gérer la validation des formulaires, en vous laissant un contrôle sur l'interface utilisateur bien supérieur à ce que vous auriez pu avoir avec uniquement HTML et CSS. -L'API de validation des contraintes fournit un outil puissant pour gérer la validation des formulaires, en vous laissant un contrôle sur l'interface utilisateur bien supérieur à ce que vous auriez pu avoir avec uniquement HTML et CSS.
+### Valider des formulaires sans API intégrée -Il arrive parfois, comme c'est le cas avec des navigateurs anciens ou de widgets personnalisés, de ne pas pouvoir (ou vouloir) utiliser l'API de validation des contraintes. Dans ce cas, vous pourrez toujours utiliser JavaScript pour valider votre formulaire. Valider un formulaire est plus une question d'interface utilisateur que de réelle validation des données.
+Pour valider un formulaire, vous devez vous poser un certain nombre de questions: -Pour valider un formulaire, vous devez vous poser un certain nombre de questions:
+- Quel type de validation dois-je réaliser ? + - : Vous devez déterminer comment valider vos données : opération sur des chaînes de caractères, conversion de type, expressions rationnelles, etc. C'est comme vous voulez. Mais retenez simplement que les données de formulaire sont toujours du texte et sont toujours fournies à vos scripts sous forme de chaînes de caractères. +- Que dois-je faire si le formulaire n'est pas valide ? + - : C'est clairement une affaire d'interface utilisateur. Vous devez décider comment le formulaire doit se comporter : enverra-t-il quand même les données ? Devriez-vous mettre en évidence les champs qui sont en erreur ? Devriez-vous afficher des messages d'erreur ? +- Comment puis-je aider l'utilisateur à corriger ses données invalides? -Pour limiter la frustration de l'utilisateur, il est très important de fournir autant d'information d'aide que nécessaire pour le guider dans la correction de sa saisie. Vous devriez afficher des suggestions en amont pour que l'utilisateur sache ce qui est attendu, ainsi que des messages d'erreur clairs. Si vous souhaitez vous plonger dans les exigences d'interface utilsateur pour la validation de formulaires, voici quelques articles (en anglais) utiles que vous devriez lire :
-Afin d'illustrer le propos, réécrivons le précédent exemple afin qu'il fonctionne avec d'anciens navigateurs:
+#### Exemple sans utilisation de la validation des contraintes -<form> - <p> - <label for="mail"> - <span>Veuillez saisir une adresse e-mail :</span> - <input type="text" class="mail" id="mail" name="mail"> - <span class="error" aria-live="polite"></span> - </label> - <p> - <!-- Certains navigateurs historiques ont besoin de l'attribut - `type` avec la valeur `submit` sur l'élément `button` --> - <button type="submit">Envoyer</button> -</form>+Afin d'illustrer le propos, réécrivons le précédent exemple afin qu'il fonctionne avec d'anciens navigateurs: -
Comme vous pouvez voir, le HTML est quasiment identique; nous avons juste enlevé les fonctionnalités de validation HTML. Notez que ARIA est une spécification indépendante qui n'est pas spécifiquement liée à HTML5.
+```html + +``` -De même, nous n'avons pas eu à changer radicalement les CSS ; nous avons simplement transformé la pseudo-classe {{cssxref(":invalid")}} en une vraie classe et évité d'utiliser le sélecteur d'attribut, qui ne fonctionne pas avec Internet Explorer 6.
+##### CSS -/* On améliore l'aspect de l'exemple avec ces quelques règles */ +De même, nous n'avons pas eu à changer radicalement les CSS ; nous avons simplement transformé la pseudo-classe {{cssxref(":invalid")}} en une vraie classe et évité d'utiliser le sélecteur d'attribut, qui ne fonctionne pas avec Internet Explorer 6. + +```css +/* On améliore l'aspect de l'exemple avec ces quelques règles */ body { font: 1em sans-serif; padding: 0; @@ -714,13 +645,15 @@ input:focus.invalid { .error.active { padding: 0.3em; -}+} +``` -
Les changements les plus importants sont dans le code JavaScript, qui nécessite bien plus que de simples retouches.
+Les changements les plus importants sont dans le code JavaScript, qui nécessite bien plus que de simples retouches. -// Il existe moins de méthode pour sélectionner un nœud DOM +```js +// Il existe moins de méthode pour sélectionner un nœud DOM // avec les navigateurs historiques var form = document.getElementsByTagName('form')[0]; var email = document.getElementById('mail'); @@ -732,7 +665,7 @@ var error = email; while ((error = error.nextSibling).nodeType != 1); // Pour respecter la spécification HTML5 -var emailRegExp = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/; +var emailRegExp = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/; // De nombreux navigateurs historiques ne supportent pas la méthode // addEventListener. Voici une méthode simple (il en existe d'autres) @@ -795,62 +728,52 @@ addEvent(form, "submit", function () { error.innerHTML = ""; error.className = "error"; } -});+}); +``` + +Voici le résultat: + +{{EmbedLiveSample("Exemple_sans_utilisation_de_la_validation_des_contraintes", "100%", 130)}} + +Comme vous avez pu le voir, il n'est pas si difficile de créer par soi-même un système de validation. La difficulté consiste à rendre le tout assez générique pour l'utiliser à la fois sur toutes les plateformes et pour chaque formulaire que vous pourriez créer. Il existe de nombreuses bibliothèques permettant ce genre de validation de formulaire ; n'hésitez pas à les utiliser. En voici quelques exemples : -
Voici le résultat:
+- Bibliothèques indépendantes : -{{EmbedLiveSample("Exemple_sans_utilisation_de_la_validation_des_contraintes", "100%", 130)}}
+ - [Validate.js](http://rickharrison.github.com/validate.js/) -Comme vous avez pu le voir, il n'est pas si difficile de créer par soi-même un système de validation. La difficulté consiste à rendre le tout assez générique pour l'utiliser à la fois sur toutes les plateformes et pour chaque formulaire que vous pourriez créer. Il existe de nombreuses bibliothèques permettant ce genre de validation de formulaire ; n'hésitez pas à les utiliser. En voici quelques exemples :
+- Greffons jQuery : -Il peut être utile, dans certains cas, d'effectuer une validation à distance. Ce genre de validation est nécessaire lorsque les données saisies par l'utilisateur sont liées à des données supplémentaires stockées sur le serveur hébergeant votre application. Prenons par exemple les formulaires d'inscription, pour lesquels on vous demande un nom d'utilisateur. Pour éviter toute duplication d'un nom d'utilisateur, il est plus judicieux d'effectuer une requête AJAX pour vérifier la disponibilté du nom d'utilisateur que de demander à envoyer les données saisies et de renvoyer le formulaire avec une erreur.
+Il peut être utile, dans certains cas, d'effectuer une validation à distance. Ce genre de validation est nécessaire lorsque les données saisies par l'utilisateur sont liées à des données supplémentaires stockées sur le serveur hébergeant votre application. Prenons par exemple les formulaires d'inscription, pour lesquels on vous demande un nom d'utilisateur. Pour éviter toute duplication d'un nom d'utilisateur, il est plus judicieux d'effectuer une requête AJAX pour vérifier la disponibilté du nom d'utilisateur que de demander à envoyer les données saisies et de renvoyer le formulaire avec une erreur. -Pour réaliser une telle validation, plusieurs précautions doivent être prises :
+Pour réaliser une telle validation, plusieurs précautions doivent être prises : -La validation d'un formulaire ne requiert pas de code JavaScript complexe, mais il est nécessaire de penser tout particulièrement à l'utilisateur. Rappelez-vous de toujours aider l'utilisateur à corriger les données qu'il saisit. Pour ce faire, assurez-vous de toujours :
+La validation d'un formulaire ne requiert pas de code JavaScript complexe, mais il est nécessaire de penser tout particulièrement à l'utilisateur. Rappelez-vous de toujours aider l'utilisateur à corriger les données qu'il saisit. Pour ce faire, assurez-vous de toujours : -{{PreviousMenuNext("Web/Guide/HTML/Formulaires/Envoyer_et_extraire_les_données_des_formulaires", "Web/Guide/HTML/Formulaires/Comment_construire_des_widgets_de_formulaires_personnalisés", "Web/Guide/HTML/Formulaires")}}
+{{PreviousMenuNext("Web/Guide/HTML/Formulaires/Envoyer_et_extraire_les_données_des_formulaires", "Web/Guide/HTML/Formulaires/Comment_construire_des_widgets_de_formulaires_personnalisés", "Web/Guide/HTML/Formulaires")}} -