HOWTO · JavaScript
Eingabewert in JavaScript ändern
Um den aktuellen Wert eines Eingabefelds zu ändern, weisen Sie der `value`-Eigenschaft einen Wert zu. Mit `setAttribute()` ändern Sie dagegen das Inhaltsattribut und damit den Standardwert.
Auf dieser Seite
Um den aktuellen Inhalt eines HTML-Texteingabefelds zu ändern, wählen Sie das gewünschte Element aus und weisen seiner value-Eigenschaft eine Zeichenfolge zu. Dadurch ändert sich der aktuelle Wert, den das Steuerelement anzeigt. Das unterscheidet sich von einer Änderung des value-Inhaltsattributs, das den Standardwert des Steuerelements festlegt.
Den aktuellen Wert des Eingabefelds mit der value-Eigenschaft ändern
Dieses Markup weist dem Eingabefeld beispielsweise eine ID und einen Anfangswert zu. Die Codebeispiele und die darin angezeigten Bezeichnungen oder Ausgaben bleiben auf Englisch:
<input type="text" id="user-name" value="Some Value">
Wählen Sie das Element auf einer Browserseite mit document.getElementById("user-name") aus und weisen Sie ihm anschließend mit input.value = "New value" den neuen Text zu. Dadurch ändert sich der aktuelle Wert; das ursprüngliche HTML-Attribut wird nicht neu geschrieben. Dieselbe Eigenschaft wird verwendet, wenn jemand Text in das Eingabefeld eingibt.
Das folgende eigenständige JavaScript-Beispiel veranschaulicht diese Zuweisung. Ein kleines Objekt ermöglicht es, den Eigenschaftszugriff auch außerhalb eines Browsers auszuführen. Im Seitencode ist input stattdessen das ausgewählte Eingabeelement.
const input = { value: "Some Value" };
input.value = "New value";
console.log(input.value);
Das eigenständige JavaScript-Beispiel gibt Folgendes aus. Die angezeigte Ausgabe New value bleibt im Beispiel auf Englisch:
New value
Das Eingabeelement auswählen
Verwenden Sie getElementById(), wenn das Eingabefeld eine eindeutige ID hat. Die Methode gibt das Element mit dieser ID oder null zurück, falls kein solches Element vorhanden ist. Prüfen Sie das Ergebnis daher vor der Zuweisung, wenn das Element möglicherweise fehlt. Im Seitencode können Sie beispielsweise const input = document.getElementById("user-name"); verwenden und anschließend if (input) input.value = "New value"; ausführen.
Verwenden Sie querySelector(), wenn sich das Eingabefeld mit einem CSS-Selektor finden lässt, etwa mit document.querySelector('input[name="userName"]'). Die Methode gibt das erste passende Element oder null zurück, wenn es keine Übereinstimmung gibt. Formulieren Sie den Selektor so präzise, dass er das gewünschte Steuerelement findet, besonders wenn eine Seite mehrere Eingabefelder enthält. Die Selektorbeispiele hier sind für eine Browserseite gedacht und keine eigenständig ausführbaren Programme.
Ein Formular lässt sich auch über die Sammlung document.forms ansprechen. Bei einem Formular namens profile mit einem Steuerelement namens userName kann der Seitencode auf document.forms["profile"].elements["userName"] zugreifen. Das setzt voraus, dass diese Namen vorhanden sind. Dieser Zugriff ist praktisch, wenn Sie mit einem bekannten Formular arbeiten; für die allgemeine Suche nach Elementen ist eine ID oder ein CSS-Selektor oft klarer. document.forms ist eine Sammlung und keine Funktion.
setAttribute() und den Standardwert verstehen
Die value-Eigenschaft eines Eingabefelds steht für seinen aktuellen Wert. Das value-Inhaltsattribut liefert den Standardwert, der über die Eigenschaft defaultValue verfügbar ist. Der Aufruf setAttribute("value", "New default") ändert dieses Attribut und den Standardwert. Wenn Sie ändern möchten, was die Person gerade im Eingabefeld sieht, ist das kein allgemeiner Ersatz für eine Zuweisung an input.value. Insbesondere bedeutet eine Änderung des Standardwerts nicht, dass auch der aktuelle Wert als geändert gelten sollte, wenn dieser zuvor über die Eigenschaft oder durch eine Nutzereingabe geändert wurde.
Verwenden Sie input.value = "New value", um den aktuellen Wert unmittelbar zu ändern. Verwenden Sie input.setAttribute("value", "New default"), wenn Sie den im Markup festgelegten Standardwert ändern möchten. Die Operationen haben ähnliche Namen, zielen aber auf unterschiedliche Werte. Wählen Sie die passende Methode danach aus, ob es um den aktuellen Zustand des Steuerelements oder seinen Standardwert geht.
Das Ergebnis überprüfen und eine Methode auswählen
Lesen Sie nach der Auswahl des Eingabefelds input.value aus, um den aktuellen Wert zu prüfen. Hat sich der Wert nicht geändert, prüfen Sie zuerst, ob der Selektor das gewünschte Element gefunden hat und ob die Zuweisung ausgeführt wurde, nachdem das Eingabefeld auf der Seite verfügbar war. Wenn getElementById() oder querySelector() kein Element findet, ist das Ergebnis null. Eine Zuweisung über diesen Wert schlägt fehl; sichern Sie die Abfrage daher mit einer Prüfung ab. Vergewissern Sie sich außerdem, dass der Code der Eigenschaft einen Wert zuweist und nicht nur das Standardattribut ändert.
Für eine direkte Änderung wählen Sie das Eingabefeld über eine eindeutige ID mit getElementById() oder über einen passenden CSS-Selektor mit querySelector() aus und weisen dann value einen Wert zu. Verwenden Sie document.forms, wenn Ihnen die Namen des Formulars und des Steuerelements bekannt sind. Verwenden Sie setAttribute() nur, wenn Sie tatsächlich das Standard- beziehungsweise Inhaltsattribut ändern möchten. Der Unterschied zwischen dem aktuellen Wert und dem Standardwert erklärt, warum eine Attributänderung den angezeigten Text möglicherweise nicht wie erwartet aktualisiert.