Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje