JavaScript. Подробное руководство, 6-е издание

Флэнаган Дэвид

Event createEvent(string eventlnterface)

Создает и возвращает неинициализированный объект

Event

искусственного события. Аргумент определяет тип события и должен быть строкой, такой как «Event», «UIEvent», «MouseEvent», «MessageEvent» и так далее. После создания объекта

Event

можно инициализировать его свойства, доступные только для чтения, вызовом соответствующих методов инициализации, таких Kaк

initEvent,initUIEvent, initMouseEvent

и так далее. Большая часть методов инициализации не рассматриваются в этой книге, но описание простейшего из них приводится в справочной статье

Event.іnitEvent

.

После создания и инициализации объекта искусственного события его можно отправить вызовом метода

dispatchEvent

интерфейса

EventTarget

. Искусственные события всегда имеют значение false в свойстве

isTrusted

.

Processinglnstruction createProcessingInstruction(string target, string data)

Создает и возвращает новый узел

Processinglnstruction

со строками target и data.

Text createTextNode(string data)

Создает и возвращает новый узел

Text

, представляющий текст text.

Element elementFromPoint(float х, float у)

Возвращает самый глубоко вложенный элемент

Element

с оконными координатами (х, у).

boolean execCommand(string commandld, [boolean showUI, [string value]])

Выполняет команду редактирования с именем в аргументе commandld в любом доступном для редактирования элементе, в котором находится текстовый курсор. Спецификация HTML5 определяет следующие команды:

Некоторые из этих команд (такие как

createLink

) требуют аргумент value. Если второй аргумент метода

execCommand

имеет знасение false, то значение аргумента команды определяется третьим аргументом метода. Иначе броузер предложит пользователю ввести необходимое значение. Подробнее о методе

execCommand

рассказывается в разделе 15.10.4.

Element getElementById(string elementld)

Отыскивает в документе узел

Element

с атрибутом id, значение которого совпадает со значением аргумента elementId, и возвращает этот элемент. Если такой элемент не найден, он возвращает null. Значение атрибута id предполагается уникальным в пределах документа, а если этот метод найдет более одного элемента с указанным значением element Id у то он вернет первый из них. Этот метод важен и часто используется, т.к. обеспечивает простой способ получения объекта

Element

, представляющего определенный элемент в документе. Обратите внимание: имя этого метода оканчивается суффиксом «Id», а не «ID».

NodeList getElementsByClassName(string classNames)

Возвращает объект, подобный массиву, содержащий элементы, в атрибуте class которых присутствуют все имена классов, указанные в classNames. Аргумент ClassNames может содержать единственное имя класса или список имен классов, разделенных пробелами. Возвращаемый объект

NodeList

– «живой» объект, который автоматически обновляется при изменении документа. Элементы в возвращаемом объекте

NodeList

располагаются в том же порядке, в каком они присутствуют

в документе. Обратите внимание, что этот метод также определен в объекте

Element

.

NodeList getElementsByName(string elementName)

Возвращает «живой», доступный только для чтения объект, подобный массиву, содержащий элементы со значением

elementName

в атрибуте

name

. Если искомые элементы отсутствуют, возвращается объект

NodeList

со значением 0 в свойстве

length

.

NodeList getElementsByTagName(string qualifiedName)

Возвращает доступный только для чтения объект, подобный массиву, содержащий все узлы

Element

из документа, имеющие указанное имя тега, в том порядке, в котором они располагаются в исходном тексте документа. Объект

NodeList

– «живой», т.е. его содержимое по необходимости автоматически обновляется, если элементы с указанным именем тега добавляются или удаляются из документа. Сравнение с именами тегов HTML-элементов выполняется без учета регистра символов. Как особый случай, имени тега «*» соответствуют все элементы документа. Обратите внимание: интерфейс

Element

определяет метод с тем же именем, который выполняет поиск по поддереву документа.

NodeList getElementsByTagNameNS(string namespace, string localName)

Этот метод работает точно так же, как

getElementsByTagName,

но при его использовании имя тега указывается как комбинация идентификатора URI пространства имен и локального имени тега в этом пространстве имен.

boolean hasFocus

Возвращает true, если окно с данным документом владеет фокусом ввода (или, если это окно не является окном верхнего уровня, все его родители владеют фокусом ввода).

Node importNode(Node node, boolean deep)

Получает узел, определенный в другом документе, и возвращает копию узла, подходящую для вставки в данный документ. Если аргумент deep имеет значение true, копируются также все потомки узла. Исходный узел и его потомки никак не модифицируются. В полученной копии свойство

ownerDocument

устанавливается равным данному документу, a

parentNode

– null, поскольку копия пока не вставлена в документ. Обработчики событий, зарегистрированные в исходном узле или дереве, не копируются. См. также

adoptNode

.

Window open(string url, string name, string features, [boolean replace])

Когда метод

open

документа вызывается с тремя и более аргументами, он действует подобно методу

open

объекта

Window

. См. также Window.

Document open([string type], [string replace])

При вызове с двумя и менее аргументами этот метод стирает текущий документ и начинает новый (используя существующий объект

Document

, который является возвращаемым значением). После вызова

open

можно использовать методы

write

и

writeln,

чтобы вывести содержимое в поток документа, и метод

close,

чтобы завершить создание документа и заставить броузер отобразить его. Подробности приводятся в разделе 15.10.2.