Limited availability
Die HTMLInputElement.stepUp()
Methode erhöht den Wert eines numerischen Typs eines <input>
Elements um den Wert des step
Attributs oder den Standardwert von step
, falls das step
Attribut nicht explizit gesetzt ist. Wenn die Methode aufgerufen wird, erhöht sie den value
um (step
* n), wobei n
standardmäÃig auf 1
gesetzt ist, wenn nicht angegeben, und step
standardmäÃig den Standardwert für step
hat, wenn nicht angegeben.
1
(Tag) 7 Tage (eine Woche) Schritte:
<input type="date" min="2019-12-25" step="7">
month 1
(Monat) 12 Monate (ein Jahr) Schritte:
<input type="month" min="2019-12" step="12">
week 1
(Woche) Zwei Wochen Schritte:
<input type="week" min="2019-W23" step="2">
time 60
(Sekunden) 900 Sekunden (15 Minuten) Schritte:
<input type="time" min="09:00" step="900">
datetime-local 1
(Tag) Gleicher Wochentag:
<input type="datetime-local" min="019-12-25T19:30" step="7">
number 1
0.1 Schritte
<input type="number" min="0" step="0.1" max="10">
range 1
Erhöhungen um 2:
<input type="range" min="0" step="2" max="10">
Die Methode ändert, wenn sie aufgerufen wird, den Wert des Formkontrolls um den im step
Attribut angegebenen Wert, multipliziert mit dem Parameter, innerhalb der auf das Formkontroll angewendeten Einschränkungen. Der Standardwert für den Parameter ist 1
, wenn kein Wert übergeben wird. Die Methode wird den Wert nicht über den gesetzten max
Wert hinaus erhöhen oder die durch das step
Attribut festgelegten Einschränkungen missachten.
Wenn der Wert vor dem Aufruf der stepUp()
Methode ungültig ist - zum Beispiel, wenn er nicht den durch das step Attribut festgelegten Einschränkungen entspricht - wird der Aufruf der stepUp()
Methode einen Wert zurückgeben, der den Einschränkungen der Formkontrolls entspricht.
Wenn das Formkontroll nicht zeit-, daten- oder zahlenbasiert ist und daher das step
Attribut nicht unterstützt (siehe die Liste der unterstützten Eingabetypen in der obigen Tabelle), oder wenn der step-Wert auf any
gesetzt ist, wird eine InvalidStateError
Ausnahme ausgelöst.
stepUp()
stepUp(stepIncrement)
Parameter
stepIncrement
Optional
Ein numerischer Wert. Wenn kein Parameter übergeben wird, ist stepIncrement
standardmäÃig 1
.
Keiner (undefined
).
Klicken Sie auf die Schaltfläche in diesem Beispiel, um den number Eingabetyp zu erhöhen:
HTML<p>
<label for="theNumber">
Enter a number between 0 and 400 that is divisible by 5:
</label>
<input type="number" step="5" id="theNumber" min="0" max="400" />
</p>
<p>
<label>
Enter how many values of step you would like to increment by or leave it
blank:
</label>
<input type="number" step="1" id="incrementInput" min="0" max="25" />
</p>
<input type="button" value="Increment" id="theButton" />
JavaScript
/* make the button call the function */
const button = document.getElementById("theButton");
button.addEventListener("click", () => {
stepOnUp();
});
function stepOnUp() {
let input = document.getElementById("theNumber");
let val = document.getElementById("incrementInput").value;
if (val) {
/* increment with a parameter */
input.stepUp(val);
} else {
/* or without a parameter. Try it with 0 */
input.stepUp();
}
}
CSS
input:invalid {
border: red solid 3px;
}
Ergebnis
Beachten Sie, dass die Methode, wenn kein Parameter an die stepUp
Methode übergeben wird, standardmäÃig 1
verwendet. Jeder andere Wert ist ein Multiplikator des step
Attributwerts, der in diesem Fall 5
ist. Wenn Sie 4
als stepIncrement
übergeben, wird die Eingabe um 4 * 5
oder 20
erhöht. Wenn der Parameter 0
ist, wird die Zahl nicht erhöht. Die stepUp Methode wird nicht zulassen, dass die Eingabe den Bereich überschreitet, in diesem Fall wird sie bei 400
stoppen und übergebene FlieÃkommazahlen abrunden.
Versuchen Sie, den Schritterhöhungswert auf 1.2
zu setzen. Was passiert, wenn Sie die Methode aufrufen?
Versuchen Sie, den Wert auf 4
zu setzen, was ungültig ist. Was passiert, wenn Sie die Methode aufrufen?
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4