<b>оnореп</b>
Вызывается при открытии соединения. Обработчику передается простой объект
<b>Event</b>
.
EventTarget
объект, способный принимать события
Объекты, для которых генерируются события, и объекты, которые находятся на пути всплывающих событий, должны предоставлять возможность определять обработчики этих событий. Такие объекты обычно определяют свойства обработчиков событий, имена которых начинаются с префикса «оn» и, как правило, определяют методы, описываемые ниже. Регистрация обработчиков событий - поразительно сложная тема. За подробностями обращайтесь к разделу 17.2 и обратите внимание, что ІE версии 8 и ниже использует другие методы, чем все остальные броузеры; эти методы будут описаны в специальном разделе ниже.
Методы
<b>void addEventListener(string type,function listener,[boolean useCapture])</b>
Регистрирует функцию
<b>listener</b>
в качестве обработчика событий типа
type. Аргумент
type - строка с именем без префикса «оn». Аргумент
useCapture должен иметь значение true, если регистрируется перехватывающий обработчик (раздел 17.2.3) в предке элемента, являющегося истинной целью события. Обратите внимание, что некоторые броузеры все еще требуют передачи этой функции третьего аргумента, поэтому при регистрации обычного, неперехватывающего, обработчика в третьем аргументе следует передавать false,
<b>boolean dispatchEvent(Event event)</b>
Отправляет данному элементу искусственное событие event. Чтобы отправить событие, необходимо создать новый объект
<b>Event</b>
вызовом метода
<b>document.createEvent()</b>
с именем события (таким как «Events», в случае простого события). Затем инициализировать его методом инициализации созданного объекта
<b>Event</b>
: для простых событий - вызовом метода
<b>initEvent()</b>
(см.
<b>Event</b>
). После этого отправить инициализированное событие, передав его рассматриваемому методу. В современных броузерах каждый объект
<b>Event</b>
имеет свойство
<b>isTrusted</b>
. Для искуственных событий, посылаемых программно, это свойство будет иметь значение false. Различные типы объектов событий определяют собственные методы инициализации. Эти методы редко используются на практике, имеют длинные списки аргументов и не описываются в этой книге. Если вам потребуется создать, инициализировать и послать искуственное событие, более сложное, чем простой объект
<b>Event</b>
, поищите описание соответствующего метода инициализации в электронной документации.
<b>void removeEventListener(string type, function listener, [boolean useCapture])</b>
Удаляет зарегистрированный обработчик
<b>listener</b>
события. Принимает те же аргументы, что и метод
<b>addEventListener().</b>
Методы Internet Explorer
IE версии 8 и ниже не поддерживает методы
<b>addEventListener()</b>
и
<b>removeEventListener().</b>
Вместо них он реализует два более простых метода, которые описываются ниже. (Некоторые важные отличия перечислены в разделе 17.2.4.)
<b>void attachEvent(string type, function listener)</b>
Регистрирует функцию
<b>listener</b>
как обработчик событий типа
type. Обратите внимание, что этот метод требует, чтобы имя в аргументе
type включало префикс «оn».
<b>void detachEvent(string type, function listener)</b>
Этот метод действует как обратный методу
<b>attachEvent().</b>
FieldSet
элемент <fieldset> в HTML-формах (Node, Element, FormControl)
Объект
<b>FieldSet</b>
представляет элемент
<b><fieldset></b>
в HTML-формах
<b><form>.</b>
Объекты
<b>FieldSet</b>
реализуют многие, но не все свойства и методы интерфейса
<b>FormControl</b>
.
Свойства
<b>boolean disabled</b>
Значение true, если объект
<b>FieldSet</b>
находится в неактивном состоянии. Деактивация элемента
<b>FieldSet</b>
деактивирует содержащиеся в нем элементы форм.
<b>readonly HTMLFormControlsCollection elements</b>
Объект, подобный массиву, содержащий все элементы форм, имеющиеся внутри тега
<b><fieldset>.</b>
File
файл в локальной файловой системе (Blob)
Тип
<b>File</b>
является подтипом
<b>Blob</b>
. Объект
<b>File</b>
имеет имя и, возможно, дату последнего изменения. Он представляет файл в локальной файловой системе. Получить выбранный пользователем файл можно из массива
<b>files</b>
элемента
<b><input type=file></b>
или из массива
<b>files</b>
объекта DataTransfer, связанного с объектом
<b>Event</b>
, который получает обработчик события «drop».
Имеется также возможность получить объекты
<b>File</b>
, представляющие файлы в закрытой, изолированной файловой системе, как описано в разделе 22.7. Однако на момент написания этих строк прикладной интерфейс доступа к файловой системе оставался нестабильным, поэтому он не описывается в этом справочнике.
Содержимое файла можно выгрузить на сервер с помощью объекта
<b>FormData</b>
или передав объект
<b>File</b>
методу
<b>XMLHttpRequest.send(),</b>
однако непосредственно с объектом File можно выполнить не очень много операций. Чтобы прочитать содержимое файла, следует использовать объект
<b>FileReader</b>
(или любой объект
<b>Blob</b>
).
Свойства