CKTIS / JavaScript
HTMLInputElement.max et disabled : limite de valeur et désactivation d’un champ
`max` reflète la limite supérieure sous forme de chaîne, tandis que `disabled` indique si le champ a son propre attribut de désactivation. Dépasser la limite ne désactive pas le champ.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
input.max; // string: the max attribute, or "" if absent
input.max = "10"; // set the max attribute
input.removeAttribute("max");
input.disabled; // boolean: whether the input's own disabled attribute is present
input.disabled = true; // add the disabled attribute
input.disabled = false; // remove the disabled attribute
input.matches(":disabled"); // test whether the input is effectively disabledinput.max est une propriété modifiable de type chaîne qui reflète l’attribut HTML max. Elle renvoie le texte de l’attribut, ou "" s’il est absent, et non la limite calculée. input.max = "10" définit l’attribut et input.removeAttribute("max") le supprime.
max s’applique aux types number, range, date, month, week, time et datetime-local, selon un format propre au type. Il ne limite pas la longueur du texte. Si l’attribut est absent ou ne peut pas être interprété, la limite par défaut du type s’applique lorsqu’elle existe : 100 pour range, aucune pour number. Dans un champ number, une valeur supérieure à la limite reste dans value et rend validity.rangeOverflow === true. Un curseur range, lui, ajuste sa valeur à l’intervalle. Un intervalle time dont min est supérieur à max peut passer par minuit.
La propriété booléenne modifiable input.disabled reflète la présence de l’attribut disabled sur le champ lui-même. true ajoute l’attribut et false le supprime. Même disabled="false" désactive le champ. Un fieldset désactivé désactive aussi les champs descendants, sauf ceux contenus dans son premier enfant direct legend. Ainsi, input.disabled peut valoir false alors que input.matches(":disabled") renvoie true.
Un champ désactivé ne peut ni recevoir le focus ni être modifié par l’utilisateur, mais JavaScript peut encore changer sa valeur. Le champ est exclu de la validation des contraintes (willValidate vaut false) et omis lors de l’envoi du formulaire et de la création de new FormData(form). Ces propriétés relèvent du DOM du navigateur et non d’ECMAScript ; un environnement sans DOM ne les fournit pas. Validez toujours les données reçues côté serveur, quels que soient les réglages du champ.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Input max and disabled</title>
</head>
<body>
<script>
const form = document.createElement('form');
const input = document.createElement('input');
input.type = 'number';
input.name = 'quantity';
input.max = '10';
input.value = '12';
form.append(input);
console.log(JSON.stringify([
input.max, input.value, input.validity.rangeOverflow,
input.checkValidity(), new FormData(form).has('quantity'),
]));
input.disabled = true;
console.log(JSON.stringify([
input.disabled, input.value, input.willValidate,
new FormData(form).has('quantity'),
]));
</script>
</body>
</html>Résultat
["10","12",true,false,true] [true,"12",false,false]
Enregistrez l’exemple dans un fichier `.html`, ouvrez-le dans un navigateur et consultez le résultat dans la console du navigateur. `"12"` dépasse `"10"` et échoue à la validation, mais figure tout de même dans `FormData`. Une fois désactivé, le champ conserve sa valeur, mais il est exclu de la validation et des données du formulaire.
Leçons associées
- JavaScript · Leçon 28 · Intermédiaire · Version : 3
Sources
- HTMLInputElement: max property
- HTMLInputElement: disabled property
- HTML Standard — The min and max attributes
- HTML Standard — Range state (type=range)
- HTML Standard — Enabling and disabling form controls: the disabled attribute
- HTML Standard — Constructing the entry list
- Using HTML form validation and the Constraint Validation API