compact2, compact3

org.w3c.dom

Интерфейс NamedNodeMap

public interface NamedNodeMap

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

NamedNodeMap объекты в ДОМЕ живы.

См. также Объектную модель документа (ДОМ) Спецификация Ядра Уровня 3.

Сводка метода

Модификатор и Тип	Метод и Описание
int	getLength() Число узлов в этой карте.
Узел	getNamedItem(String name) Получает узел, определенный по имени.
Узел	getNamedItemNS(String namespaceURI, String localName) Получает узел, определенный локальным именем и URI пространства имен.
Узел	item(int index) Возвраты indexэлемент th в карте.
Узел	removeNamedItem(String name) Удаляет узел, определенный по имени.
Узел	removeNamedItemNS(String namespaceURI, String localName) Удаляет узел, определенный локальным именем и URI пространства имен.
Узел	setNamedItem(Node arg) Добавляет узел, используя nodeName атрибут.
Узел	setNamedItemNS(Node arg) Добавляет узел, используя namespaceURI и localName.

Деталь метода

getNamedItem

Node getNamedItem(String name)

Получает узел, определенный по имени.

Параметры:

name - nodeName из узла, чтобы получить.

Возвраты:

A Node (любого типа) с указанным 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 объект. Пользователь ДОМА должен явно клонироваться Attr узлы, чтобы снова использовать их в других элементах.
HIERARCHY_REQUEST_ERR: Повышенный, если попытка предпринимается, чтобы добавить узел, не принадлежит в этом NamedNodeMap. Примеры включали бы попытку вставить что-то другое чем узел Attr в карту Элемента атрибутов, или узел небытия в карту DocumentType Объектов.

removeNamedItem

Node removeNamedItem(String name)
              throws DOMException

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

Параметры:

name - nodeName из узла, чтобы удалить.

Возвраты:

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

Броски:

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

элемент

Node item(int index)

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

Параметры:

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

Возвраты:

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

getLength

int getLength()

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

getNamedItemNS

Node getNamedItemNS(String namespaceURI,
                    String localName)
             throws DOMException

Получает узел, определенный локальным именем и URI пространства имен.
На [XML Пространства имен], приложения должны использовать нуль значения в качестве namespaceURI параметра для методов, если они хотят не иметь никакого пространства имен.

Параметры:

namespaceURI - URI пространства имен узла, чтобы получить.

localName - Локальное имя узла, чтобы получить.

Возвраты:

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

Броски:

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

С тех пор:

ДОМ Левель 2

setNamedItemNS

Node setNamedItemNS(Node arg)
             throws DOMException

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

Параметры:

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

Возвраты:

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

Броски:

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

С тех пор:

ДОМ Левель 2

removeNamedItemNS

Node removeNamedItemNS(String namespaceURI,
                       String localName)
                throws DOMException

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

Параметры:

namespaceURI - URI пространства имен узла, чтобы удалить.

localName - Локальное имя узла, чтобы удалить.

Возвраты:

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

Броски:

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

С тех пор:

ДОМ Левель 2