|
共通 DOM API | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface NamedNodeMap
NamedNodeMap
インタフェースを実装するオブジェクトは、名前を指定してアクセスできるノードのコレクションを表します。NamedNodeMap
は NodeList
を継承しません。つまり、特定の順序で管理されることがありません。 NamedNodeMap
を実装するオブジェクトに含まれるオブジェクトにも順序インデックスを使用してアクセスできますが、これは単に NamedNodeMap
のコンテンツを列挙しやすくするためであって、DOM がこれらの Node の順序を指定するということではありません。
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
。それ以外の場合は
が返される
DOMException
- WRONG_DOCUMENT_ERR:arg
が、このマップを作成した文書とは
異なる文書から作成された場合
arg
がすでに別の
Element
オブジェクトの属性である
Attr
である場合。Attr
ノードをほかの要素で再利用するには、
このノードを DOM ユーザーの手で明示的に複製する必要がある
Node removeNamedItem(String name) throws DOMException
name
- 削除するノードの nodeName
null
。
DOMException
- NOT_FOUND_ERR:このマップに name
という名前のノードがない
場合
Node item(int index)
index
番目の項目を返します。index
がこのマップ内のノード数と同じかそれよりも大きい場合は null
を返します。
index
- このマップのインデックス
index
番目の位置にあるノード。
インデックスが有効でない場合は null
int 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
。それ以外の場合は
が返される
DOMException
- WRONG_DOCUMENT_ERR:arg
が、このマップを作成した文書とは
異なる文書から作成された場合
arg
がすでに別の
Element
オブジェクトの属性である
Attr
である場合。Attr
ノードをほかの要素で再利用するには、
このノードを DOM ユーザーの手で明示的に複製する必要がある
XML
」機能をサポートしておらず、
文書を通じて公開された言語が XML 名前空間
(「HTML 4.01」など) をサポートしていない場合Node removeNamedItemNS(String namespaceURI, String localName) throws DOMException
Node
の属性がこの属性のよって返されるので、削除された属性がデフォルト値を持っていることがわかります。その場合には、属性が対応する URI 名前空間、ローカル名、接頭辞 (適用可能の場合) とともにデフォルト値を持っていることを直に表示します。
namespaceURI
- 削除するノードの名前空間 URIlocalName
- 削除するノードのローカル名
DOMException
- NOT_FOUND_ERR:指定された namespaceURI
と localName
を持つノードがこのマップにない場合
XML
」機能をサポートしておらず、
文書を通じて公開された言語が XML 名前空間
(「HTML 4.01」など) をサポートしていない場合
|
共通 DOM API | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |