Чтение онлайн

ЖАНРЫ

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

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.

Новый документ будет являться HTML-документом, если аргумент type отсутствует или имеет значение «text/html». Иначе будет создан простой текстовый документ. Если аргумент replace имеет значение true, новый документ заменит прежний в истории посещений броузера.

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

boolean queryCommandEnabled(string commandld)

Возвращает true, если в настоящий момент можно передать команду commandld методу

execCommand,
и false - в противном случае. Например, бессмысленно передавать команду «undo», когда нечего отменять. Подробности приводятся в разделе 15.10.4.

boolean queryCommandIndeterm(string commandld)

Возвращает true, если commandld находится в состоянии, для которого

queryCommandState
не может вернуть какое-то определенное значение. Команды, определяемые спецификацией HTML5, не могут находиться в неопределенном состоянии, но команды, определяемые броузером, - могут. Подробности приводятся в разделе 15.10.4.

boolean queryCommandState(string commandld)

Возвращает состояние команды commandld. Некоторые команды редактирования, такие как «bold» и «italic», имеют состояние true, если под текстовым курсором или в выделенной области находится текст, набранный курсивом, и false - в противном случае. Однако большинство команд не имеют состояния, и для них этот метод всегда возвращает false. Подробности приводятся в разделе 15.10.4.

boolean queryCommandSupported(string commandld)

Возвращает true, если броузер поддерживает указанную команду, и false - в противном случае. Подробности приводятся в разделе 15.10.4.

string queryCommandValue(string commandld)

Возвращает состояние указанной команды в виде строки. Подробности приводятся в разделе 15.10.4.

Element querySelector(string selectors)

Возвращает первый элемент в данном документе, соответствующий CSS-селекторам

selectors
(это может быть единственный CSS-селектор или группа селекторов, разделенных запятыми).

Поделиться с друзьями: