CKTIS / HTML
step — intervalos de valores permitidos en input
El atributo step establece la distancia entre los valores numéricos, de fecha o de hora permitidos en un input. El paso se calcula desde una base; any elimina esta restricción, pero no las demás reglas de validez.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
step="<positive floating-point number>" | step="any"step se aplica a number, range, date, month, week, time y datetime-local. Para ajustarse a la sintaxis de HTML, el valor del atributo debe ser un número válido de coma flotante mayor que cero o any (sin distinguir entre mayúsculas y minúsculas ASCII). Si falta el atributo, se usa el paso predeterminado. Si el valor no es any, el navegador intenta interpretarlo como un número de coma flotante y solo usa el paso predeterminado si no logra interpretarlo o si obtiene cero o un número negativo. Por ejemplo, step="2px" no se ajusta a la sintaxis, pero el navegador puede interpretarlo como 2 y establecer el paso en 2.
La base es, por orden de prioridad: un atributo min válido, el atributo de contenido value válido, la base predeterminada del tipo o cero. Cambiar la propiedad .value no cambia el atributo de contenido value. Tras convertir las unidades, la diferencia entre el valor y la base debe ser un múltiplo entero del paso; de lo contrario, validity.stepMismatch es true.
El paso predeterminado es 1 para number y range, 1 día para date, 1 mes para month, 1 semana para week y 60 segundos para time y datetime-local. La base excepcional de week es el lunes en que comienza 1970-W01, es decir, −259200000 milisegundos con respecto a la época Unix.
step="any" elimina solo la restricción del paso: no elimina min, max ni los requisitos de formato. Con any, stepUp() y stepDown() lanzan un InvalidStateError. El ejemplo comprueba la correspondencia con el paso, no la validez completa del campo.
Ejemplos
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);Resultado
false true false
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.