База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

Атрибут form — изрично свързване с формуляр

Атрибутът form определя формуляра, към който принадлежи контролата, дори когато тя е извън него. Стойността му е id на формуляра в същото дърво, а не неговото name или CSS селектор.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

form="form-id"

Атрибутът form="form-id" изрично определя формуляра, към който принадлежи даден елемент. Стойността му трябва да съвпада с id на елемент form в същото дърво; не добавяйте #. Свързването не премества елемента в DOM и позволява контрола да бъде извън формуляра си.

Атрибутът се поддържа от button, fieldset, input, object, output, select, textarea и персонализирани елементи, свързани с формуляри. Той не е глобален атрибут. Самото свързване не означава, че елементът подава стойност при изпращане на формуляра: например fieldset и output не го правят.

Без този атрибут елементът обикновено принадлежи към най-близкия си предшественик form. При повторно определяне на формуляра собственик идентификаторът от атрибута се търси само ако елементът е свързан с документ. Ако в този случай не се намери съответстващ формуляр, елементът остава без собственик и не се свързва с формуляра сред предшествениците си. Тогава празната стойност не възстановява свързването по подразбиране — премахнете атрибута. В поддърво, отделено от документа, елементът все пак може да се свърже с най-близкия си предшественик form, дори ако атрибутът не указва формуляр. Използвайте уникални ID.

Атрибутът не се наследява: задаването на form на fieldset не свързва автоматично контролите му с посочения формуляр. Вградените елементи, които поддържат този атрибут, предоставят свойство .form, което връща формуляра или null. В примера външният input принадлежи на order, присъства в order.elements и подава стойността си на FormData(order).

Примери

<!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>

Резултат

true
true
book

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници