Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

action — destination d’un formulaire

`action` indique la destination du formulaire, mais le bouton qui l’envoie peut la remplacer avec son propre `formaction`.

Version : HTML Living Standard

Syntaxe

<form action="/save"><button formaction="/preview">Preview</button></form>

Sur form, indiquez une URL relative ou absolue valide et non vide. Une URL relative est résolue avec l’URL de base du document. En l’absence d’attribut, l’envoi utilise l’adresse du document ; une valeur vide peut agir de même sans être une valeur d’auteur conforme.

action ne choisit ni méthode HTTP, ni format, ni contexte cible : ces fonctions appartiennent à method, enctype et target. Le formaction d’un bouton d’envoi est prioritaire pour cet envoi. L’adresse ne remplace ni validation ni protection CSRF ; n’envoyez pas de secrets avec GET.

L’exemple appelle requestSubmit() avec un bouton précis. Le formulaire indique /save, mais la requête GET vise /preview?q=two+words. Le récepteur local confirme cette destination. Sans lui, une route serveur correspondante est nécessaire.

Exemples

<!doctype html><meta charset="utf-8">
<form id="form" action="/save" method="get" target="receipt">
<label>Query <input name="q" value="two words"></label>
<button id="preview" formaction="/preview">Preview</button></form>
<iframe id="receipt" name="receipt" title="Submission receipt" hidden></iframe>
<output id="result"></output>
<script>
const form = document.querySelector('form');
document.querySelector('#receipt').addEventListener('load', event => {
  const response = event.target.contentDocument.querySelector('#received');
  if (response) document.querySelector('#result').textContent = response.textContent;
});
form.requestSubmit(document.querySelector('#preview'));
</script>

Résultat

GET /preview?q=two+words

Le test observe la vraie requête et l’absence d’envoi vers `/save`, sans contacter de serveur de production.

Sources