org.w3c.dom
介面 NamedNodeMap

public interface NamedNodeMap

實作 NamedNodeMap 介面的物件用於表示可以通過名稱存取的節點的集合。注意，NamedNodeMap 不從 NodeList 繼承；不以任何特定的順序維護 NamedNodeMaps。在實作 NamedNodeMap 的物件中包含的物件還可以通過順序索引進行存取，但只允許方便地列舉 NamedNodeMap 的內容，並不意味著 DOM 指定這些節點的順序。

DOM 中的 NamedNodeMap 物件是活動的。

另請參見 Document Object Model (DOM) Level 3 Core Specification。

方法摘要

int	getLength() 此映射中的節點數。
Node	getNamedItem(String name) 檢索通過名稱指定的節點。
Node	getNamedItemNS(String namespaceURI, String localName) 檢索通過本地名稱和名稱空間 URI 指定的節點。
Node	item(int index) 返回映射中第 index 個項。
Node	removeNamedItem(String name) 移除通過名稱指定的節點。
Node	removeNamedItemNS(String namespaceURI, String localName) 移除通過本地名稱和名稱空間 URI 指定的節點。
Node	setNamedItem(Node arg) 使用 nodeName 屬性添加節點。
Node	setNamedItemNS(Node arg) 使用其 namespaceURI 和 localName 添加節點。

方法詳細資訊

getNamedItem

Node getNamedItem(String name)

檢索通過名稱指定的節點。

參數：

name - 要檢索的節點的 nodeName。

返回：

具有指定 nodeName 的 Node（型別不限）；如果它不標識此映射中的任何節點，則返回 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 為已經是另一 Element 物件的屬性的 Attr，則引發此異常。DOM 使用者必須顯式地複製 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: 如果此映射為只讀的，則引發此異常。

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 的 Node（型別不限）；如果它們不標識此映射中的任何節點，則返回 null。

拋出：

DOMException - NOT_SUPPORTED_ERR: 如果實作不支持功能 "XML" 且文檔中公開的語言不支持 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 為已經是另一 Element 物件的屬性的 Attr，則引發此異常。DOM 使用者必須顯式地複製 Attr 節點，以便在其他元素中重新使用它們。
HIERARCHY_REQUEST_ERR: 如果試圖添加不屬於此 NamedNodeMap 的節點，則引發此異常。這樣的例子包括試圖將某些內容而不是 Attr 節點添加到屬性的元素映射，或者將非實體節點添加到實體的 DocumentType 映射。
NOT_SUPPORTED_ERR:如果實作不支持功能 "XML" 且文檔公開的語言不支持 XML 名稱空間（如 [HTML 4.01]），則可能引發此異常。

從以下版本開始：

DOM Level 2

removeNamedItemNS

Node removeNamedItemNS(String namespaceURI,
                       String localName)
                       throws DOMException

移除通過本地名稱和名稱空間 URI 指定的節點。此映射中包含連接到一個元素的屬性時，可能知道移除的屬性具有預設值，由 Node 介面的屬性返回。如果是這樣，當適當時包含預設值以及相應名稱空間 URI、本地名稱和前綴的屬性立即出現。
按照 [XML Namespaces]，如果應用程序希望沒有名稱空間，則它們必須將值 null 用作方法的 namespaceURI 參數。

參數：

namespaceURI - 要移除的節點的名稱空間 URI。

localName - 要移除的節點的本地名稱。

返回：

如果存在具有這樣的本地名稱和名稱空間 URI 的節點，則返回從此映射移除的節點。

拋出：

DOMException - NOT_FOUND_ERR:如果此映射中存在具有指定 namespaceURI 和 localName 的節點，則引發此異常。
NO_MODIFICATION_ALLOWED_ERR: 如果此映射為只讀的，則引發此異常。
NOT_SUPPORTED_ERR: 如果實作不支持功能 "XML" 且文檔公開的語言不支持 XML 名稱空間（如 [HTML 4.01]），則可能引發此異常。

從以下版本開始：

DOM Level 2