XML DOM - Elementオブジェクト
Element オブジェクト
Element オブジェクトは XML ドキュメント内の要素を表します。要素には属性、他の要素、またはテキストを含めることができます。要素にテキストが含まれる場合、そのテキストはテキストノード内に表されます。
重要事項:テキストは常にテキストノードに格納されます。DOM 処理における一般的な誤りは、要素ノードに移動して、このノードにテキストが含まれていると考えることです。しかし、最も単純な要素ノードにも、その下にテキストノードが存在します。例えば、<year>2005</year> では、要素ノード(year)があり、同時にこのノードの下にテキスト(2005)を含むテキストノードが存在します。
Element オブジェクトもノードの一種であるため、Node オブジェクトのプロパティとメソッドを継承できます。
Element オブジェクトのプロパティ
| プロパティ | 説明 |
|---|---|
| attributes | 要素の属性の NamedNodeMap を返します。 |
| baseURI | 要素の絶対ベース URI を返します。 |
| childNodes | 要素の子ノードの NodeList を返します。 |
| firstChild | 要素の最初の子ノードを返します。 |
| lastChild | 要素の最後の子ノードを返します。 |
| localName | 要素名のローカル部分を返します。 |
| namespaceURI | 要素の名前空間 URI を返します。 |
| nextSibling | 要素の直後のノードを返します。 |
| nodeName | ノードの型に応じて、ノードの名前を返します。 |
| nodeType | ノードの型を返します。 |
| ownerDocument | 要素が属するルート要素(document オブジェクト)を返します。 |
| parentNode | 要素の親ノードを返します。 |
| prefix | 要素の名前空間プレフィックスを設定または返します。 |
| previousSibling | 要素の直前のノードを返します。 |
| schemaTypeInfo | 要素に関連付けられた型情報を返します。 |
| tagName | 要素の名前を返します。 |
| textContent | 要素とその子孫のテキストコンテンツを設定または返します。 |
Element オブジェクトのメソッド
| メソッド | 説明 |
|---|---|
| appendChild() | 新しい子ノードをノードの子ノードリストの末尾に追加します。 |
| cloneNode() | ノードをクローンします。 |
| compareDocumentPosition() | 2 つのノードのドキュメント内の位置を比較します。 |
| getAttribute() | 属性の値を返します。 |
| getAttributeNS() | 属性の値を返します(名前空間付き)。 |
| getAttributeNode() | 属性ノードを Attribute オブジェクトとして返します。 |
| getAttributeNodeNS() | 属性ノードを Attribute オブジェクトとして返します(名前空間付き)。 |
| getElementsByTagName() | 一致する要素ノードとその子ノードの NodeList を返します。 |
| getElementsByTagNameNS() | 一致する要素ノード(名前空間付き)とその子ノードの NodeList を返します。 |
| getFeature(feature,version) | 指定された特性とバージョンを持つ専用 API を実行できる DOM オブジェクトを返します。 |
| getUserData(key) | ノード上のキーに関連付けられたオブジェクトを返します。このオブジェクトは、同じキーを使用して setUserData を呼び出すことによって、最初にこのノードに設定されていなければなりません。 |
| hasAttribute() | 要素が指定された名前と一致する属性を持つかどうかを返します。 |
| hasAttributeNS() | 要素が指定された名前と名前空間に一致する属性を持つかどうかを返します。 |
| hasAttributes() | 要素が属性を持つかどうかを返します。 |
| hasChildNodes() | 要素が子ノードを持つかどうかを返します。 |
| insertBefore() | 既存の子ノードの前に新しい子ノードを挿入します。 |
| isDefaultNamespace(URI) | 指定された namespaceURI がデフォルトであるかどうかを返します。 |
| isEqualNode() | 2 つのノードが等しいかどうかを検査します。 |
| isSameNode() | 2 つのノードが同一のノードであるかどうかを検査します。 |
| isSupported(feature,version) | 指定された特性がこの要素でサポートされているかどうかを返します。 |
| lookupNamespaceURI() | 指定されたプレフィックスに一致する名前空間 URI を返します。 |
| lookupPrefix() | 指定された名前空間 URI に一致するプレフィックスを返します。 |
| normalize() | ノード(属性を含む)の下にあるすべてのテキストノードを「標準」形式に配置します。この形式では、構造(要素、コメント、処理命令、CDATA セクション、エンティティ参照など)だけが Text ノードを区切ります。例えば、隣接する Text ノードも空の Text ノードもありません。 |
| removeAttribute() | 指定された属性を削除します。 |
| removeAttributeNS() | 指定された属性を削除します(名前空間付き)。 |
| removeAttributeNode() | 指定された属性ノードを削除します。 |
| removeChild() | 子ノードを削除します。 |
| replaceChild() | 子ノードを置き換えます。 |
| setUserData(key,data,handler) | オブジェクトを要素上のキーに関連付けます。 |
| setAttribute() | 新しい属性を追加します。 |
| setAttributeNS() | 新しい属性を追加します(名前空間付き)。 |
| setAttributeNode() | 新しい属性ノードを追加します。 |
| setAttributeNodeNS(attrnode) | 新しい属性ノードを追加します(名前空間付き)。 |
| setIdAttribute(name,isId) | Attribute オブジェクトの isId プロパティが true の場合、このメソッドは指定された属性をユーザー決定 ID 属性(user-determined ID attribute)として宣言します。 |
| setIdAttributeNS(uri,name,isId) | Attribute オブジェクトの isId プロパティが true の場合、このメソッドは指定された属性をユーザー決定 ID 属性(user-determined ID attribute)として宣言します(名前空間付き)。 |
| setIdAttributeNode(idAttr,isId) | Attribute オブジェクトの isId プロパティが true の場合、このメソッドは指定された属性をユーザー決定 ID 属性(user-determined ID attribute)として宣言します。 |
その他の拡張