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.