Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

step — intervalli dei valori consentiti per input

L’attributo step definisce la distanza tra i valori numerici, di data o di ora consentiti in un input. Il passo si calcola a partire da una base; any elimina questo vincolo, ma non le altre regole di validità.

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

Sintassi

step="<positive floating-point number>" | step="any"

step si applica a number, range, date, month, week, time e datetime-local. Per essere conforme alla sintassi HTML, il valore dell’attributo deve essere un numero in virgola mobile valido e maggiore di zero oppure any (senza distinzione tra maiuscole e minuscole ASCII). Se l’attributo è assente, si usa il passo predefinito. Se il valore non è any, il browser tenta di interpretarlo come numero in virgola mobile e usa il passo predefinito solo se non ci riesce oppure se ottiene zero o un numero negativo. Ad esempio, step="2px" non è conforme alla sintassi, ma il browser può interpretarlo come 2 e impostare il passo a 2.

La base è, in ordine di priorità: un attributo min valido, l’attributo di contenuto value valido, la base predefinita del tipo oppure zero. Modificare la proprietà .value non modifica l’attributo di contenuto value. Dopo la conversione delle unità, la differenza tra il valore e la base deve essere un multiplo intero del passo; altrimenti validity.stepMismatch è true.

Il passo predefinito è 1 per number e range, 1 giorno per date, 1 mese per month, 1 settimana per week e 60 secondi per time e datetime-local. La base speciale di week è il lunedì in cui inizia 1970-W01, cioè −259200000 millisecondi rispetto all’epoca Unix.

step="any" rimuove solo il vincolo del passo: non rimuove min, max né i requisiti di formato. Con any, stepUp() e stepDown() generano un InvalidStateError. L’esempio verifica l’allineamento al passo, non la validità complessiva del campo.

Esempi

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);

Risultato

false
true
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti