CKTIS / HTML
formaction — URL de soumission d’un bouton
L’attribut formaction remplace l’action d’un formulaire lorsqu’un bouton particulier déclenche sa soumission. Il permet d’envoyer le même formulaire vers différentes URL sans modifier sa destination par défaut.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">formaction définit l’URL de soumission pour un bouton d’envoi particulier : un button qui soumet le formulaire, ou un input dont le type est submit ou image. Il ne doit pas être placé sur un bouton ordinaire ni sur un bouton de réinitialisation.
Si le bouton qui soumet le formulaire possède formaction, sa valeur remplace l’action du formulaire associé pour cette soumission uniquement. Sans cet attribut, l’action du formulaire s’applique. La valeur doit être une URL valide et non vide ; une URL relative est autorisée.
L’attribut modifie la destination, pas la méthode HTTP, l’encodage ni les règles de validation. Dans l’exemple, le formulaire ne comporte pas d’attribut method : GET est donc la méthode par défaut. Le gestionnaire de l’événement submit annule la soumission et affiche dans la console uniquement le libellé du bouton et le fragment de l’URL sélectionnée : #publish pour Publish et #preview pour Preview. L’exemple n’envoie aucune requête GET.
Exemples
<!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>Résultat
Publish: #publish Preview: #preview
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.