NamedNodeMap

NamedNodeMap 介面表示了 Attr (en-US) 物件的集合。雖然 NamedNodeMap 與 NodeList 都能如陣列一般透過索引訪問成員,但和 NodeList 不同的是,NamedNodeMap 中的成員並沒有順序。

NamedNodeMap 物件具有即時性(live),如果其內部成員(屬性節點物件)發生改變,NamedNodeMap 物件會自動更新至最新的狀態。

僅管被稱作 NamedNodeMap,但本介面並不是直接用來處理節點物件(Node),而是專門負責屬性節點物件(Attr (en-US))。屬性節點是一種特殊的節點,在部分瀏覽器實作中依然存在。

屬性

This interface doesn't inherit any property.

NamedNodeMap.length Read only
Returns the amount of objects in the map.

方法

This interface doesn't inherit any method.

NamedNodeMap.getNamedItem() (en-US)
Returns a Attr (en-US), corresponding to the given name.
NamedNodeMap.setNamedItem()
Replaces, or adds, the Attr (en-US) identified in the map by the given name.
NamedNodeMap.removeNamedItem()
Removes the Attr (en-US) identified by the given map.
NamedNodeMap.item()
Returns the Attr (en-US) at the given index, or null if the index is higher or equal to the number of nodes.
NamedNodeMap.getNamedItemNS()
Returns a Attr (en-US) identified by a namespace and related local name.
NamedNodeMap.setNamedItemNS()
Replaces, or adds, the Attr (en-US) identified in the map by the given namespace and related local name.
NamedNodeMap.removeNamedItemNS()
Removes the Attr (en-US) identified by the given namespace and related local name.

規範

Specification Status Comment
DOM
The definition of 'NamedNodeMap' in that specification.
Living Standard Deals with Attr (en-US) instead of Node
Document Object Model (DOM) Level 3 Core Specification
The definition of 'NamedNodeMap' in that specification.
Obsolete No change from Document Object Model (DOM) Level 2 Core Specification
Document Object Model (DOM) Level 2 Core Specification
The definition of 'NamedNodeMap' in that specification.
Obsolete Added getNamedItemNS(), setNamedItemNS() and removeNamedItemNS()
Document Object Model (DOM) Level 1 Specification
The definition of 'NamedNodeMap' in that specification.
Obsolete Initial definition

瀏覽器相容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
Deals with Attr (en-US) rather than Node ? ? 22 (22)[1] ? ? ?
Feature Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
Deals with Attr (en-US) rather than Node ? ? 22.0 (22)[1] ? ? ?

[1] In Gecko 22 this interface was named mozNamedAttrMap. In Gecko 34 it was named back to NamedNodeMap.

參見