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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.