WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onreset — Zurücksetzen von Formularen behandeln

Das Attribut onreset enthält JavaScript-Code zur Behandlung des reset-Ereignisses eines Formulars. Der Handler wird ausgeführt, bevor Standardwerte wiederhergestellt werden, und kann das Zurücksetzen abbrechen.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

onreset="JavaScript code"

onreset ist ein HTML-Ereignisbehandlerattribut für das Ereignis reset. Sein Wert ist JavaScript-Code, kein Ereignisname und kein boolescher Wert. Es wird meist auf einem Formular verwendet; das Ereignis steigt in der DOM-Hierarchie auf, sodass auch ein übergeordnetes Element darauf reagieren kann.

Beim Zurücksetzen über eine Schaltfläche mit type="reset" oder über form.reset() wird zuerst ein abbrechbares reset-Ereignis am Formular ausgelöst. Erst danach werden die Steuerelemente auf ihren Standardzustand zurückgesetzt – dieser besteht nicht unbedingt aus leeren Werten. Während der Behandlung kann der Handler noch die Werte von vor dem Zurücksetzen lesen.

Im Attributcode verweist event auf das Ereignis und this auf das Element, das den Handler ausführt. event.preventDefault() oder return false bricht das Zurücksetzen ab. Ein alleinstehendes return false stoppt die Ereignisausbreitung nicht.

Das Attribut onreset und die JavaScript-Eigenschaft form.onreset richten denselben einzelnen Handler ein. Alternativ ermöglicht form.addEventListener('reset', handler) die unabhängige Registrierung mehrerer Handler. Eine CSP-Richtlinie kann Attributcode blockieren; das Beispiel setzt voraus, dass seine Ausführung erlaubt ist.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onreset example</title>
<form id="demo" onreset="document.getElementById('log').textContent += 'during reset: ' + this.elements.namedItem('nickname').value + '\n';">
  <label>Nickname <input name="nickname" value="Ada"></label>
  <button type="reset">Reset</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.getElementById('demo');
  const field = form.elements.namedItem('nickname');
  field.value = 'Grace';
  form.reset();
  document.getElementById('log').textContent += 'after reset: ' + field.value;
</script>
</html>

Ergebnis

during reset: Grace
after reset: Ada

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.

Quellen