Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

step — krok dozwolonych wartości pola input

Atrybut step określa odstęp między dozwolonymi wartościami liczbowymi lub datami i czasami w polu input. Krok jest liczony względem bazy; any wyłącza to ograniczenie, ale nie pozostałe reguły poprawności.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

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

step dotyczy typów number, range, date, month, week, time i datetime-local. W kodzie HTML wartość atrybutu musi być poprawnym zapisem dodatniej liczby zmiennoprzecinkowej albo słowem any (bez rozróżniania wielkości liter ASCII). Jeśli atrybutu brakuje, obowiązuje krok domyślny. Jeśli wartość nie jest any, przeglądarka próbuje odczytać ją jako liczbę zmiennoprzecinkową: krok domyślny stosuje tylko wtedy, gdy odczyt się nie powiedzie lub da wynik niedodatni. Na przykład step="2px" jest niezgodne ze składnią HTML, ale przeglądarka może odczytać 2 i ustawić krok na 2.

Bazą jest kolejno: poprawny atrybut min, poprawny atrybut treści value, baza domyślna typu albo zero. Zmiana właściwości .value nie zmienia atrybutu treści value. Różnica między wartością a bazą musi być całkowitą wielokrotnością kroku po przeliczeniu jednostek; inaczej validity.stepMismatch wynosi true.

Domyślny krok to 1 dla number i range, 1 dzień dla date, 1 miesiąc dla month, 1 tydzień dla week oraz 60 sekund dla time i datetime-local. Wyjątkowa baza week to poniedziałek rozpoczynający 1970-W01, czyli −259200000 milisekund względem epoki Unix.

step="any" usuwa tylko ograniczenie kroku: nie znosi min, max ani wymaganego formatu. Przy any metody stepUp() i stepDown() zgłaszają InvalidStateError. Przykład sprawdza zgodność z krokiem, nie pełną poprawność pola.

Przykłady

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);

Wynik

false
true
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła