CKTIS / HTML
Atrybut form — jawne powiązanie z formularzem
Atrybut form wskazuje formularz będący właścicielem kontrolki, nawet gdy kontrolka znajduje się poza nim. Wartością jest id formularza w tym samym drzewie, a nie jego name ani selektor CSS.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
form="form-id"Atrybut form="form-id" jawnie określa formularz będący właścicielem elementu. Wartość musi odpowiadać id elementu form w tym samym drzewie; nie dodawaj #. Powiązanie nie przenosi elementu w DOM i pozwala umieścić kontrolkę poza formularzem.
Atrybut obsługują button, fieldset, input, object, output, select, textarea oraz niestandardowe elementy powiązane z formularzem. Nie jest to atrybut globalny. Samo powiązanie nie oznacza, że element przekazuje wartość podczas wysyłania formularza: na przykład fieldset i output tego nie robią.
Bez tego atrybutu właścicielem jest zwykle najbliższy przodek form. Przy ponownym ustalaniu właściciela identyfikator podany w atrybucie jest wyszukiwany tylko wtedy, gdy element jest połączony z dokumentem. W takim przypadku, jeśli wyszukiwanie nie wskaże formularza, element pozostaje bez właściciela i nie jest wiązany z formularzem-przodkiem. Pusta wartość nie przywraca wtedy domyślnego powiązania — usuń atrybut. W poddrzewie odłączonym od dokumentu element może nadal zostać powiązany z najbliższym przodkiem form, nawet jeśli atrybut nie wskazuje żadnego formularza. Stosuj unikalne identyfikatory.
Atrybut nie jest dziedziczony: form na fieldset nie przypisuje automatycznie jego kontrolek do wskazanego formularza. Wbudowane elementy obsługujące ten atrybut udostępniają właściwość .form, która zwraca formularz albo null. W przykładzie zewnętrzny input należy do order, występuje w order.elements, a jego wartość trafia do FormData(order).
Przykłady
<!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>Wynik
true true book
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.