CKTIS / HTML
step — rozostup povolených hodnôt pre input
Atribút step určuje rozostup medzi povolenými číselnými hodnotami, dátumami alebo časmi v prvku input. Krok sa počíta od základnej hodnoty; any toto obmedzenie ruší, no ostatné pravidlá platnosti zostávajú.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
step="<positive floating-point number>" | step="any"step sa vzťahuje na number, range, date, month, week, time a datetime-local. Podľa syntaxe HTML musí byť hodnotou atribútu platný zápis kladného čísla s pohyblivou rádovou čiarkou alebo any (bez rozlišovania veľkosti písmen ASCII). Ak atribút chýba, použije sa predvolený krok. Ak hodnota nie je any, prehliadač sa ju pokúsi interpretovať ako číslo s pohyblivou rádovou čiarkou. Predvolený krok použije len vtedy, ak sa prevod nepodarí alebo je výsledkom nula či záporné číslo. Napríklad step="2px" nezodpovedá syntaxi, no prehliadač môže hodnotu prečítať ako 2 a nastaviť krok na 2.
Základná hodnota je postupne: platný atribút min, platný obsahový atribút value, predvolená základná hodnota daného typu alebo nula. Zmena vlastnosti .value nemení obsahový atribút value. Rozdiel medzi hodnotou a základnou hodnotou musí byť po prepočte jednotiek celočíselným násobkom kroku; inak je validity.stepMismatch true.
Predvolený krok je 1 pre number a range, 1 deň pre date, 1 mesiac pre month, 1 týždeň pre week a 60 sekúnd pre time a datetime-local. Osobitná základná hodnota pre week je pondelok, ktorým sa začína 1970-W01, teda −259200000 milisekúnd vzhľadom na unixovú epochu.
step="any" ruší iba obmedzenie kroku: neruší min, max ani požiadavky na formát. Pri hodnote any vyvolajú stepUp() a stepDown() chybu InvalidStateError. Príklad overuje zhodu s krokom, nie celkovú platnosť poľa.
Prí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ýsledok
false true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.