Интерфейс NamedNodeMap

public interface NamedNodeMap

Объекты, реализующие интерфейс NamedNodeMap, используются для представления коллекций узлов, к которым можно получить доступ по имени. Обратите внимание, что NamedNodeMap не наследуется от NodeList; NamedNodeMaps не хранятся в определенном порядке. К объектам, содержащимся в объекте, реализующем NamedNodeMap, также можно получить доступ по порядковому индексу, но это просто для удобного перечисления содержимого NamedNodeMap, и это не подразумевает, что DOM определяет порядок этих узлов.

Объекты NamedNodeMap в DOM являются динамическими.

См. также Спецификацию Document Object Model (DOM) Level 3 Core.

Методы

getNamedItem

Node getNamedItem(String name)

Возвращает узел, указанный по имени.

Параметры:

name - nodeName узла для извлечения.

Возвращает:

Узел (любого типа) с указанным nodeName, или null, если он не идентифицирует ни одного узла в этой карте.

setNamedItem

Node setNamedItem(Node arg)
           throws DOMException

Добавляет узел, используя его атрибут nodeName. Если узел с таким именем уже присутствует в этой карте, он заменяется новым. Замена узла самим собой не оказывает никакого эффекта.
Так как атрибут nodeName используется для получения имени, под которым узел должен быть сохранён, несколько узлов определённых типов (имеющих "специальное" строковое значение) не могут быть сохранены, так как имена будут конфликтовать. Это считается предпочтительным по сравнению с разрешением алиасов узлов.

Параметры:

arg - Узел для хранения в этой карте. Узел позже будет доступен с помощью значения его атрибута nodeName.

Возвращает:

Если новый Node заменяет существующий узел, возвращается заменённый Node, в противном случае возвращается null.

Исключения:

DOMException - WRONG_DOCUMENT_ERR: Возникает, если arg был создан из другого документа, чем тот, который создал эту карту.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если эта карта является только для чтения.
INUSE_ATTRIBUTE_ERR: Возникает, если arg является Attr, который уже является атрибутом другого объекта Element. Пользователь DOM должен явно клонировать Attr узлы для повторного использования в других элементах.
HIERARCHY_REQUEST_ERR: Возникает, если попытка добавления узла не соответствует правилам. Примеры включают попытку вставить что-то, кроме узла Attr, в карту атрибутов элемента, или узел, не являющийся Entity, в карту сущностей DocumentType.

removeNamedItem

Node removeNamedItem(String name)
              throws DOMException

Удаляет узел, указанный по имени. Когда эта карта содержит атрибуты, прикрепленные к элементу, если удалённому атрибуту известно, что он имеет значение по умолчанию, то появляется атрибут, содержащий значение по умолчанию, а также соответствующий URI пространства имён, локальное имя и префикс, если применимо.

Параметры:

name - nodeName узла для удаления.

Возвращает:

Узел, удалённый из этой карты, если такой узел существует.

Исключения:

DOMException - NOT_FOUND_ERR: Возникает, если нет узла с именем name в этой карте.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если эта карта является только для чтения.

item

Node item(int index)

Возвращает элемент index в карте. Если index больше или равно количеству узлов в этой карте, возвращается null.

Параметры:

index - Индекс в этой карте.

Возвращает:

Узел в позиции index в карте, или null если это не допустимый индекс.

getLength

int getLength()

Количество узлов в этой карте. Диапазон допустимых индексов узлов-потомков - от 0 до length-1 включительно.

getNamedItemNS

Node getNamedItemNS(String namespaceURI,
                    String localName)
             throws DOMException

Возвращает узел, указанный по локальному имени и URI пространства имён.
Согласно [XML Namespaces], приложения должны использовать значение null в качестве параметра namespaceURI для методов, если они не желают использовать пространство имён.

Параметры:

namespaceURI - URI пространства имён узла для извлечения.

localName - Локальное имя узла для извлечения.

Возвращает:

Узел (любого типа) с указанным локальным именем и URI пространства имён, или null если он не идентифицирует ни одного узла в этой карте.

Исключения:

DOMException - NOT_SUPPORTED_ERR: Может быть вызвано, если реализация не поддерживает функцию "XML", и язык, доступный через Document, не поддерживает XML пространства имён (например, [HTML 4.01]).

С момента:

DOM Level 2

setNamedItemNS

Node setNamedItemNS(Node arg)
             throws DOMException

Добавляет узел, используя его namespaceURI и localName атрибуты. Если узел с этим URI пространства имён и локальным именем уже присутствует в этой карте, он заменяется новым. Замена узла самим собой не оказывает никакого эффекта.
Согласно [XML Namespaces], приложения должны использовать значение null в качестве параметра namespaceURI для методов, если они не желают использовать пространство имён.

Параметры:

arg - Узел для хранения в этой карте. Узел позже будет доступен с помощью значения его атрибутов namespaceURI и localName.

Возвращает:

Если новый Node заменяет существующий узел, возвращается заменённый Node, в противном случае возвращается null.

Исключения:

DOMException - WRONG_DOCUMENT_ERR: Возникает, если arg был создан из другого документа, чем тот, который создал эту карту.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если эта карта является только для чтения.
INUSE_ATTRIBUTE_ERR: Возникает, если arg является Attr, который уже является атрибутом другого объекта Element. Пользователь DOM должен явно клонировать Attr узлы для повторного использования в других элементах.
HIERARCHY_REQUEST_ERR: Возникает, если попытка добавления узла не соответствует правилам. Примеры включают попытку вставить что-то, кроме узла Attr, в карту атрибутов элемента, или узел, не являющийся Entity, в карту сущностей DocumentType.
NOT_SUPPORTED_ERR: Может быть вызвано, если реализация не поддерживает функцию "XML", и язык, доступный через Document, не поддерживает XML пространства имён (например, [HTML 4.01]).

С момента:

DOM Level 2

removeNamedItemNS

Node removeNamedItemNS(String namespaceURI,
                       String localName)
                throws DOMException

Удаляет узел, указанный по локальному имени и URI пространства имён. Удалённый атрибут может быть известен как имеющий значение по умолчанию, когда эта карта содержит атрибуты, прикреплённые к элементу, как возвращает атрибут attributes интерфейса Node. Если это так, то появляется атрибут, содержащий значение по умолчанию, а также соответствующий URI пространства имён, локальное имя и префикс, если применимо.
Согласно [XML Namespaces], приложения должны использовать значение null в качестве параметра namespaceURI для методов, если они не желают использовать пространство имён.

Параметры:

namespaceURI - URI пространства имён узла для удаления.

localName - Локальное имя узла для удаления.

Возвращает:

Узел, удалённый из этой карты, если такой узел существует.

Исключения:

DOMException - NOT_FOUND_ERR: Возникает, если нет узла с указанным namespaceURI и localName в этой карте.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если эта карта является только для чтения.
NOT_SUPPORTED_ERR: Может быть вызвано, если реализация не поддерживает функцию "XML", и язык, доступный через Document, не поддерживает XML пространства имён (например, [HTML 4.01]).

С момента:

DOM Level 2