Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

formenctype — formato dos dados para um botão de submissão específico

O atributo formenctype permite que um botão de submissão substitua o enctype do formulário. Seleciona o formato dos dados do pedido POST apenas quando o formulário é submetido com esse botão.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"

formenctype especifica o formato dos dados utilizado por um botão de submissão específico de um formulário. Aplica-se a um button que funciona como botão de submissão e a input com type="submit" ou type="image". Para button, é útil definir explicitamente type="submit". A substituição só afeta a submissão feita através desse botão; não altera o atributo enctype do formulário.

Os valores permitidos são application/x-www-form-urlencoded (pares nome-valor codificados em percentagem), multipart/form-data (partes separadas que podem transportar conteúdo de ficheiros) e text/plain (um formato legível, mas ambíguo, inadequado para análise fiável).

Se formenctype for omitido, é utilizado o enctype do formulário associado. Um valor vazio ou inválido seleciona, em vez disso, application/x-www-form-urlencoded, não retomando a definição do formulário. Se o formulário também omitir enctype, o formato predefinido é application/x-www-form-urlencoded.

Num envio HTTP, este formato controla o corpo do pedido POST; não altera o método para POST. Com GET, os dados são incluídos no URL usando application/x-www-form-urlencoded, independentemente de formenctype. Em JavaScript, a propriedade correspondente chama-se formEnctype. O exemplo cancela a submissão e apresenta o formato selecionado sem fazer um pedido.

Exemplos

<!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>

Resultado

Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes