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

ЖАНРЫ

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

string nodeValue

Значение узла. Для узлов

Text
содержит текстовое содержимое.

readonly Document ownerDocument

Объект

Document
, частью которого является данный узел. Для узлов
Document
это свойство равно null. Обратите внимание, что узлы всегда имеют владельца, даже если они не были добавлены в документ.

readonly Node parentNode

Родительский узел (или узел-контейнер) этого узла или null, если родительского узла не существует. Обратите внимание: узлы

Document
и
DocumentFragment
никогда не имеют родительских узлов. Кроме того, в узлах, удаленных из документа, а также в только что созданных, но еще не вставленных в дерево документа узлах свойство
parentNode
равно null.

readonly Node previousSibling

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

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 продолжает быть действительным узлом и может быть позднее вставлен в документ.

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