CKTIS / HTML
formmethod — méthode d’envoi pour un bouton
L’attribut formmethod choisit la méthode d’envoi du formulaire pour un bouton d’envoi donné. Il accepte get, post et dialog, et remplace l’attribut method du formulaire lors d’un envoi déclenché par ce bouton.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
formmethod="get|post|dialog"formmethod s’applique aux boutons d’envoi : aux éléments button qui remplissent ce rôle et aux éléments input avec type="submit" ou type="image". Un élément button peut servir de bouton d’envoi même si l’attribut type est omis ; il n’est pas nécessaire d’indiquer explicitement type="submit". L’attribut formmethod agit sur l’envoi déclenché par ce bouton sans modifier l’attribut method du formulaire.
get envoie les données dans l’URL, tandis que post les envoie dans le corps de la requête HTTP. dialog ferme l’élément dialog ancêtre du formulaire au lieu d’envoyer les données ; en l’absence d’un tel ancêtre, aucun envoi n’a lieu.
Si formmethod est omis, la valeur method du formulaire associé est utilisée. Une valeur invalide, y compris une chaîne vide, sélectionne plutôt get, et non la méthode du formulaire. Si le formulaire n’a pas lui-même d’attribut method, sa valeur par défaut est get.
Dans l’exemple, formmethod="dialog" remplace method="post". Un clic sur Close ferme la boîte de dialogue sans envoyer de requête de formulaire et définit son returnValue sur done, la valeur du bouton.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>formmethod</title>
<dialog id="demo">
<form method="post">
<button type="submit" formmethod="dialog" value="done">Close</button>
</form>
</dialog>
<output id="result">waiting</output>
<script>
const demo = document.getElementById('demo');
const result = document.getElementById('result');
demo.addEventListener('close', () => {
result.textContent = demo.returnValue;
});
demo.showModal();
</script>Résultat
done
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.