KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onsubmit — een poging om een formulier te verzenden afhandelen

Het attribuut onsubmit geeft JavaScript-code op die het submit-event afhandelt. Hiermee kunt u reageren op een poging om een formulier te verzenden en de standaardverzending annuleren; het bevestigt niet dat gegevens de server hebben bereikt.

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

Syntax

onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };

onsubmit is een event-handlerattribuut voor submit. Het wordt normaal gesproken op het element form geplaatst, niet op de verzendknop. Hoewel het beschikbaar is op alle HTML-elementen, is het formulier het doel van dit event; het event bubbelt naar bovenliggende elementen. De attribuutwaarde is JavaScript-code, niet het bestemmingsadres van het formulier.

Het event treedt op vóór de standaardverzending, bijvoorbeeld nadat een verzendknop is geactiveerd of form.requestSubmit() is aangeroepen. Als de browser constraintvalidatie uitvoert en het formulier daarvoor niet slaagt, treedt submit niet op. De methode form.submit() omzeilt zowel die validatie als het submit-event.

De code van het attribuut ontvangt de parameter event. Het aanroepen van event.preventDefault() of uitvoeren van return false annuleert de standaardverzending. Dit stopt de eventpropagatie niet. Alleen een functie aanroepen die false retourneert, zonder de uitkomst met return door te geven, annuleert de verzending niet.

JavaScript kan ook een functie toewijzen aan form.onsubmit; een volgende toewijzing vervangt de eerdere functie voor die eigenschap. Het voorbeeld gebruikt het attribuut, annuleert de verzending en wijzigt de statustekst. JavaScript moet ingeschakeld zijn en het beveiligingsbeleid moet inline event handlers toestaan.

Voorbeelden

<!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>

Resultaat

Submission canceled

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen