Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes