Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje