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

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

Смежный узел, непосредственно предшествующий данному узлу в массиве

chiIdNodes[]

родительского узла

parentNode

, или null, если такого узла нет.

string textContent

Для узлов

Text

и

Comment

это свойство является синонимом свойства

data

. Для узлов

Element

и

DocumentFragment

это свойство возвращает объединенное содержимое всех вложенных узлов

Text

.

Операция присваивания этому свойству узлов

Element

или

DocumentFragment

замещает все вложенные узлы этого элемента или фрагмента новым единственным узлом

Text

с присвоенным свойству значением.

Методы

Node appendChild(Node newChild)

Этот метод добавляет узел

newChild

в документ, вставляя его в качестве последнего дочернего узла. Если узел

newChild

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

newChild

является узлом

DocumentFragment

, сам узел не вставляется, а вместо этого в конец массива

childNodes[]

данного узла вставляются по порядку все дочерние узлы объекта

DocumentFragment

. Обратите внимание, что узел из другого документа (или созданный другим документом) не может быть вставлен в текущий документ. То есть свойство

ownerDocument

узла

newChild

должно совпадать со свойством

ownerDocument

данного узла. (См.

Document.adoptNode

). Возвращает переданный ему узел.

Node cloneNode(boolean deep)

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

parentNode

имеет значение null. Когда копируется узел

Element

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

unsigned short compareDocumentPosition(Node other)

Сравнивает позицию данного узла в документе с позицией узла other и возвращает число, биты которого описывают отношения между узлами. Если сравниваемые' узлы являются одним и тем же узлом, все биты в результате будут сброшены, т.е. метод вернет 0. Иначе в возвращаемом значении будет установлен один или более битов. Константы D0CUMENT_P0SITI0N_, перечисленные выше, являются символическими именами каждого из битов и имеют следующее значение:

boolean hasChildNodes

Возвращает true, если данный узел имеет один или более дочерних узлов, или false - в противном случае.

Node insertBefore(Node newChild, Node refChild)

Вставляет узел newChild в дерево документа как дочерний узел данного узла и возвращает вставленный узел. Новый узел позиционируется

в массиве

childNodes[]

данного узла так, что он располагается непосредственно перед узлом refChild. Если аргумент refChild имеет значение null, узел newChild вставляется в конец массива

childNodes[],

как это делает метод

appendChild.

Обратите внимание, что является ошибкой передавать в аргументе refChild узел, не являющийся дочерним по отношению к данному узлу.

Если узел newChild уже включен в дерево документа, он удаляется из дерева и затем вставляется в новую позицию. Если newChild является узлом фрагмента

DocumentFragment

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

boolean isDefaultNamespace(string namespace)

Возвращает true, если URL-адрес пространства имен

namespace

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

lookupNamespaceURI(null),

и false - в противном случае.

boolean isEqualNode(Node other)

Возвращает true, если данный узел и узел other являются идентичными, т.е. имеют один и тот же тип, имя тега, атрибуты и (рекурсивно) дочерние узлы. Возвращает false, если два узла не являются эквивалентными.

boolean isSameNode(Node other)

Возвращает true, если данный узел и узел other являются одним и тем-же узлом, и false - в противном случае. Вмесло этого метода можно также просто использовать оператор ==.

string lookupNamespaceURI(string prefix)

Возвращает URL-адрес пространства имен, связанного с указанным префиксом пространства имен prefix, или null, если такой префикс не определен. Если аргумент prefix имеет значение null, возвращает URL-адрес пространства имен по умолчанию.

string lookupPrefix(string namespace)

Возвращает префикс пространства имен, связанного с указанным URL-адресом пространства имен, или null, если такое пространство имен не определено.

void normalize

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

Node removeChild(Node oldChild)

Этот метод удаляет дочерний узел oldChild из массива

childNodes[]

данного узла. Вызов этого метода с узлом, не являющимся дочерним, будет ошибкой. Метод

removeChild

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

Node replaceChild(Node newChild. Node oldChild)

Замещает узел oldChild в дереве документа другим узлом newChild. Узел oldChild должен быть дочерним для данного узла. Если newChild уже является частью документа, то он сначала удаляется из документа перед повторной вставкой в новую позицию. Если newChild является узлом фрагмента Document Fragment, то вместо узла newChild в позицию, ранее занятую узлом oldChild, по порядку вставляются все его дочерние узлы.