KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

formaction — indienings-URL voor een knop

Het formaction-attribuut vervangt de action van een formulier wanneer een bepaalde knop het indienen start. Zo kan hetzelfde formulier naar verschillende URL’s worden verzonden zonder de standaardbestemming van het formulier te wijzigen.

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

Syntax

<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">

formaction geeft de indienings-URL op voor een specifieke verzendknop: een button waarmee het formulier wordt verzonden, of een input met type="submit" of type="image". Het attribuut hoort niet op een gewone knop of een resetknop.

Als de knop waarmee het formulier wordt verzonden formaction heeft, vervangt de waarde daarvan de action van het bijbehorende formulier, maar alleen voor die indiening. Zonder dit attribuut geldt de action van het formulier. De waarde moet een geldige, niet-lege URL zijn; een relatieve URL is toegestaan.

Het attribuut verandert de bestemming, niet de HTTP-methode, codering of validatieregels. In het voorbeeld heeft het formulier geen method-attribuut, dus GET is de standaardmethode. De handler voor het submit-event annuleert de verzending en logt alleen de knoptekst en het fragment van de geselecteerde URL: #publish voor Publish en #preview voor Preview. Het voorbeeld verstuurt geen GET-verzoek.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Button-specific form action</title>
</head>
<body>
  <h1>Choose a form action</h1>
  <form id="editor" action="#publish">
    <button type="submit">Publish</button>
    <button type="submit" formaction="#preview">Preview</button>
  </form>
  <p id="publish">Local publish destination.</p>
  <p id="preview">Local preview destination.</p>
  <script>
    const form = document.getElementById('editor');
    form.addEventListener('submit', event => {
      event.preventDefault();
      const button = event.submitter;
      const action = button.hasAttribute('formaction') ? button.formAction : form.action;
      console.log(`${button.textContent}: ${new URL(action).hash}`);
    });
    for (const button of form.querySelectorAll('button')) {
      form.requestSubmit(button);
    }
  </script>
</body>
</html>

Resultaat

Publish: #publish
Preview: #preview

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