Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

step — intervalos dos valores permitidos em input

O atributo step define o intervalo entre os valores numéricos, de data ou de hora permitidos num input. O passo é calculado a partir de uma base; any remove esta restrição, mas não as restantes regras de validade.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

step aplica-se a number, range, date, month, week, time e datetime-local. Para respeitar a sintaxe de HTML, o valor do atributo tem de ser um número de vírgula flutuante válido e superior a zero ou any (sem distinção entre maiúsculas e minúsculas ASCII). Se o atributo estiver ausente, é usado o passo predefinido. Se o valor não for any, o navegador tenta interpretá-lo como um número de vírgula flutuante e só usa o passo predefinido se não o conseguir interpretar ou se obtiver zero ou um número negativo. Por exemplo, step="2px" não respeita a sintaxe, mas o navegador pode interpretá-lo como 2 e definir o passo como 2.

A base é, por ordem de prioridade: um atributo min válido, o atributo de conteúdo value válido, a base predefinida do tipo ou zero. Alterar a propriedade .value não altera o atributo de conteúdo value. Depois de converter as unidades, a diferença entre o valor e a base tem de ser um múltiplo inteiro do passo; caso contrário, validity.stepMismatch é true.

O passo predefinido é 1 para number e range, 1 dia para date, 1 mês para month, 1 semana para week e 60 segundos para time e datetime-local. A base excecional de week é a segunda-feira em que começa 1970-W01, ou seja, −259200000 milissegundos em relação à época Unix.

step="any" remove apenas a restrição do passo: não remove min, max nem os requisitos de formato. Com any, stepUp() e stepDown() lançam um InvalidStateError. O exemplo verifica a correspondência com o passo, não a validade global do campo.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes