1. Web
  2. Web-APIs
  3. HTMLInputElement
  4. stepUp()

Dieser Inhalt wurde automatisch aus dem Englischen ΓΌbersetzt, und kann Fehler enthalten. Erfahre mehr ΓΌber dieses Experiment.

View in English Always switch to English

HTMLInputElement: stepUp() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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.

Input-Typ Standardwert fΓΌr Step Beispiel fΓΌr Step-Deklaration
date 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.

Syntax

js
stepUp()
stepUp(stepIncrement)

Parameter

stepIncrement Optional

Ein numerischer Wert. Wenn kein Parameter übergeben wird, ist stepIncrement standardmÀßig 1.

RΓΌckgabewert

Keiner (undefined).

Beispiele

Klicken Sie auf die SchaltflΓ€che in diesem Beispiel, um den number Eingabetyp zu erhΓΆhen:

HTML

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

js
/* 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

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?

Spezifikationen

Specification
HTML
# dom-input-stepup-dev

Browser-KompatibilitΓ€t

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen ΓΌbersetzt.
Übersetzung auf GitHub anzeigen β€’ Fehler mit dieser Übersetzung melden