|
Common DOM API | ||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
NamedNodeMap
インタフェースを実装するオブジェクトは、名前によってアクセスされるノードのコレクションを表示するために使用されます。NamedNodeMap
は NodeList
から継承されず、このため NamedNodeMaps
は特定の順序で保持されないことに注意してください。NamedNodeMap
を実装するオブジェクトに含まれるオブジェクトは、順序を示すインデックスでアクセスできますが、単にこれは NamedNodeMap
の内容が便宜上列挙できるようにするためで、DOM がこれらのノードに対する順序を指定することを意味するものではありません。
DOM 内の NamedNodeMap
オブジェクトはライブです。
詳細については、 「Document Object Model (DOM) Level 2 Core Specification」 も参照してください。
メソッドの概要 | |
int |
getLength()
このマップのノード数。 |
Node |
getNamedItem(String name)
指定された名前のノードを取得します。 |
Node |
getNamedItemNS(String namespaceURI,
String localName)
指定されたローカル名と名前空間 URI を持つノードを取得します。 |
Node |
item(int index)
このマップの index th 項目を返します。 |
Node |
removeNamedItem(String name)
名前により指定されたノードを削除します。 |
Node |
removeNamedItemNS(String namespaceURI,
String localName)
指定されたローカル名と名前空間 URI を持つノードを削除します。 |
Node |
setNamedItem(Node arg)
特定のノードをその nodeName 属性を使って追加します。 |
Node |
setNamedItemNS(Node arg)
namespaceURI と localName を使用してノードを追加します。 |
メソッドの詳細 |
public Node getNamedItem(String name)
name
- 取得するノードの nodeName
nodeName
を持つ Node
(すべてのタイプ)、またはこのマップでノードとして識別されない場合は null
public Node setNamedItem(Node arg) throws DOMException
nodeName
属性を使って追加します。同じ名前を持つノードがマップ内に存在していた場合、そのノードは新しいノードで置き換えられます。マップ内のノード名は、nodeName
属性に基づいて決定されるため、「特殊な」文字列値を持つタイプのノードを複数格納することはできません。これは、名前が衝突してしまうからです。この動作は、ノードの別名を認めるよりは好ましいと言えます。
arg
- このマップに格納するノード。このノードには追加後、nodeName
属性の値を指定してアクセスできる
Node
が既存の属性を置き換える場合、置き換えられた Node
が返され、そうでない場合は null
が返される
DOMException
- WRONG_DOCUMENT_ERR: arg
を作成したドキュメントとこのマップを作成したドキュメントとが異なる場合に発行されるarg
に指定された Attr
ノードが、別の Element
オブジェクト内ですでに使用されている場合に発行される。ほかの要素内の Attr
ノードを使用するには、その属性を明示的にコピーする必要があるpublic Node removeNamedItem(String name) throws DOMException
name
- 削除するノードの nodeName
DOMException
- NOT_FOUND_ERR: name
を名前に持つノードがこのマップ内に存在しない場合に発行されるpublic Node item(int index)
index
th 項目を返します。index
がこのマップのノード数より大きいかまたは等しい場合、 null
を返します。
index
- このマップ内のインデックス
index
th の位置にあるノード、または有効なインデックスではない場合 null
public int getLength()
0
から length-1
です。
public Node getNamedItemNS(String namespaceURI, String localName)
namespaceURI
- 取得するノードの名前空間 URIlocalName
- 取得するノードのローカル名
Node (すべてのタイプ)、またはこのマップでノードとして識別されない場合は null
- 導入されたバージョン:
- DOM Level 2
public Node setNamedItemNS(Node arg) throws DOMException
namespaceURI
と localName
を使用してノードを追加します。そのローカル名と名前空間 URI を持つノードがすでにこのマップにある場合は、新しいノードに置き換えられます。
arg
- このマップに格納するノード。このノードには、あとでその namespaceURI
と localName
の属性値を使用してアクセスできる
Node
が既存の属性を置き換える場合、置き換えられた Node
が返され、そうでない場合は null
が返される
DOMException
- WRONG_DOCUMENT_ERR: arg
を作成したドキュメントとこのマップを作成したドキュメントとが異なる場合に発行されるarg
に指定された Attr
ノードが、別の Element
オブジェクト内ですでに使用されている場合に発行される。ほかの要素内の Attr
ノードを使用するには、その属性を明示的にコピーする必要があるpublic Node removeNamedItemNS(String namespaceURI, String localName) throws DOMException
Node
インタフェースの attributes 属性から返されるマップのように、ある要素の属性マップである場合、削除された属性がデフォルト値を持っている可能性があります。その場合は削除後すぐに、デフォルト値と対応する名前空間 URI、ローカル名、および接頭辞を持つ新しい属性がマップに追加されます。
namespaceURI
- 削除するノードの名前空間 URIlocalName
- 削除するノードのローカル名
DOMException
- NOT_FOUND_ERR: 指定された namespaceURI
と localName
を持つノードがこのマップ内に存在しない場合に発行される
|
Common DOM API | ||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |