|
共通 DOM API | |||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
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 を使用してノードを追加します。 |
| メソッドの詳細 |
|---|
Node getNamedItem(String name)
name - 取得するノードの nodeName
nodeName を持つ Node (任意の種類)、このマップでノードとして識別されない場合は null
Node setNamedItem(Node arg)
throws DOMException
nodeName 属性を使って追加します。同じ名前を持つノードがマップ内に存在していた場合、そのノードは新しいノードで置き換えられます。特定のノードを同じ名前のノードで置き換えても、何も変更されません。 nodeName 属性に基づいて決定されるため、「特殊な」文字列値を持つ特定の種類のノードを複数格納することはできません。名前が衝突してしまうからです。この動作は、ノードの別名を認めるよりは好ましいと言えます。
arg - このマップに格納するノード。このノードには追加後、nodeName 属性の値を指定してアクセスできる
Node が既存の属性を置き換える場合、置き換えられた Node が返され、そうでない場合は null が返される
DOMException - WRONG_DOCUMENT_ERR: arg を作成したドキュメントとこのマップを作成したドキュメントが異なる場合に発生するarg に指定された Attr ノードが、別の Element オブジェクト内ですでに使用されている場合に発生する。ほかの要素内の Attr ノードを使用するには、その属性を明示的にコピーする必要がある
Node removeNamedItem(String name)
throws DOMException
name - 削除するノードの nodeName
DOMException - NOT_FOUND_ERR: name を名前に持つノードがこのマップ内に存在しない場合に発生するNode item(int index)
index 番目の項目を返します。index がこのマップのノード数より大きいかまたは等しい場合、 null を返します。
index - このマップ内のインデックス
index 番目の位置にあるノード、このノードが有効なインデックスではない場合 nullint getLength()
0 から length-1 です。
Node getNamedItemNS(String namespaceURI,
String localName)
throws DOMException
namespaceURI - 取得するノードの名前空間 URIlocalName - 取得するノードのローカル名
Node (任意の種類)、このマップでノードとして識別されない場合は null
DOMException - NOT_SUPPORTED_ERR: 「XML」機能が実装でサポートされておらず、XML 名前空間 ([HTML 4.01] など) もドキュメントで公開される言語でサポートされていない場合、発生する可能性がある
Node setNamedItemNS(Node arg)
throws DOMException
namespaceURI と localName を使用してノードを追加します。そのローカル名と名前空間 URI を持つノードがすでにこのマップにある場合は、新しいノードに置き換えられます。特定のノードを同じ名前のノードで置き換えても、何も変更されません。
arg - このマップに格納するノード。ノードには、あとでその namespaceURI と localName の属性値を使用してアクセスできる
Node が既存の属性を置き換える場合、置き換えられた Node が返され、そうでない場合は null が返される
DOMException - WRONG_DOCUMENT_ERR: arg を作成したドキュメントとこのマップを作成したドキュメントとが異なる場合に発生するarg に指定された Attr ノードが、別の Element オブジェクト内ですでに使用されている場合に発生する。ほかの要素内の Attr ノードを使用するには、その属性を明示的にコピーする必要がある
Node removeNamedItemNS(String namespaceURI,
String localName)
throws DOMException
Node の属性がこの属性によって返されるので、削除された属性がデフォルト値を持っていることがわかります。その場合には、属性が対応する URI 名前空間、ローカル名、接頭辞 (適用可能の場合) とともにデフォルト値を持っていることを直に表示します。
namespaceURI - 削除するノードの名前空間 URIlocalName - 削除するノードのローカル名
DOMException - NOT_FOUND_ERR: 指定された namespaceURI と localName を持つノードがこのマップ内に存在しない場合に発生する
|
共通 DOM API | |||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||