CKTIS / HTML
Atribut form — izričito povezivanje s obrascem
Atribut form određuje obrazac kojem kontrola pripada, čak i kada se nalazi izvan njega. Njegova je vrijednost id obrasca u istom stablu, a ne njegov name ili CSS selektor.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
form="form-id"Atribut form="form-id" izričito određuje obrazac kojem element pripada. Njegova vrijednost mora odgovarati id atributu elementa form u istom stablu; nemojte dodavati #. Povezivanje ne premješta element u DOM-u i omogućuje smještanje kontrole izvan obrasca.
Atribut podržavaju elementi button, fieldset, input, object, output, select, textarea i prilagođeni elementi povezani s obrascima. Nije globalni atribut. Samo povezivanje ne znači da element daje vrijednost pri slanju obrasca: primjerice, fieldset i output to ne čine.
Bez ovog atributa element obično pripada najbližem pretku form. Pri ponovnom određivanju obrasca kojem element pripada ID iz atributa traži se samo ako je element povezan s dokumentom. Ako se u tom slučaju ne pronađe odgovarajući obrazac, element ostaje bez vlasnika i ne povezuje se s obrascem među svojim precima. Prazna vrijednost tada ne vraća zadano povezivanje — uklonite atribut. U podstablu odvojenom od dokumenta element se ipak može povezati s najbližim pretkom form, čak i ako atribut ne određuje nijedan obrazac. Upotrebljavajte jedinstvene ID-jeve.
Atribut se ne nasljeđuje: postavljanje atributa form na element fieldset ne povezuje automatski njegove kontrole s navedenim obrascem. Ugrađeni elementi koji podržavaju ovaj atribut izlažu svojstvo .form, koje vraća obrazac ili null. U primjeru vanjski input pripada obrascu order, nalazi se u order.elements i daje svoju vrijednost objektu FormData(order).
Primjeri
<!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>Rezultat
true true book
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.