CKTIS / HTML
onsubmit — einen Formularübermittlungsversuch behandeln
Das Attribut onsubmit legt JavaScript-Code zur Behandlung des submit-Ereignisses fest. Damit lässt sich auf einen Übermittlungsversuch reagieren und die standardmäßige Übermittlung abbrechen; es bestätigt nicht, dass Daten den Server erreicht haben.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };onsubmit ist ein Ereignisbehandlungsattribut für submit. Es wird normalerweise am Element form und nicht an der Senden-Schaltfläche platziert. Obwohl es für alle HTML-Elemente verfügbar ist, ist das Formular das Ziel dieses Ereignisses; das Ereignis wird zu den Vorfahren weitergegeben. Der Attributwert ist JavaScript-Code und nicht die Zieladresse des Formulars.
Das Ereignis tritt vor der standardmäßigen Übermittlung auf, zum Beispiel nach dem Aktivieren einer Senden-Schaltfläche oder dem Aufruf von form.requestSubmit(). Führt der Browser eine Einschränkungsvalidierung durch und besteht das Formular sie nicht, tritt submit nicht auf. Die Methode form.submit() umgeht sowohl diese Validierung als auch das submit-Ereignis.
Der Code des Attributs erhält den Parameter event. Der Aufruf von event.preventDefault() oder die Ausführung von return false bricht die standardmäßige Übermittlung ab. Dadurch wird die Ereignisweitergabe nicht gestoppt. Nur eine Funktion aufzurufen, die false zurückgibt, ohne ihren Rückgabewert mit return weiterzugeben, bricht die Übermittlung nicht ab.
JavaScript kann auch eine Funktion form.onsubmit zuweisen; eine weitere Zuweisung ersetzt die vorherige Funktion dieser Eigenschaft. Das Beispiel verwendet das Attribut, bricht die Übermittlung ab und ändert den Statustext. JavaScript muss aktiviert sein, und die Sicherheitsrichtlinie muss Inline-Ereignisbehandlungsroutinen zulassen.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsubmit demo</title>
<form onsubmit="event.preventDefault(); document.getElementById('result').textContent = 'Submission canceled';">
<button type="submit">Submit</button>
</form>
<p id="result" role="status">Ready</p>
</html>Ergebnis
Submission canceled
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.