NamedNodeMap インターフェイスを実装するオブジェクトは、名前でアクセス可能なノードの集合体を表すのに用いられる。 NamedNodeMap は NodeList を継承していないことに注意; NamedNodeMaps は特別な順序を持たない。NamedNodeMap を実装するオブジェクトに包含されるオブジェクトは、順序を表すインデックスでアクセスすることもできるが、 NamedNodeMap の内容の列挙を便利にするだけであり、DOMがこれらのノードの順序を定めることを意味しない。
DOMにおいて NamedNodeMap オブジェクトは 活きて いる。
lengthunsigned
long型, 読取専用
0 以上 length-1 以下である。getNamedItem( name )getNamedItemNS( namespaceURI, localName )item( index )マップ内の index番目の項目を返す。 index がこのマップ内のノードの数以上である場合、これは null を返す。
Node 型。マップ内の index番目の位置にあるノード。有効なインデックスでない場合は null。
removeNamedItem( name )名前で指定されたノードを取り除く。このマップが要素に付随する属性を含むものであるとき、取り除かれる属性がデフォルト値を持つと解っている場合は、属性は適宜該当する名前空間URI, ローカル名, 接頭辞とともにデフォルト値を持って直ちに出現する。
nodeName。Node 型。その名前のノードが存在する場合、このマップから取り除かれたノード。
name という名前のノードがない場合に発生。removeNamedItemNS( namespaceURI, localName )ローカル名と名前空間URIによって、指定されるノードを取り除く。Node インターフェイスの attributes プロパティによって返されるような、要素に付随する属性をこのマップが持つとき、取り除かれる属性がデフォルト値を持つと解っているかもしれない。その場合、適宜該当する名前空間URI、ローカル名、接頭辞とともにデフォルト値を持が属性が直ちに出現する。
HTML限定の実装はこのメソッドを実装する必要はない。
Node 型。そういうローカル名と名前空間URIを持つノードが存在する場合、このマップから取り除かれたノード。
namespaceURI と localName を持つノードがこのマップの中に存在しない場合に発生。setNamedItem( arg )その nodeName プロパティを用いてノードを追加する。このマップ内にその名前のノードが既に存在する場合、それは新しいものに置き換えられる。
ノードが格納される名前は nodeName プロパティを用いて引き出すので、名前の衝突するような複数の("特殊な" 文字列値を持つ)ある種のノードは格納できない。これはノードに別名をつけられるようにするのが望ましい。
nodeName プロパティの値を用いてアクセス可能である。Node 型。新しい Node が既存のノードを置き換える場合は置き換えられた Node が返される。そうでない場合は null。
arg が生成された文書が、このマップが生成された文書と異なる場合に発生。arg が既に別の Element オブジェクトの属性になっている Attr である場合に発生。 Attr ノードを他の要素内で再使用するには、DOM 使用者はこれを明示的に複製しなけれならなない。setNamedItemNS( arg )namespaceURI と localName を用いてノードを追加する。その名前空間URIとローカル名を持つノードが既にそのマップ内に存在する場合、新しいもので置き換える。
HTML限定の実装はこのメソッドを実装する必要はない。
namespaceURI と localName プロパティの値を用いて後からアクセス可能である。Node 型。新しい Node が既存のノードを置き換える場合は置き換えられた Node ノードを返す。そうでない場合は null。
arg が生成された文書が、このマップが生成された文書と異なる場合に発生。arg が既に別の Element オブジェクトの属性になっている Attr である場合に発生。 Attr ノードを他の要素内で再使用するには、DOM 使用者はこれを明示的に複製しなけれならなない。
interface NamedNodeMap {
Node getNamedItem(in DOMString name);
Node setNamedItem(in Node arg)
raises(DOMException);
Node removeNamedItem(in DOMString name)
raises(DOMException);
Node item(in unsigned long index);
readonly attribute unsigned long length;
// Introduced in DOM Level 2:
Node getNamedItemNS(in DOMString namespaceURI,
in DOMString localName);
// Introduced in DOM Level 2:
Node setNamedItemNS(in Node arg)
raises(DOMException);
// Introduced in DOM Level 2:
Node removeNamedItemNS(in DOMString namespaceURI,
in DOMString localName)
raises(DOMException);
};