Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

pattern — motif de validation d’un champ de saisie

L’attribut `pattern` définit une expression régulière à laquelle la valeur non vide du champ doit correspondre dans son intégralité. Pour un champ de type `email` avec `multiple`, chaque adresse doit correspondre séparément au motif. Utilisez `required` pour rendre le champ obligatoire.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<input type="text" pattern="[A-Z]{2}[0-9]{3}">

pattern s’applique aux types input text, search, tel, url, email et password, mais pas à number ni à textarea. Il vérifie le format de la valeur au lieu de filtrer les caractères saisis.

La valeur de l’attribut est une expression régulière JavaScript compilée avec le flag v, sans délimiteurs /.../. La correspondance porte sur toute la valeur, comme avec ^(?:pattern)$ ; les ancres explicites ne sont pas nécessaires. Une expression invalide ne définit aucune contrainte de motif.

Une valeur non vide qui ne correspond pas entraîne validity.patternMismatch. Une valeur vide ne contrevient pas à pattern, mais required peut entraîner validity.valueMissing. Un motif vide, pattern="", rejette toute valeur non vide. Pour email avec multiple, le motif est vérifié séparément pour chaque adresse ; les contraintes du type sous-jacent email ou url restent applicables.

Décrivez aux utilisateurs le format requis ; si title est présent, il doit décrire le motif. Dans l’exemple, [A-Z]{2}[0-9]{3} signifie deux lettres majuscules ASCII suivies de trois chiffres ASCII.

Exemples

const input = document.createElement('input');
input.type = 'text';
input.pattern = '[A-Z]{2}[0-9]{3}';
input.required = true;

for (const value of ['AB123', 'ab123', 'XAB123', '']) {
  input.value = value;
  console.log(JSON.stringify({
    value,
    patternMismatch: input.validity.patternMismatch,
    valueMissing: input.validity.valueMissing,
    valid: input.checkValidity()
  }));
}

Résultat

{"value":"AB123","patternMismatch":false,"valueMissing":false,"valid":true}
{"value":"ab123","patternMismatch":true,"valueMissing":false,"valid":false}
{"value":"XAB123","patternMismatch":true,"valueMissing":false,"valid":false}
{"value":"","patternMismatch":false,"valueMissing":true,"valid":false}

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources