CKTIS / HTML
method — méthode d’envoi du formulaire
L’attribut method de l’élément form choisit get, post ou dialog. Il détermine comment les données du formulaire sont envoyées, ou ferme une boîte de dialogue au lieu d’effectuer une requête réseau.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<form method="get|post|dialog">…</form>L’attribut method de l’élément form détermine la manière dont l’envoi du formulaire est traité. Ses valeurs autorisées sont get, post et dialog. Si l’attribut est omis ou reçoit une valeur invalide, y compris une chaîne vide ou put, l’état GET est sélectionné.
Pour les destinations HTTP(S), get place les données encodées du formulaire dans la requête de l’URL, tandis que post les envoie dans le corps de la requête. L’attribut action indique la destination ; enctype spécifie l’encodage du corps pour post.
La valeur dialog ferme l’élément dialog ancêtre le plus proche sans envoyer de données sur le réseau. En l’absence d’un tel ancêtre, l’envoi n’a pas lieu. La validation peut encore empêcher cette opération. Dans l’exemple, le bouton définit returnValue de la boîte de dialogue sur ok.
Un attribut formmethod sur le bouton d’envoi utilisé remplace le method du formulaire. S’il est absent, le paramètre du formulaire s’applique ; un formmethod invalide sélectionne GET au lieu d’hériter du paramètre.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>method demo</title>
<dialog id="choice">
<form method="dialog">
<button type="submit" value="ok">OK</button>
</form>
</dialog>
<pre id="result">waiting</pre>
<script>
const choice = document.getElementById('choice');
const result = document.getElementById('result');
choice.addEventListener('close', () => {
result.textContent = `returnValue=${choice.returnValue}`;
});
choice.showModal();
</script>
</html>Résultat
returnValue=ok
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.