Книга: JavaScript. Подробное руководство, 6-е издание
Form
Form
тег <form> в HTML-документе (Node, Element)
Объект Form
представляет элемент <form>
в HTML-документе. Свойство elements
- это объект HTMLCollection
, который дает удобный доступ ко всем элементам в форме. Методы submit()
и reset()
позволяют программным способом отправлять данные формы или сбрасывать все элементы формы в значения, предлагаемые по умолчанию. Каждая форма в документе представлена элементом массива document.forms[].
Элементы формы (кнопки, поля ввода, переключатели и т. д.) собраны в объекте Form.elements
, подобном массиву. К именованным элементам форм можно обращаться непосредственно по имени - имя элемента выступает в качестве имени свойства объекта Form
. Другими словами, обратиться к элементу Input
со значением «phone» в свойстве name
в форме f можно посредством JavaScript-выражения f.phone
.
Подробнее об HTML-формах рассказывается в разделе 15.9. Кроме того, дополнительную информацию об элементах форм можно найти в справочных статьях FormControl, FieldSet, Input, Label, Select
и TextArea
.
Данная справочная статья описывает некоторые особенности форм, определяемые спецификацией HTML5, которые на момент написания этих строк были реализованы не во всех броузерах.
Свойства
Большинство свойств, перечисленных ниже, просто соответствуют HTML-атрибутам с теми же именами,
string acceptCharset
Список из одного или более допустимых кодировок символов, которые могут использоваться для кодирования данных формы при отправке.
string action
URL-адрес, по которому должна быть отправлена форма.
string autocomplete
Строка «оn» или «off». Если содержит строку «оn», броузер будет предварительно заполнять элементы формы значениями, сохраненными при предыдущем посещении страницы.
readonly HTMLFormControlsCollection elements
Объект, подобный массиву, содержащий элементы формы.
string enctype
Определяет способ кодирования значений элементов формы при отправке. Допустимыми значениями являются:
• «application/x-www-form-urlencoded» (по умолчанию)
• «multipart/form-data»
• «text/plain»
readonly long length
Количество элементов формы, представляемых свойством elements
. Формы действуют, как если бы они сами были объектами, подобными массивам, содержащими элементы форм, поэтому для формы f и целого числа n выражение f[n] будет эквивалентно выражению f.elements[n].
string method
HTTP-метод отправки формы по URL-адресу в свойстве action
. Может иметь значение «get» или «post».
string name
Имя формы, определяемое HTML-атрибутом name
. Значение этого свойства можно использовать в качестве имени свойства объекта документа, значением которого будет данный объект Form
,
boolean noValidate string target
Имя окна или фрейма, где должен отображаться документ, возвращаемый в ответ на выполнение операции отправки формы.
Методы
boolean checkValidity()
В броузерах, поддерживающих возможность проверки форм, этот метод проверяет корректность введенных данных в каждом элементе формы. Он возвращает true, если все данные корректны. Если какой-либо элемент управления содержит недопустимые данные, он возбуждает событие «invalid» в этом элементе формы и возвращает false.
void dispatchFormChange()
Возбуждает событие «formchange» в каждом элементе данной формы. Обычно это делается автоматически, когда действия пользователя приводят к возбуждению события «change», поэтому вызывать этот метод обычно не требуется.
void dispatchFormlnput()
Возбуждает событие «forminput» в каждом элементе данной формы. Обычно это делается автоматически, когда действия пользователя приводят к возбуждению события «input», поэтому вызывать этот метод обычно не требуется.
void reset()
Сбрасывает все элементы ввода формы к их значениям по умолчанию.
void submit()
Выполняет отправку формы вручную, не возбуждая событие «submit».
Обработчики событий
Следующие обработчики событий, связанные с формами, определены в объекте Element
, но описываются здесь, потому что возбуждаются в элементах Form.
onreset
Вызывается непосредственно перед тем, как форма будет сброшена в исходное состояние. Чтобы предотвратить сброс, обработчик может вернуть false или отменить событие.
onsubmit
Вызывается непосредственно перед отправкой формы. Чтобы предотвратить отправку, обработчик может вернуть false или отменить событие.
- ApplicationCache
- ArrayBuffer
- ArrayBufferView
- Attr
- Audio
- BeforeUnloadEvent
- Blob
- BlobBuilder
- Button
- Canvas
- BlobBuilder
- Button
- Canvas
- CanvasGradient
- CanvasPattern
- CanvasRenderingContext2D
- ClientRect
- CloseEvent
- Comment
- Console
- ConsoleCommandLine
- CSS2Properties
- CSSRule
- CSSStyleDeclaration
- CSSStyleSheet
- DataTransfer
- DataView
- Document
- DocumentFragment
- DocumentType
- DOMException
- DOMImplementation
- DOMSettableTokenList
- DOMTokenList
- Element
- ErrorEvent
- Event
- EventSource
- EventTarget
- FieldSet
- File
- FileError
- FileReader
- FileReaderSync
- Form
- FormControl
- Form Data
- FormValidity
- Geocoordinates
- Geolocation
- GeolocationError
- Geoposition
- HashChangeEvent
- History
- HTMLCollection
- HTMLDocument
- HTMLEIement
- HTMLFormControlsCollection
- HTMLOptionsCollection
- IFrame
- Image
- ImageData
- Input
- jQuery jQuery 1.4
- KeyEvent
- Label
- Link
- Location
- MediaElement
- MediaError
- MessageChannel
- MessageEvent
- MessagePort
- Meter
- MouseEvent
- Navigator
- Node
- NodeList
- Option
- Output
- PageTransitionEvent
- PopStateEvent
- ProcessingInstruction
- Progress
- ProgressEvent
- Screen
- Script
- Select
- Storage
- StorageEvent
- Style
- Table
- TableCell
- TableRow
- TableSection
- Text
- TextArea
- TextMetrics
- TimeRanges
- TypedArray
- URL
- Video
- WebSocket
- Window
- Worker
- WorkerGlobalScope
- WorkerLocation
- WorkerNavigator
- XMLHttpRequest
- XMLHttpRequestUpload
- Information request
- SCTP Generic header format
- 2.3 Executable and Linking Format
- На всех дисках моего компьютера есть папка System Volume Information. Для чего она нужна?
- fdformat
- Convection Currents of Information
- Working with Graphics Formats
- Sound Formats
- Video Formats
- Common Configuration Information
- Configuring Apache for Peak Performance
- Configure User Information