CKTIS / HTML
formenctype — formato dei dati per uno specifico pulsante di invio
L’attributo formenctype permette a un pulsante di invio di sostituire l’enctype del modulo. Seleziona il formato dei dati della richiesta POST solo quando il modulo viene inviato con quel pulsante.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"formenctype specifica il formato dei dati usato da uno specifico pulsante di invio di un modulo. Si applica a un button che funge da pulsante di invio e a input con type="submit" o type="image". Per button è utile impostare esplicitamente type="submit". La sostituzione riguarda solo l’invio tramite quel pulsante; non modifica l’attributo enctype del modulo.
I valori consentiti sono application/x-www-form-urlencoded (coppie nome-valore codificate con percentuali), multipart/form-data (parti separate che possono contenere file) e text/plain (un formato leggibile ma ambiguo, inadatto a un’analisi affidabile).
Se formenctype è omesso, viene usato l’enctype del modulo associato. Un valore vuoto o non valido seleziona invece application/x-www-form-urlencoded, anziché ripristinare l’impostazione del modulo. Se anche il modulo omette enctype, il formato predefinito è application/x-www-form-urlencoded.
Durante l’invio HTTP, questo formato controlla il corpo della richiesta POST; non cambia il metodo in POST. Con GET, i dati vengono inseriti nell’URL usando application/x-www-form-urlencoded, indipendentemente da formenctype. In JavaScript, la proprietà corrispondente si chiama formEnctype. L’esempio annulla l’invio e mostra il formato selezionato senza effettuare una richiesta.
Esempi
<!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>Risultato
Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.