CKTIS / HTML
step — afstanden tussen toegestane waarden voor input
Het step-attribuut bepaalt de afstand tussen toegestane numerieke waarden, datums of tijden in een input. De stap wordt vanaf een basis berekend; any heft deze beperking op, maar niet de andere validiteitsregels.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
step="<positive floating-point number>" | step="any"step geldt voor number, range, date, month, week, time en datetime-local. Volgens de HTML-syntaxis moet de attribuutwaarde een geldig positief drijvendekommagetal zijn of any (zonder onderscheid tussen ASCII-hoofdletters en kleine letters). Als het attribuut ontbreekt, geldt de standaardstap. Als de waarde niet any is, probeert de browser die als drijvendekommagetal te lezen. Alleen als dat niet lukt of als het resultaat nul of negatief is, geldt de standaardstap. Zo voldoet step="2px" niet aan de syntaxis, maar de browser kan de waarde als 2 lezen en de stap op 2 instellen.
De basis is, in volgorde van prioriteit: een geldig min-attribuut, het geldige value-contentattribuut, de standaardbasis van het type of nul. Een wijziging van de eigenschap .value verandert het value-contentattribuut niet. Na omrekening van de eenheden moet het verschil tussen de waarde en de basis een geheel veelvoud van de stap zijn; anders is validity.stepMismatch true.
De standaardstap is 1 voor number en range, 1 dag voor date, 1 maand voor month, 1 week voor week en 60 seconden voor time en datetime-local. De bijzondere basis voor week is de maandag waarop 1970-W01 begint, oftewel −259200000 milliseconden ten opzichte van de Unix-epoch.
step="any" heft alleen de stapbeperking op: min, max en formaateisen blijven gelden. Met any geven stepUp() en stepDown() een InvalidStateError. Het voorbeeld test of de waarde op de stap uitkomt, niet of het veld in zijn geheel geldig is.
Voorbeelden
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);Resultaat
false true false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.