CKTIS / HTML
step — intervalles entre les valeurs autorisées d’un input
L’attribut step définit l’intervalle entre les valeurs numériques, de date ou d’heure autorisées dans un input. Le pas est calculé à partir d’une base ; any supprime cette contrainte, mais pas les autres règles de validité.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
step="<positive floating-point number>" | step="any"step s’applique à number, range, date, month, week, time et datetime-local. Pour être conforme à HTML, la valeur de l’attribut doit être un nombre à virgule flottante valide et strictement positif, ou any (sans distinction entre majuscules et minuscules ASCII). Si l’attribut est absent, le pas par défaut s’applique. Si la valeur n’est pas any, le navigateur tente de la lire comme un nombre à virgule flottante : il n’utilise le pas par défaut que si la lecture échoue ou donne zéro ou un nombre négatif. Par exemple, step="2px" n’est pas conforme, mais le navigateur peut lire 2 et fixer le pas à 2.
La base est, par ordre de priorité : un attribut min valide, l’attribut de contenu value valide, la base par défaut du type, ou zéro. Modifier la propriété .value ne modifie pas l’attribut de contenu value. Après conversion des unités, la différence entre la valeur et la base doit être un multiple entier du pas ; sinon, validity.stepMismatch vaut true.
Le pas par défaut est de 1 pour number et range, 1 jour pour date, 1 mois pour month, 1 semaine pour week, et 60 secondes pour time et datetime-local. La base particulière de week est le lundi qui commence 1970-W01, soit −259200000 millisecondes par rapport à l’époque Unix.
step="any" supprime uniquement la contrainte de pas : il ne supprime ni min, ni max, ni les exigences de format. Avec any, stepUp() et stepDown() déclenchent une InvalidStateError. L’exemple vérifie l’alignement sur le pas, et non la validité globale du champ.
Exemples
const input = document.createElement('input');
input.type = 'number';
input.min = '0.5';
input.step = '0.25';
input.value = '1';
console.log(input.validity.stepMismatch);
input.value = '1.1';
console.log(input.validity.stepMismatch);
input.step = 'any';
console.log(input.validity.stepMismatch);Résultat
false true 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.