Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

step — razmiki med dovoljenimi vrednostmi za input

Atribut step določa razmik med dovoljenimi številskimi vrednostmi, datumi ali časi v elementu input. Korak se meri od osnove; any to omejitev odpravi, ne odpravi pa drugih pravil veljavnosti.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

step velja za number, range, date, month, week, time in datetime-local. Po skladnji HTML mora biti vrednost atributa veljaven zapis pozitivnega števila s plavajočo vejico ali any (brez razlikovanja med velikimi in malimi črkami ASCII). Če atribut manjka, se uporabi privzeti korak. Če vrednost ni any, jo brskalnik poskusi prebrati kot število s plavajočo vejico. Privzeti korak uporabi le, če branje ne uspe ali če je rezultat nič ali negativno število. Na primer, step="2px" ni skladen s skladnjo HTML, vendar lahko brskalnik vrednost prebere kot 2 in korak nastavi na 2.

Osnova je po prednostnem vrstnem redu: veljaven atribut min, veljaven vsebinski atribut value, privzeta osnova vrste ali nič. Sprememba lastnosti .value ne spremeni vsebinskega atributa value. Razlika med vrednostjo in osnovo mora biti po pretvorbi enot celoštevilčni večkratnik koraka; sicer je validity.stepMismatch true.

Privzeti korak je 1 za number in range, 1 dan za date, 1 mesec za month, 1 teden za week ter 60 sekund za time in datetime-local. Posebna osnova za week je ponedeljek, na katerega se začne 1970-W01, torej −259200000 milisekund glede na uniksko epoho.

step="any" odpravi samo omejitev koraka: ne odpravi min, max ali zahtev glede oblike. Pri any metodi stepUp() in stepDown() sprožita napako InvalidStateError. Primer preverja ujemanje s korakom, ne pa splošne veljavnosti polja.

Primeri

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

Rezultat

false
true
false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri