CKTIS / HTML
formenctype — format des données pour un bouton d’envoi donné
L’attribut formenctype permet à un bouton d’envoi de remplacer l’enctype du formulaire. Il sélectionne le format des données de la requête POST uniquement lorsque le formulaire est envoyé avec ce bouton.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"formenctype indique le format des données utilisé par un bouton d’envoi donné d’un formulaire. Il s’applique à un button utilisé comme bouton d’envoi ainsi qu’à input avec type="submit" ou type="image". Pour button, il est utile de définir explicitement type="submit". Cette substitution ne concerne que l’envoi effectué avec ce bouton ; elle ne modifie pas l’attribut enctype du formulaire.
Les valeurs autorisées sont application/x-www-form-urlencoded (des paires nom-valeur encodées en pourcentage), multipart/form-data (des parties distinctes pouvant contenir des fichiers) et text/plain (un format lisible mais ambigu, qui ne convient pas à une analyse fiable).
Si formenctype est omis, l’enctype du formulaire associé est utilisé. Une valeur vide ou invalide sélectionne plutôt application/x-www-form-urlencoded au lieu de reprendre le réglage du formulaire. Si le formulaire omet lui aussi enctype, son format par défaut est application/x-www-form-urlencoded.
Lors d’un envoi HTTP, ce format détermine le corps de la requête POST ; il ne change pas la méthode en POST. Avec GET, les données sont placées dans l’URL selon application/x-www-form-urlencoded, quel que soit formenctype. En JavaScript, la propriété correspondante s’appelle formEnctype. L’exemple annule l’envoi et affiche le format sélectionné sans effectuer de requête.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>formenctype demo</title>
<form id="demo" method="post" enctype="application/x-www-form-urlencoded">
<input name="message" value="hello world" aria-label="Message">
<button type="submit">Default</button>
<button type="submit" formenctype="multipart/form-data">Multipart</button>
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('demo');
const result = document.getElementById('result');
form.addEventListener('submit', (event) => {
event.preventDefault();
const button = event.submitter;
result.textContent = button && button.hasAttribute('formenctype')
? button.formEnctype
: form.enctype;
});
</script>
</html>Résultat
Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.
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.