CKTIS / HTML
step — Abstände zulässiger Werte für input
Das Attribut step legt den Abstand zwischen zulässigen Zahlen-, Datums- oder Zeitwerten in einem input fest. Der Schritt wird von einer Basis aus berechnet; any hebt diese Einschränkung auf, nicht jedoch andere Gültigkeitsregeln.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
step="<positive floating-point number>" | step="any"step gilt für number, range, date, month, week, time und datetime-local. In standardkonformem HTML muss der Attributwert eine gültige positive Gleitkommazahl oder any sein (ohne Beachtung der ASCII-Groß- und Kleinschreibung). Fehlt das Attribut, gilt der Standardschritt. Ist der Wert nicht any, versucht der Browser, ihn als Gleitkommazahl zu lesen. Der Standardschritt gilt dann nur, wenn das Einlesen fehlschlägt oder null oder eine negative Zahl ergibt. Beispielsweise ist step="2px" nicht standardkonform, kann aber als 2 gelesen werden und den Schritt auf 2 setzen.
Die Basis ist der Reihe nach: ein gültiges min-Attribut, das gültige value-Inhaltsattribut, die Standardbasis des Typs oder null. Eine Änderung der .value-Eigenschaft ändert das value-Inhaltsattribut nicht. Die Differenz zwischen Wert und Basis muss nach Umrechnung der Einheiten ein ganzzahliges Vielfaches des Schritts sein; andernfalls ist validity.stepMismatch true.
Der Standardschritt beträgt 1 für number und range, 1 Tag für date, 1 Monat für month, 1 Woche für week sowie 60 Sekunden für time und datetime-local. Die besondere Basis für week ist der Montag, an dem 1970-W01 beginnt, also −259200000 Millisekunden relativ zur Unix-Epoche.
step="any" hebt nur die Schrittbeschränkung auf: min, max und Anforderungen an das Format bleiben bestehen. Bei any lösen stepUp() und stepDown() einen InvalidStateError aus. Das Beispiel prüft die Übereinstimmung mit dem Schritt, nicht die vollständige Gültigkeit des Felds.
Beispiele
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);Ergebnis
false true false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.