|
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)
このマップの indexth 項目を返します。 |
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)
indexth 項目を返します。index がこのマップのノード数より大きいかまたは等しい場合、 null を返します。
index - このマップ内のインデックス
indexth の位置にあるノード、または有効なインデックスではない場合 nullpublic 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 | ||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||