-
public interface NamedNodeMapNamedNodeMapインタフェースを実装するオブジェクトは、名前を指定してアクセスできるノードのコレクションを表すために使用されます。NamedNodeMapはNodeListを継承しません。NamedNodeMapsは特定のどの順序でも管理されません。NamedNodeMapを実装するオブジェクトに含まれるオブジェクトにも順序インデックスを使用してアクセスできますが、これは単にNamedNodeMapのコンテンツを列挙しやすくするためであって、DOMがこれらのNodeの順序を指定するということではありません。DOM内の
NamedNodeMapオブジェクトはライブ・オブジェクトです。「Document Object Model (DOM) Level 3 Core Specification」も参照してください。
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 intgetLength()このマップ内のノード数です。NodegetNamedItem(String name)指定された名前のノードを取得します。NodegetNamedItemNS(String namespaceURI, String localName)指定されたローカル名と名前空間URIを持つノードを取得します。Nodeitem(int index)マップ内のindex番目の項目を返します。NoderemoveNamedItem(String name)指定された名前のノードを削除します。NoderemoveNamedItemNS(String namespaceURI, String localName)指定されたローカル名と名前空間URIで指定されたノードを削除します。NodesetNamedItem(Node arg)nodeName属性を使用してノードを追加します。NodesetNamedItemNS(Node arg)namespaceURIとlocalNameを使用してノードを追加します。
-
-
-
メソッドの詳細
-
getNamedItem
Node getNamedItem(String name)
指定された名前のノードを取得します。- パラメータ:
name- 取得するノードのnodeName。- 戻り値:
- 指定された
nodeNameを持つ任意の型のNode。このマップ内のどのノードも特定されない場合はnull。
-
setNamedItem
Node setNamedItem(Node arg) throws DOMException
nodeName属性を使用してノードを追加します。 ノードは、その名前がすでにこのマップ内に存在する場合、新しいノードに置き換えられます。 ノードをノード自体で置換しても影響はまったくありません。nodeName属性はノードを格納するときの名前を取得するために使用されるため、「特殊な」文字列値を持つ特定の型のノードを複数個格納できません。これは、名前の競合が起きてしまうためです。 複数のノードを格納する必要がある場合はノードに別名を付けます。- パラメータ:
arg- このマップに格納するノード。 このノードには、あとでそのnodeName属性の値を使用してアクセスできる。- 戻り値:
- 既存のノードが新しい
Nodeで置き換えられる場合は、置き換えられるNodeが返されます。それ以外の場合はnullが返されます。 - 例外:
DOMException- WRONG_DOCUMENT_ERR:argがこのマップを作成した文書とは異なる文書から作成された場合に発生します。
NO_MODIFICATION_ALLOWED_ERR: このマップが読取り専用の場合に発生します。
INUSE_ATTRIBUTE_ERR:argが、すでに別のElementオブジェクトの属性となっているAttrの場合に発生します。Attrノードをほかの要素で再利用するには、DOMユーザーがそれを明示的に複製する必要があります。
HIERARCHY_REQUEST_ERR: このNamedNodeMapに属さないノードを追加しようとした場合に発生します。 たとえば、Attr以外のノードをElementの属性マップに挿入しようとしたり、Entity以外のノードをDocumentTypeのエンティティ・マップに挿入しようとしたりした場合が考えられます。
-
removeNamedItem
Node removeNamedItem(String name) throws DOMException
指定された名前のノードを削除します。 このマップに要素に追加された属性が含まれているとき、削除された属性にデフォルト値があるならば、名前空間URI、ローカル名、接頭辞(適切な場合)のほかにデフォルト値を持つ新しい属性が即座に作成されます。- パラメータ:
name- 削除するノードのnodeName。- 戻り値:
- このマップから削除するノード(指定された名前のノードが存在する場合)。
- 例外:
DOMException- NOT_FOUND_ERR: このマップ内にnameという名前のノードが無い場合に発生します。
NO_MODIFICATION_ALLOWED_ERR: このマップが読取り専用の場合に発生します。
-
item
Node item(int index)
マップ内のindex番目の項目を返します。indexがこのマップ内のノードの数以上である場合はnullを返します。- パラメータ:
index- このマップへのインデックス。- 戻り値:
- マップ内の
index番目の位置にあるノード。それが有効なインデックスでない場合はnull。
-
getLength
int getLength()
このマップ内のノード数です。 有効な子ノード・インデックスの範囲は0からlength-1までです。
-
getNamedItemNS
Node getNamedItemNS(String namespaceURI, String localName) throws DOMException
指定されたローカル名と名前空間URIを持つノードを取得します。
名前空間を保有しない場合は、XML名前空間に従って、アプリケーションでメソッドのnamespaceURIパラメータにnull値を使用する必要があります。- パラメータ:
namespaceURI- 取得するノードの名前空間URI。localName- 取得するノードのローカル名。- 戻り値:
- 指定されたローカル名と名前空間URIを持つ任意の型の
Node。このマップ内のどのノードも特定されない場合はnull。 - 例外:
DOMException- NOT_SUPPORTED_ERR: 実装が「XML」機能をサポートしておらず、文書を通じて公開された言語がXML名前空間(「HTML 4.01」など)をサポートしていない場合に発生する場合があります。- 導入されたバージョン:
- 1.4、DOMレベル2
-
setNamedItemNS
Node setNamedItemNS(Node arg) throws DOMException
namespaceURIとlocalNameを使用してノードを追加します。 このマップに名前空間URIとローカル名を持つノードがすでに存在する場合、新しいノードに置き換えられます。 ノードをノード自体で置換しても影響はまったくありません。
名前空間を保有しない場合は、XML名前空間に従って、アプリケーションでメソッドのnamespaceURIパラメータにnull値を使用する必要があります。- パラメータ:
arg- このマップに格納するノード。 このノードには、あとでそのnamespaceURI属性とlocalName属性の値を使用してアクセスできる。- 戻り値:
- 既存のノードが新しい
Nodeで置き換えられる場合は、置き換えられるNodeが返されます。それ以外の場合はnullが返されます。 - 例外:
DOMException- WRONG_DOCUMENT_ERR:argがこのマップを作成した文書とは異なる文書から作成された場合に発生します。
NO_MODIFICATION_ALLOWED_ERR: このマップが読取り専用の場合に発生します。
INUSE_ATTRIBUTE_ERR:argが、すでに別のElementオブジェクトの属性となっているAttrの場合に発生します。Attrノードをほかの要素で再利用するには、DOMユーザーがそれを明示的に複製する必要があります。
HIERARCHY_REQUEST_ERR: このNamedNodeMapに属さないノードを追加しようとした場合に発生します。 たとえば、Attr以外のノードをElementの属性マップに挿入しようとしたり、Entity以外のノードをDocumentTypeのエンティティ・マップに挿入しようとしたりした場合が考えられます。
NOT_SUPPORTED_ERR: 実装が「XML」機能をサポートしておらず、文書を通じて公開された言語がXML名前空間(「HTML 4.01」など)をサポートしていない場合に発生する場合があります。- 導入されたバージョン:
- 1.4、DOMレベル2
-
removeNamedItemNS
Node removeNamedItemNS(String namespaceURI, String localName) throws DOMException
指定されたローカル名と名前空間URIで指定されたノードを削除します。 このマップに、Nodeインタフェースのattributes属性によって返される、要素に接続された属性が含まれている場合は、削除された属性がデフォルト値を持っているとわかることがあります。 その場合には、属性が対応するURI名前空間、ローカル名、接頭辞(適用可能の場合)とともにデフォルト値を持っていることをじかに表示します。
名前空間を保有しない場合は、XML名前空間に従って、アプリケーションでメソッドのnamespaceURIパラメータにnull値を使用する必要があります。- パラメータ:
namespaceURI- 削除するノードの名前空間URI。localName- 削除するノードのローカル名。- 戻り値:
- このマップから削除するノード(指定されたローカル名および名前空間URIを持つノードが存在する場合)。
- 例外:
DOMException- NOT_FOUND_ERR: このマップ内に指定されたnamespaceURIとlocalNameを持つノードがない場合に発生します。
NO_MODIFICATION_ALLOWED_ERR: このマップが読取り専用の場合に発生します。
NOT_SUPPORTED_ERR: 実装が「XML」機能をサポートしておらず、文書を通じて公開された言語がXML名前空間(「HTML 4.01」など)をサポートしていない場合に発生する場合があります。- 導入されたバージョン:
- 1.4、DOMレベル2
-
-