CKTIS / HTML
step — rozestup povolených hodnot pro input
Atribut step určuje rozestup mezi povolenými číselnými hodnotami, daty nebo časy v prvku input. Krok se počítá od základní hodnoty; any toto omezení ruší, ale ostatní pravidla platnosti zůstávají.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
step="<positive floating-point number>" | step="any"step se vztahuje na number, range, date, month, week, time a datetime-local. Podle syntaxe HTML musí být hodnotou atributu platný zápis kladného čísla s plovoucí řádovou čárkou nebo any (bez rozlišování velikosti písmen ASCII). Pokud atribut chybí, použije se výchozí krok. Pokud hodnota není any, prohlížeč se ji pokusí přečíst jako číslo s plovoucí řádovou čárkou. Výchozí krok použije jen tehdy, když se převod nezdaří nebo je výsledkem nula či záporné číslo. Například step="2px" syntaxi neodpovídá, ale prohlížeč může hodnotu přečíst jako 2 a nastavit krok na 2.
Základní hodnota je postupně: platný atribut min, platný obsahový atribut value, výchozí základní hodnota daného typu, nebo nula. Změna vlastnosti .value nemění obsahový atribut value. Rozdíl mezi hodnotou a základní hodnotou musí být po přepočtu jednotek celočíselným násobkem kroku; jinak je validity.stepMismatch true.
Výchozí krok je 1 pro number a range, 1 den pro date, 1 měsíc pro month, 1 týden pro week a 60 sekund pro time a datetime-local. Zvláštní základní hodnota pro week je pondělí, kterým začíná 1970-W01, tedy −259200000 milisekund vzhledem k unixové epoše.
step="any" ruší pouze omezení kroku: neruší min, max ani požadavky na formát. Při hodnotě any vyvolají stepUp() a stepDown() chybu InvalidStateError. Příklad ověřuje shodu s krokem, nikoli celkovou platnost pole.
Příklady
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);Výsledek
false true false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.