CKTIS / HTML
formenctype — formato de datos para un botón de envío concreto
El atributo formenctype permite que un botón de envío sobrescriba el enctype del formulario. Selecciona el formato de datos de la solicitud POST solo cuando el formulario se envía con ese botón.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"formenctype especifica el formato de datos que utiliza un botón de envío concreto de un formulario. Se aplica a un button que actúa como botón de envío y a input con type="submit" o type="image". En el caso de button, conviene establecer explícitamente type="submit". La sobrescritura solo afecta al envío mediante ese botón; no cambia el atributo enctype del formulario.
Los valores permitidos son application/x-www-form-urlencoded (pares nombre-valor codificados con porcentajes), multipart/form-data (partes separadas que pueden contener archivos) y text/plain (un formato legible pero ambiguo, inadecuado para un análisis fiable).
Si se omite formenctype, se usa el enctype del formulario asociado. En cambio, un valor vacío o no válido selecciona application/x-www-form-urlencoded, en lugar de volver a la configuración del formulario. Si el formulario también omite enctype, su formato predeterminado es application/x-www-form-urlencoded.
Al enviar por HTTP, este formato controla el cuerpo de la solicitud POST; no cambia el método a POST. Con GET, los datos se incluyen en la URL usando application/x-www-form-urlencoded, independientemente de formenctype. En JavaScript, la propiedad correspondiente se llama formEnctype. El ejemplo cancela el envío y muestra el formato seleccionado sin realizar una solicitud.
Ejemplos
<!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.
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.