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

CKTIS / JavaScript

HTMLInputElement : type, état et contraintes d’un champ

Découvrez six propriétés de HTMLInputElement permettant de choisir le type d’un champ, de lire son état coché, de définir des contraintes et de désactiver un contrôle. Distinguez l’état actuel des attributs initiaux, et un message de validation du résultat de la validation lui-même.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;

HTMLInputElement est l’interface DOM du navigateur pour les champs de saisie, et ne fait pas partie d’ECMAScript. type est une chaîne qui sélectionne le type de contrôle, comme text, number ou checkbox ; ce type détermine les autres contraintes applicables. Ces propriétés sont largement disponibles dans les navigateurs modernes, mais la prise en charge de l’interface de certains types de champs peut varier. Node 24, à lui seul, ne permet pas d’établir la prise en charge de cette API.

minLength est la réflexion numérique de l’attribut minlength : elle définit la longueur minimale du texte en unités de code UTF-16, qui ne correspond pas nécessairement aux caractères perçus par l’utilisateur. -1 signifie qu’aucune longueur minimale n’est définie. Cette propriété s’applique aux types de texte, n’impose pas une valeur non vide sans required, et la validation d’un texte trop court concerne les modifications de l’utilisateur plutôt qu’une simple affectation par script. max est une chaîne, telle que "10", qui fixe la borne supérieure des valeurs numériques, des dates ou des heures pour les types concernés ; contrairement à maxLength, elle ne limite pas la longueur du texte. Avec type="time", les heures suivent un cycle de 24 heures : si min indique une heure plus tardive que max, la plage autorisée va de min à max en passant par minuit. Par exemple, avec min="22:00" et max="02:00", 23:00 est dans la plage autorisée, même si cette heure est plus tardive que max.

checked est un booléen qui décrit l’état coché actuel d’un champ checkbox ou radio, et non sa value textuelle. L’attribut checked définit l’état par défaut, reflété par defaultChecked ; modifier l’état coché actuel ne met pas à jour cet attribut. disabled reflète un attribut booléen : lui attribuer true empêche toute interaction, exclut le contrôle des données de formulaire envoyées et l’écarte de la validation des contraintes. Ce n’est pas l’équivalent de readOnly.

validationMessage est une chaîne en lecture seule qui contient un message d’erreur localisé, ou "" lorsque le contrôle respecte ses contraintes ou est exclu de la validation. Un message vide ne prouve donc pas qu’un contrôle désactivé possède une valeur valide. Définissez un message personnalisé avec setCustomValidity() et effacez-le avec setCustomValidity(""). L’exemple vérifie si le message est vide au lieu de comparer un texte qui dépend de la langue, et ne cherche pas à illustrer une erreur minLength par une affectation de script.

Identifiants de référence couverts par cette entrée : HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.

Exemples

(() => {
  const text = document.createElement("input");
  text.type = "text";
  text.minLength = 3;
  console.log(text.type, text.minLength);

  const box = document.createElement("input");
  box.type = "checkbox";
  box.checked = true;
  console.log(box.checked, box.defaultChecked);

  const number = document.createElement("input");
  number.type = "number";
  number.max = "10";
  number.value = "11";
  console.log(number.max, number.validity.rangeOverflow);
  console.log(number.validationMessage !== "");

  number.disabled = true;
  console.log(number.disabled, number.willValidate);
  console.log(number.validationMessage === "");
})();

Résultat

text 3
true false
10 true
true
true false
true

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