CKTIS / HTML
form — formulario HTML
El elemento form asocia controles con un formulario y define cómo se envían sus datos. Admite el envío y la validación nativos; JavaScript puede interceptar el envío.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<form action="/search" method="get">…</form>form representa un formulario cuyos controles pueden proporcionar datos para procesarlos. Se necesitan las etiquetas de apertura y cierre; los formularios no deben anidarse. Los controles compatibles que estén fuera del formulario se pueden asociar a él mediante un atributo form que haga referencia a su id.
action indica el destino. method="get" (el valor predeterminado) incluye los datos en la consulta de la URL, mientras que method="post" los incluye en el cuerpo de la solicitud. Para subir archivos mediante POST, usa enctype="multipart/form-data". POST por sí solo no proporciona cifrado.
Las claves de los datos proceden de name, no de id. Se omiten los controles deshabilitados y las casillas sin marcar. Por lo general también se omiten los controles sin nombre, pero si se usa un botón de envío de tipo imagen (<input type="image">) sin nombre para enviar el formulario, este añade las coordenadas como entradas con las claves x e y. Asocia las etiquetas con los campos. La validación del navegador ayuda a los usuarios, pero no sustituye la validación en el servidor.
En un envío normal, la validación interactiva se realiza antes de que se dispare el evento submit, salvo que se omita. Si la validación falla, se detiene el envío y no se dispara el evento submit. El atributo novalidate omite la validación interactiva. En los scripts, es preferible requestSubmit(): a diferencia de submit(), conserva la validación y el evento submit.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML form example</title>
</head>
<body>
<form id="search" method="get">
<label for="query">Query</label>
<input id="query" name="q" value="html" required>
<button id="submit-query" type="submit">Submit query</button>
</form>
<output id="result" for="query" aria-live="polite"></output>
<script>
const form = document.getElementById('search');
const submitButton = document.getElementById('submit-query');
const result = document.getElementById('result');
form.addEventListener('submit', (event) => {
event.preventDefault();
const data = new FormData(form);
result.value = 'q=' + data.get('q');
console.log(result.value);
});
form.requestSubmit(submitButton);
</script>
</body>
</html>Resultado
q=html
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.