DOM要素
XML DOM - Element オブジェクト
Element オブジェクト
Element オブジェクトは、XML ドキュメント内の要素を表します。要素には、属性、他の要素、またはテキストを含めることができます。要素にテキストが含まれている場合、そのテキストはテキスト ノードで表されます。
重要: テキストはテキストノードに永久に保存されます。 DOM 処理中によくある間違いは、要素ノードに移動し、このノードにテキストが含まれていると想定してしまうことです。ただし、最も単純な要素ノードであっても、その下にテキスト ノードがあります。たとえば、<year>2005</year> には要素ノード (年) があり、このノードの下にテキスト ノードがあり、テキスト (2005) が含まれています。
Element オブジェクトはノードでもあるため、Node オブジェクトのプロパティとメソッドを継承できます。
要素オブジェクトの属性
| Attributes | Description |
|---|---|
| attributes | 要素の属性の NamedNodeMap を返します。 |
| baseURI | 要素の絶対ベース URI を返します。 |
| childNodes | 要素の子ノードのNodeListを返します。 |
| firstChild | 要素の最初の子ノードを返します。 |
| lastChild | 要素の最後の子ノードを返します。 |
| localName | 要素名のローカル部分を返します。 |
| namespaceURI | 要素の名前空間URIを返します。 |
| nextSibling | 要素の直後のノードを返します。 |
| nodeName | タイプに応じてノードの名前を返します。 |
| nodeType | ノードのタイプを返します。 |
| ownerDocument | 要素が属するルート要素 (ドキュメント オブジェクト) を返します。 |
| parentNode | 要素の親ノードを返します。 |
| prefix | 要素の名前空間プレフィックスを設定または返します。 |
| previousSibling | 要素の直前のノードを返します。 |
| schemaTypeInfo | 要素に関連付けられた型情報を返します。 |
| tagName | 要素の名前を返します。 |
| textContent | 要素とその子孫のテキストコンテンツを設定または返します。 |
Element オブジェクトのメソッド
| Method | Description |
|---|---|
| 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) | 指定された名前空間URIがデフォルトかどうかを返します。 |
| isEqualNode() | 2 つのノードが等しいかどうかを確認します。 |
| isSameNode() | 2 つのノードが同じノードであるかどうかを確認します。 |
| isSupported(feature,version) | 指定された機能がこの要素でサポートされているかどうかを返します。 |
| lookupNamespaceURI() | 指定されたプレフィックスに一致する名前空間 URI を返します。 |
| lookupPrefix() | 指定された名前空間 URI に一致するプレフィックスを返します。 |
| normalize() | ノードの下のすべてのテキスト ノード (属性を含む) を「標準」形式に配置します。この形式では、構造 (要素、コメント、処理命令、CDATA セクション、エンティティ参照など) のみが分離されます。たとえば、テキスト ノードには、隣接するテキスト ノードも空のテキスト ノードもありません。 |
| removeAttribute() | 指定された属性を削除します。 |
| removeAttributeNS() | 指定された属性 (名前空間付き) を削除します。 |
| removeAttributeNode() | 指定された属性ノードを削除します。 |
| removeChild() | 子ノードを削除します。 |
| replaceChild() | 子ノードを置き換えます。 |
| setUserData(key,data,handler) | オブジェクトを要素のキーに関連付けます。 |
| setAttribute() | 新しい属性を追加します。 |
| setAttributeNS() | 新しい属性を追加します（名前空間付き）。 |
| setAttributeNode() | 新しい属性ノードを追加します。 |
| setAttributeNodeNS(attrnode) | 新しい属性ノードを追加します (名前空間付き)。 |
| setIdAttribute(name,isId) | Attribute オブジェクトの isId 属性が true の場合、このメソッドは指定された属性をユーザー定義の ID 属性として宣言します。 |
| setIdAttributeNS(uri,name,isId) | Attribute オブジェクトの isId 属性が true の場合、このメソッドは、指定された属性をユーザー定義の ID 属性 (名前付きスペース付き) として宣言します。 |
| setIdAttributeNode(idAttr,isId) | Attribute オブジェクトの isId 属性が true の場合、このメソッドは指定された属性をユーザー定義の ID 属性として宣言します。 |
