WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

`value` und `disabled` bei `input` und `textarea`

Lies und ändere den Wert eines Formularfelds unabhängig davon, ob es bedienbar ist. Unterscheide das eigene Attribut `disabled` vom tatsächlichen Zustand und prüfe, welche Werte in die Formulardaten gelangen.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

control.value          // read a string
control.value = text   // write a string; input.type determines the rules
control.disabled       // read the element's own disabled attribute as a boolean
control.disabled = true
control.disabled = false
control.matches(':disabled') // test whether the control is actually disabled

HTMLInputElement und HTMLTextAreaElement sind DOM-Schnittstellen des HTML-Standards, keine Bestandteile von ECMAScript 2024. Bei Texteingabefeldern und textarea liest und setzt value die aktuelle Zeichenkette. Bei textarea normalisiert value Zeilenumbrüche zu LF (\n). Der Standardwert (defaultValue) stammt aus dem value-Attribut von input beziehungsweise dem Textinhalt von textarea. Nach einer Benutzereingabe oder einer Zuweisung an value überschreibt eine Änderung des Standardwerts den aktuellen Wert nicht mehr. Beim Zurücksetzen des Formulars wird der aktuelle Wert aus dem Standardwert abgeleitet. Bei input wendet der Browser zusätzlich den Algorithmus zur Wertbereinigung an, sofern der Typ einen solchen definiert. Bei type="text" entfernt der Browser beim Zurücksetzen beispielsweise Zeilenumbrüche aus value, auch wenn sie in defaultValue enthalten sind.

Bei input bestimmt type das Verhalten von value. Im Wertmodus, etwa bei text und number, kann der Browser den zugewiesenen Text nach den Regeln des Typs umwandeln oder leeren; auch number liefert eine Zeichenkette. Bei hidden spiegelt value das Attribut value und liefert '', wenn es fehlt. Bei checkbox und radio gilt dasselbe, aber der Ersatzwert ist 'on'; den Auswahlzustand liefert checked. Bei file verrät value nicht den echten Pfad: Verwende files. '' leert die Auswahl, eine nichtleere Zeichenkette löst InvalidStateError aus.

Die boolesche Eigenschaft disabled spiegelt nur das eigene Attribut: true fügt es hinzu, false entfernt es. In HTML deaktiviert selbst disabled="false" das Feld, denn die Anwesenheit des Attributs zählt. Ein Feld mit disabled === false kann durch ein übergeordnetes deaktiviertes fieldset dennoch deaktiviert sein. Ausgenommen sind Felder innerhalb seines ersten legend-Kindelements. Prüfe den tatsächlichen Zustand mit control.matches(':disabled').

Ein deaktiviertes Feld kann keinen Fokus erhalten und nicht vom Benutzer bearbeitet werden. Es ist von der Prüfung der Formularbedingungen ausgeschlossen und fehlt beim Absenden sowie in new FormData(form). Skripte können value weiterhin lesen und setzen; die Zuweisung allein löst weder input noch change aus. Verwende, wo unterstützt, readOnly, wenn das Feld fokussierbar, aber nicht bearbeitbar bleiben soll. readOnly allein schließt es nicht vom Absenden aus. Keiner der Zustände ersetzt serverseitige Validierung oder Autorisierung.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form control value and disabled state</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement('form');
  const group = document.createElement('fieldset');
  const input = document.createElement('input');
  const textarea = document.createElement('textarea');
  input.type = 'text';
  input.name = 'title';
  textarea.name = 'note';
  group.append(input);
  form.append(group, textarea);

  group.disabled = true;
  input.value = 'Draft';
  textarea.value = 'Line 1\r\nLine 2';
  console.log(JSON.stringify([input.value, input.disabled, input.matches(':disabled')]));
  console.log(JSON.stringify([...new FormData(form)]));

  group.disabled = false;
  textarea.disabled = true;
  console.log(JSON.stringify([...new FormData(form)]));
})();
</script>
</body>
</html>

Ergebnis

["Draft",false,true]
[["note","Line 1\nLine 2"]]
[["title","Draft"]]

Speichere das Beispiel als HTML-Datei, öffne sie im Browser und sieh dir die Browserkonsole an. Die erste Zeile zeigt, dass sich `Draft` zuweisen lässt, obwohl das Feld tatsächlich deaktiviert ist und sein eigenes `disabled` den Wert `false` hat. Die nächsten Zeilen zeigen die Formulardaten vor und nach dem Zustandswechsel; in JSON steht `\n` für LF.

Zugehörige Lektionen

  • JavaScript · Lektion 4 · Fortgeschritten · Version: 4

Quellen