Свойства и методы формы
Формы и элементы управления, такие как , имеют множество специальных свойств и событий.
Работать с формами станет намного удобнее, когда мы их изучим.
Навигация: формы и элементы
Формы в документе входят в специальную коллекцию document.forms .
Это так называемая «именованная» коллекция: мы можем использовать для получения формы как её имя, так и порядковый номер в документе.
document.forms.my - форма с именем "my" (name="my") document.forms[0] - первая форма в документеКогда мы уже получили форму, любой элемент доступен в именованной коллекции form.elements .
Может быть несколько элементов с одним и тем же именем, это часто бывает с кнопками-переключателями radio .
В этом случае form.elements[name] является коллекцией, например:
Эти навигационные свойства не зависят от структуры тегов внутри формы. Все элементы управления формы, как бы глубоко они не находились в форме, доступны в коллекции form.elements .
Форма может содержать один или несколько элементов внутри себя. Они также поддерживают свойство elements , в котором находятся элементы управления внутри них.
Есть более короткая запись: мы можем получить доступ к элементу через form[index/name] .
Другими словами, вместо form.elements.login мы можем написать form.login .
Это также работает, но есть небольшая проблема: если мы получаем элемент, а затем меняем его свойство name , то он всё ещё будет доступен под старым именем (также, как и под новым).
В этом легче разобраться на примере:
Обычно это не вызывает проблем, так как мы редко меняем имена у элементов формы.
Обратная ссылка: element.form
Для любого элемента форма доступна через element.form . Так что форма ссылается на все элементы, а эти элементы ссылаются на форму.
Элементы формы
Рассмотрим элементы управления, используемые в формах.
input и textarea
К их значению можно получить доступ через свойство input.value (строка) или input.checked (булево значение) для чекбоксов.
input.value = "Новое значение"; textarea.value = "Новый текст"; input.checked = true; // для чекбоксов и переключателейОбратим внимание: хоть элемент и хранит своё значение как вложенный HTML, нам не следует использовать textarea.innerHTML для доступа к нему.
Там хранится только тот HTML, который был изначально на странице, а не текущее значение.
select и option
Элемент имеет 3 важных свойства:
- select.options – коллекция из подэлементов ,
- select.value – значение выбранного в данный момент ,
- select.selectedIndex – номер выбранного .
Они дают три разных способа установить значение в :
- Найти соответствующий элемент и установить в option.selected значение true .
- Установить в select.value значение нужного .
- Установить в select.selectedIndex номер нужного .
Первый способ наиболее понятный, но (2) и (3) являются более удобными при работе.
Вот эти способы на примере:
В отличие от большинства других элементов управления, позволяет нам выбрать несколько вариантов одновременно, если у него стоит атрибут multiple . Эту возможность используют редко, но в этом случае для работы со значениями необходимо использовать первый способ, то есть ставить или удалять свойство selected у подэлементов .
Их коллекцию можно получить как select.options , например:
new Option
Элемент редко используется сам по себе, но и здесь есть кое-что интересное.
В спецификации есть красивый короткий синтаксис для создания элемента :
option = new Option(text, value, defaultSelected, selected);- text – текст внутри ,
- value – значение,
- defaultSelected – если true , то ставится HTML-атрибут selected ,
- selected – если true , то элемент будет выбранным.
Тут может быть небольшая путаница с defaultSelected и selected . Всё просто: defaultSelected задаёт HTML-атрибут, его можно получить как option.getAttribute(‘selected’) , а selected – выбрано значение или нет, именно его важно поставить правильно. Впрочем, обычно ставят оба этих значения в true или не ставят вовсе (т.е. false ).
let option = new Option("Текст", "value"); // создаст Тот же элемент, но выбранный:
let option = new Option("Текст", "value", true, true);option.selected Выбрана ли опция. option.index Номер опции среди других в списке . option.value Значение опции. option.text Содержимое опции (то, что видит посетитель).
Ссылки
Итого
Свойства для навигации по формам:
document.forms Форма доступна через document.forms[name/index] . form.elements Элементы формы доступны через form.elements[name/index] , или можно просто использовать form[name/index] . Свойство elements также работает для . element.form Элементы хранят ссылку на свою форму в свойстве form .
Значения элементов формы доступны через input.value , textarea.value , select.value и т.д. либо input.checked для чекбоксов и переключателей.
Для элемента мы также можем получить индекс выбранного пункта через select.selectedIndex , либо используя коллекцию пунктов select.options .
Это были основы для начала работы с формами. Далее в учебнике мы встретим ещё много примеров.
В следующей главе мы рассмотрим такие события, как focus и blur , которые могут происходить на любом элементе, но чаще всего обрабатываются в формах.
HTMLSelectElement
This interface inherits the properties of HTMLElement , and of Element and Node . HTMLSelectElement.autofocus A boolean value reflecting the autofocus HTML attribute, which indicates whether the control should have input focus when the page loads, unless the user overrides it, for example by typing in a different control. Only one form-associated element in a document can have this attribute specified. HTMLSelectElement.disabled A boolean value reflecting the disabled HTML attribute, which indicates whether the control is disabled. If it is disabled, it does not accept clicks. HTMLSelectElement.form Read only An HTMLFormElement referencing the form that this element is associated with. If the element is not associated with of a element, then it returns null . HTMLSelectElement.labels Read only A NodeList of elements associated with the element. HTMLSelectElement.length An unsigned long The number of elements in this select element. HTMLSelectElement.multiple A boolean value reflecting the multiple HTML attribute, which indicates whether multiple items can be selected. HTMLSelectElement.name A string reflecting the name HTML attribute, containing the name of this control used by servers and DOM search functions. HTMLSelectElement.options Read only An HTMLOptionsCollection representing the set of ( HTMLOptionElement ) elements contained by this element. HTMLSelectElement.required A boolean value reflecting the required HTML attribute, which indicates whether the user is required to select a value before submitting the form. HTMLSelectElement.selectedIndex A long reflecting the index of the first selected element. The value -1 indicates no element is selected. HTMLSelectElement.selectedOptions Read only An HTMLCollection representing the set of elements that are selected. HTMLSelectElement.size A long reflecting the size HTML attribute, which contains the number of visible items in the control. The default is 1, unless multiple is true , in which case it is 4. HTMLSelectElement.type Read only A string representing the form control’s type. When multiple is true , it returns «select-multiple» ; otherwise, it returns «select-one» . HTMLSelectElement.validationMessage Read only A string representing a localized message that describes the validation constraints that the control does not satisfy (if any). This attribute is the empty string if the control is not a candidate for constraint validation ( willValidate is false), or it satisfies its constraints. HTMLSelectElement.validity Read only A ValidityState reflecting the validity state that this control is in. HTMLSelectElement.value A string reflecting the value of the form control. Returns the value property of the first selected option element if there is one, otherwise the empty string. HTMLSelectElement.willValidate Read only A boolean value that indicates whether the button is a candidate for constraint validation. It is false if any conditions bar it from constraint validation.
Instance methods
This interface inherits the methods of HTMLElement , and of Element and Node . HTMLSelectElement.add() Adds an element to the collection of option elements for this select element. HTMLSelectElement.blur() Deprecated Removes input focus from this element. This method is now implemented on HTMLElement . HTMLSelectElement.checkValidity() Checks whether the element has any constraints and whether it satisfies them. If the element fails its constraints, the browser fires a cancelable invalid event at the element (and returns false ). HTMLSelectElement.focus() Deprecated Gives input focus to this element. This method is now implemented on HTMLElement . HTMLSelectElement.item() Gets an item from the options collection for this element. You can also access an item by specifying the index in array-style brackets or parentheses, without calling this method explicitly. HTMLSelectElement.namedItem() Gets the item in the options collection with the specified name. The name string can match either the id or the name attribute of an option node. You can also access an item by specifying the name in array-style brackets or parentheses, without calling this method explicitly. HTMLSelectElement.remove() Removes the element at the specified index from the options collection for this select element. HTMLSelectElement.reportValidity() This method reports the problems with the constraints on the element, if any, to the user. If there are problems, it fires a cancelable invalid event at the element, and returns false ; if there are no problems, it returns true . HTMLSelectElement.setCustomValidity() Sets the custom validity message for the selection element to the specified message. Use the empty string to indicate that the element does not have a custom validity error.
Events
Listen to these events using addEventListener() or by assigning an event listener to the oneventname property of this interface: change event Fires when the user selects an option. input event Fires when the value of an , , or element has been changed.
Example
Get information about the selected option
/* assuming we have the following HTML */ const select = document.getElementById("s"); // return the index of the selected option console.log(select.selectedIndex); // 1 // return the value of the selected option console.log(select.options[select.selectedIndex].value); // Second
A better way to track changes to the user’s selection is to watch for the change event to occur on the . This will tell you when the value changes, and you can then update anything you need to. See the example provided in the documentation for the change event for details.