CKTIS / HTML
Atributo form — asociación explícita con un formulario
El atributo form identifica el formulario propietario de un control, aunque el control esté fuera de él. Su valor es el id del formulario en el mismo árbol, no su name ni un selector CSS.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
form="form-id"El atributo form="form-id" identifica explícitamente el formulario propietario de un elemento. Su valor debe coincidir con el id de un elemento form del mismo árbol; no añadas #. La asociación no mueve el elemento en el DOM y permite colocar un control fuera de su formulario.
El atributo es compatible con button, fieldset, input, object, output, select, textarea y los elementos personalizados asociados a formularios. No es un atributo global. La asociación por sí sola no significa que un elemento aporte un valor al enviar el formulario: por ejemplo, fieldset y output no lo hacen.
Sin este atributo, el propietario suele ser el elemento form antecesor más cercano. Cuando se vuelve a determinar el formulario propietario, el ID indicado en el atributo solo se busca si el elemento está conectado a un documento. En ese caso, si la búsqueda no identifica un formulario, el elemento se queda sin propietario en vez de asociarse con el formulario antecesor. Un valor vacío no restablece entonces la asociación predeterminada: elimina el atributo. En un subárbol desconectado del documento, el elemento aún puede asociarse con el elemento form antecesor más cercano, aunque el atributo no identifique ningún formulario. Usa identificadores únicos.
El atributo no se hereda: establecer form en un fieldset no asigna automáticamente sus controles al formulario indicado. Los elementos integrados que admiten este atributo exponen una propiedad .form, que devuelve el formulario o null. En el ejemplo, el input externo pertenece a order, aparece en order.elements y aporta su valor a FormData(order).
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Explicit form association</title>
<form id="order"></form>
<label>Item <input id="item" name="item" value="book" form="order"></label>
<pre id="result"></pre>
<script>
const order = document.getElementById('order');
const item = document.getElementById('item');
document.getElementById('result').textContent = [
item.form === order,
order.elements.namedItem('item') === item,
new FormData(order).get('item')
].join('\n');
</script>
</html>Resultado
true true book
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.