CKTIS / HTML
Atribut form — explicitní přiřazení k formuláři
Atribut form určuje formulář, ke kterému ovládací prvek patří, i když se nachází mimo něj. Jeho hodnota je id formuláře ve stejném stromu, nikoli jeho name ani CSS selektor.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
form="form-id"Atribut form="form-id" výslovně určuje, ke kterému formuláři prvek patří. Jeho hodnota se musí shodovat s id prvku form ve stejném stromu; nepřidávejte #. Toto přiřazení prvek v DOM nepřesouvá a umožňuje umístit ovládací prvek mimo jeho formulář.
Atribut podporují prvky button, fieldset, input, object, output, select, textarea a vlastní prvky přiřazené k formuláři. Nejde o globální atribut. Samotné přiřazení neznamená, že prvek při odeslání formuláře přispěje hodnotou: například fieldset a output ji neposkytují.
Bez tohoto atributu prvek obvykle patří k nejbližšímu předkovi typu form. Při opětovném určování příslušnosti k formuláři se ID uvedené v atributu vyhledává jen tehdy, je-li prvek připojen k dokumentu. Pokud se v takovém případě nenajde odpovídající formulář, prvek zůstane bez přiřazení a nepřiřadí se k formuláři mezi svými předky. Prázdná hodnota pak výchozí přiřazení neobnoví — atribut raději odeberte. V podstromu odpojeném od dokumentu lze prvek stále přiřadit k nejbližšímu předkovi typu form, i když atribut neoznačuje žádný formulář. Používejte jedinečná ID.
Atribut se nedědí: nastavení form na prvku fieldset automaticky nepřiřadí jeho ovládací prvky k určenému formuláři. Vestavěné prvky, které tento atribut podporují, zpřístupňují vlastnost .form, jež vrací formulář nebo null. V příkladu patří externí input k order, je v order.elements a přispívá svou hodnotou do FormData(order).
Příklady
<!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>Výsledek
true true book
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.