Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti