CKTIS / HTML
form-Attribut — explizite Formularzuordnung
Das form-Attribut bestimmt das Formular, zu dem ein Steuerelement gehört, auch wenn es sich außerhalb dieses Formulars befindet. Sein Wert ist die id des Formulars im selben Baum, nicht dessen name oder ein CSS-Selektor.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
form="form-id"Das Attribut form="form-id" legt ausdrücklich fest, zu welchem Formular ein Element gehört. Sein Wert muss mit der id eines form-Elements im selben Baum übereinstimmen; füge kein # hinzu. Die Zuordnung verschiebt das Element nicht im DOM und ermöglicht es, ein Steuerelement außerhalb seines Formulars zu platzieren.
Unterstützt wird das Attribut von button, fieldset, input, object, output, select, textarea und formulargebundenen benutzerdefinierten Elementen. Es ist kein globales Attribut. Die Zuordnung allein bedeutet nicht, dass ein Element beim Absenden des Formulars einen Wert beiträgt: fieldset und output tun das beispielsweise nicht.
Ohne dieses Attribut gehört das Element normalerweise zum nächstgelegenen form-Vorfahren. Wird die Formularzuordnung neu bestimmt, wird nur dann nach der im Attribut angegebenen ID gesucht, wenn das Element mit einem Dokument verbunden ist. Ergibt die Suche in diesem Fall kein Formular, bleibt das Element ohne Zuordnung, statt dem form-Vorfahren zugeordnet zu werden. Ein leerer Wert stellt dann die Standardzuordnung nicht wieder her — entferne stattdessen das Attribut. In einem nicht mit dem Dokument verbundenen Teilbaum kann das Element weiterhin dem nächstgelegenen form-Vorfahren zugeordnet werden, auch wenn das Attribut kein Formular bezeichnet. Verwende eindeutige IDs.
Das Attribut wird nicht vererbt: Ein form-Attribut auf einem fieldset ordnet dessen Steuerelemente nicht automatisch dem angegebenen Formular zu. Integrierte Elemente, die dieses Attribut unterstützen, stellen eine .form-Eigenschaft bereit, die das Formular oder null zurückgibt. Im Beispiel gehört das externe input zu order, erscheint in order.elements und steuert seinen Wert zu FormData(order) bei.
Beispiele
<!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>Ergebnis
true true book
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.