オブジェクトXml要素

XmlElement オブジェクトは XML ドキュメント内の要素を表します

相続関係

メンバーのプロパティ

namespaceURI

文字列、クエリ要素の名前空間の URI。選択したノードに名前空間がない場合、このプロパティは NULL を返します。

1
readonly String XmlElement.namespaceURI;

prefix

要素の名前空間プレフィックスを文字列、クエリ、および設定します。選択したノードに名前空間がない場合、このプロパティは NULL を返します。

1
String XmlElement.prefix;

localName

文字列、クエリ要素のローカル名。選択したノードに名前空間がない場合、このプロパティはnodeNameと同等です。

1
readonly String XmlElement.localName;

tagName

文字列、要素のタグ名を返します。

1
readonly String XmlElement.tagName;

id

文字列、クエリ、要素の id 属性の設定

1
String XmlElement.id;

innerHTML

選択した要素の子孫の HTML テキストを文字列、クエリおよび設定します。HTML モードでのみ有効です。クエリの場合は、要素ノード内のすべての子ノードの HTML エンコーディングを返します。設定の場合は、すべての子ノードを削除し、指定された HTML デコーディングで置き換えます。

1
String XmlElement.innerHTML;

outerHTML

文字列。選択した要素とその子孫の HTML テキストをクエリします。HTML モードでのみ有効です。クエリを実行すると、要素とノード内のすべての子ノードの HTML エンコーディングが返されます。

1
readonly String XmlElement.outerHTML;

className

要素のクラス属性を文字列、クエリおよび設定します。HTML モードでのみ有効です。

1
String XmlElement.className;

attributes

XmlNamedNodeMap、選択したノードの属性を含む NamedNodeMap を返します。選択したノードが要素ではない場合、このプロパティは NULL を返します。

1readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

整数。ノードのノードタイプを返します。

1readonly Integer XmlElement.nodeType;

オブジェクトが異なると、nodeType も異なる値を返します。

XmlElement: ELEMENT_NODE(1)
XmlAttr:ATTRIBUTE_NODE(2)
XmlText: TEXT_NODE(3)
XmlCDATASection: CDATA_SECTION_NODE(4)
XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
XmlComment:COMMENT_NODE(8)
XmlDocument: ドキュメント_NODE(9)
XmlDocumentType: ドキュメントタイプ_NODE(10)

nodeName

文字列。タイプに応じてノードの名前を返します。

1
readonly String XmlElement.nodeName;

オブジェクトが異なると、nodeName も異なる値を返します。

XmlElement:要素名
XmlAttr：属性名
XmlText：＃文章
XmlCDATASection: #cdata-セクション
XmlProcessingInstruction: 指定されたターゲット target を返します。
XmlComment：＃コメント
XmlDocument：＃書類
XmlDocumentType: ドキュメントタイプ名

nodeValue

文字列。タイプに応じてノードの名前を返します。

1
String XmlElement.nodeValue;

オブジェクトが異なると、nodeName も異なる値を返します。

XmlElement：ヌル
XmlAttr: 属性値
XmlText: ノードの内容
XmlCDATASection: ノードの内容
XmlProcessingInstruction: 指定されたコンテンツデータを返します
XmlComment: 注釈テキスト
XmlDocument：ヌル
XmlDocumentType：ヌル

ownerDocument

XmlDocument、ノードのルート要素を返します (XmlDocument物体）

1readonly XmlDocument XmlElement.ownerDocument;

parentNode

XmlNode、ノードの親ノードを返すことができます

1readonly XmlNode XmlElement.parentNode;

childNodes

XmlNodeList、指定されたノードの子ノードのノードリストを返します。

1readonly XmlNodeList XmlElement.childNodes;

children

XmlNodeListは、指定されたノードの子要素ノードのノードリストを返します。

1readonly XmlNodeList XmlElement.children;

firstChild

XmlNode、ノードの最初の子ノードを返します。

1readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode、ノードの最後の子ノードを返します。

1readonly XmlNode XmlElement.lastChild;

previousSibling

XmlNodeは、(同じツリーレベルで) ノードの直前のノードを返します。そのようなノードがない場合、このプロパティは null を返します。

1readonly XmlNode XmlElement.previousSibling;

nextSibling

XmlNodeは、(同じツリーレベル内の) 要素の直後にあるノードを返します。そのようなノードがない場合、属性は null を返します。

1readonly XmlNode XmlElement.nextSibling;

firstElementChild

XmlNode、ノードの最初の子要素ノードを返します。

1readonly XmlNode XmlElement.firstElementChild;

lastElementChild

XmlNode、ノードの最後の子要素ノードを返します。

1readonly XmlNode XmlElement.lastElementChild;

previousElementSibling

XmlNode, ノード (同じツリーレベル) の直前の要素ノードを返します。そのようなノードがない場合、このプロパティは null を返します。

1readonly XmlNode XmlElement.previousElementSibling;

nextElementSibling

XmlNode, (同じツリーレベル内の) 要素の直後にある要素ノードを返します。そのようなノードがない場合、属性は null を返します。

1readonly XmlNode XmlElement.nextElementSibling;

textContent

選択した要素のテキストをクエリおよび設定する文字列。クエリの場合は、要素ノード内のすべてのテキストノードの値を返します。設定の場合は、すべての子ノードを削除し、単一のテキストノードに置き換えます。

1
String XmlElement.textContent;

メンバー関数

getAttribute

属性の値を名前でクエリする

1
String XmlElement.getAttribute(String name);

呼び出しパラメータ:

name: 文字列。クエリの属性名を指定します。

返される結果:

String、属性の値を返します

getAttributeNS

名前空間 URI と名前によって属性値を取得する

1
2
String XmlElement.getAttributeNS(String namespaceURI,
    String localName);

呼び出しパラメータ:

namespaceURI: クエリの名前空間 URI を指定する文字列
localName: 文字列。クエリの属性名を指定します。

返される結果:

String、属性の値を返します

setAttribute

新しいプロパティを作成または変更する

1
2
XmlElement.setAttribute(String name,
    String value);

呼び出しパラメータ:

name: 文字列、設定する属性名を指定します
value: 文字列、設定する属性値を指定します

このメソッドは、指定されたプロパティを指定された値に設定します。指定された名前のプロパティが存在しない場合、このメソッドは新しいプロパティを作成します

setAttributeNS

名前空間プロパティを作成または変更する

1
2
3
XmlElement.setAttributeNS(String namespaceURI,
    String qualifiedName,
    String value);

呼び出しパラメータ:

namespaceURI: 文字列、設定する名前空間 URI を指定します
qualifiedName: 文字列、設定する属性名を指定します
value: 文字列、設定する属性値を指定します

このメソッドは setAttribute メソッドと似ていますが、作成または設定される属性が、名前空間 URI と、名前空間プレフィックス、コロン、および名前空間内のローカル名で構成される修飾名によって指定される点が異なります。属性の値を変更するだけでなく、このメソッドを使用して属性の名前空間プレフィックスを変更することもできます。

removeAttribute

指定された属性を名前で削除します

1
XmlElement.removeAttribute(String name);

呼び出しパラメータ:

name: 文字列、削除する属性名を指定します

removeAttributeNS

指定されたプロパティを名前空間と名前で削除します

1
2
XmlElement.removeAttributeNS(String namespaceURI,
    String localName);

呼び出しパラメータ:

namespaceURI: 文字列、削除する名前空間 URI を指定します
localName: 文字列、削除する属性名を指定します

hasAttribute

現在のノードに指定された名前の属性があるかどうかを問い合わせます

1
Boolean XmlElement.hasAttribute(String name);

呼び出しパラメータ:

name: 文字列。クエリの属性名を指定します。

返される結果:

Boolean、現在の要素ノードが指定された属性を持っている場合は true を返し、それ以外の場合は false を返します。

hasAttributeNS

現在のノードに指定された名前空間と名前を持つ属性があるかどうかをクエリします

1
2
Boolean XmlElement.hasAttributeNS(String namespaceURI,
    String localName);

呼び出しパラメータ:

namespaceURI: 文字列。クエリする名前空間 URI を指定します。
localName: 文字列。クエリの属性名を指定します。

返される結果:

Boolean、現在の要素ノードが指定された属性を持っている場合は true を返し、それ以外の場合は false を返します。

getElementsByTagName

指定された名前を持つすべての要素を返しますXmlNodeList

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

呼び出しパラメータ:

tagName: 文字列、取得するタグ名。値「*」はすべてのタグに一致します

返される結果:

XmlNodeList、ノードツリー内の指定されたタグを持つ XmlElement ノードXmlNodeList集める。返される要素ノードの順序は、ソースドキュメント内での出現順序となります。

このメソッドは、指定された要素の子孫ノードを走査し、XmlElement ノードを返します。XmlNodeList指定されたタグ名を持つすべてのドキュメント要素を表すオブジェクト。返される配列内の要素の順序は、ドキュメントのソースコードに出現する順序となります。

XmlDocumentこのインターフェイスは getElementsByTagName メソッドも定義します。このメソッドはこのメソッドに似ていますが、要素の子孫ノードを走査するのではなく、ドキュメント全体を走査します。

getElementsByTagNameNS

指定された名前空間と名前を持つすべての要素を返します。XmlNodeList

1
2
XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
    String localName);

呼び出しパラメータ:

namespaceURI: 文字列。クエリする名前空間 URI を指定します。
localName: 文字列、取得するタグ名。値「*」はすべてのタグに一致します

返される結果:

XmlNodeList、ノードツリー内の指定されたタグを持つ XmlElement ノードXmlNodeList集める。返される要素ノードの順序は、ソースドキュメント内での出現順序となります。

このメソッドは getElementsByTagName メソッドと似ていますが、取得する要素のタグ名が名前空間 URI と名前空間で定義されているローカル名の組み合わせとして指定される点が異なります。

getElementById

指定された id 属性を持つ要素を返します

1
XmlElement XmlElement.getElementById(String id);

呼び出しパラメータ:

id: 文字列、取得する ID

返される結果:

XmlElement、ノードツリー内の指定された id 属性を持つ XmlElement ノード

このメソッドは、指定された要素の子孫ノードを走査し、指定された id 属性を持つ最初のドキュメント要素を表す XmlElement ノードオブジェクトを返します。。

getElementsByClassName

指定されたクラス名を持つすべての要素のノードリストを返します。

1
XmlNodeList XmlElement.getElementsByClassName(String className);

呼び出しパラメータ:

className: 文字列、取得するクラス名

返される結果:

XmlNodeList、ドキュメントツリー内の指定されたクラス名を持つ XmlElement ノードXmlNodeList集める。返される要素ノードの順序は、ソースドキュメント内での出現順序となります。

このメソッドは、XmlNodeListドキュメント内の指定されたクラス名を持つすべての XmlElement ノードを格納するオブジェクト (読み取り専用の配列として処理できます)。これらのノードが格納される順序は、ソースドキュメントに表示される順序と同じです。XmlNodeListオブジェクトは「ライブ」です。つまり、指定されたタグ名を持つ要素がドキュメント内で追加または削除されると、そのコンテンツは必要に応じて自動的に更新されます。

hasChildNodes

子ノードがあるかどうかを問い合わせる

1
Boolean XmlElement.hasChildNodes();

返される結果:

Boolean、子ノードがある場合は true を返し、それ以外の場合は false を返します。

normalize

隣接するテキストノードをマージし、空のテキストノードを削除します

1XmlElement.normalize();

このメソッドは、現在のノードのすべての子孫ノードを走査し、空の Text ノードを削除し、隣接するすべての Text ノードをマージすることでドキュメントを正規化します。この方法は、ノードの挿入または削除後にドキュメントツリーの構造を簡素化するのに役立ちます。

cloneNode

指定されたノードの正確なコピーを作成します

1
XmlNode XmlElement.cloneNode(Boolean deep = true);

呼び出しパラメータ:

deep: ブール値、ディープコピーするかどうか。true の場合、複製されたノードは元のノードのすべての子ノードを複製します。

返される結果:

XmlNode、コピーされたノードを返します

このメソッドは、呼び出されたノードのコピーをコピーして返します。渡された引数が true の場合、現在のノードのすべての子孫ノードも再帰的にコピーされます。それ以外の場合は、現在のノードをコピーするだけです。返されたノードはドキュメントツリーに属しておらず、そのparentNode プロパティは null です。要素ノードがコピーされると、そのすべてのプロパティがコピーされます。

lookupPrefix

現在のノード上の指定された名前空間 URI に一致するプレフィックスを返します。

1
String XmlElement.lookupPrefix(String namespaceURI);

呼び出しパラメータ:

namespaceURI: 文字列。一致する名前空間 URI を指定します。

返される結果:

String、一致するプレフィックスを返し、一致しない場合は null を返します。

lookupNamespaceURI

現在のノード上の指定されたプレフィックスに一致する名前空間 URI を返します。

1
String XmlElement.lookupNamespaceURI(String prefix);

呼び出しパラメータ:

prefix: 文字列、一致するプレフィックスを指定します

返される結果:

String、一致する名前空間 URI を返し、一致しない場合は null を返します。

insertBefore

既存の子ノードの前に新しい子ノードを挿入します

1
2
XmlNode XmlElement.insertBefore(XmlNode newChild,
    XmlNode refChild);

呼び出しパラメータ:

newChild:XmlNode、新しいノードを挿入します
refChild:XmlNode、このノードの前に新しいノードを挿入します

返される結果:

XmlNode、新しい子ノードを返します

newChild がドキュメントツリーに既に存在する場合は、ドキュメントツリーから削除され、新しい位置に再挿入されます。 1 つのドキュメントのノード (または 1 つのドキュメントによって作成されたノード) を別のドキュメントに挿入することはできません。つまり、newChild の ownerDocument 属性は、現在のノードの ownerDocument 属性と同じである必要があります。

insertAfter

既存の子ノードの後に新しい子ノードを挿入します

1
2
XmlNode XmlElement.insertAfter(XmlNode newChild,
    XmlNode refChild);

呼び出しパラメータ:

newChild:XmlNode、新しいノードを挿入します
refChild:XmlNode、このノードの後に新しいノードを挿入します

返される結果:

XmlNode、新しい子ノードを返します

appendChild

新しい子ノードをノードの子ノードリストの末尾に追加します

1XmlNode XmlElement.appendChild(XmlNode newChild);

呼び出しパラメータ:

newChild:XmlNode、追加したノードを指定します

返される結果:

XmlNode、この新しい子ノードを返します

replaceChild

子ノードを別のノードに置き換える

1
2
XmlNode XmlElement.replaceChild(XmlNode newChild,
    XmlNode oldChild);

呼び出しパラメータ:

newChild:XmlNode、新しいノードを指定します
oldChild:XmlNode、置換するノードを指定します

返される結果:

XmlNode, 置換が成功した場合、このメソッドは置換されたノードを返しますが、置換が失敗した場合は null を返します。

removeChild

子ノードのリストからノードを削除します。

1XmlNode XmlElement.removeChild(XmlNode oldChild);

呼び出しパラメータ:

oldChild:XmlNode、削除するノードを指定します

返される結果:

XmlNode, 削除が成功した場合、このメソッドは削除されたノードを返すことができますが、失敗した場合は null を返します。

toString

オブジェクトの文字列表現を返します。通常、「[Native Object]」が返されます。オブジェクトは、独自の特性に従って再実装できます。

1
String XmlElement.toString();

返される結果:

String、オブジェクトの文字列表現を返します。

toJSON

オブジェクトの JSON 形式表現を返します。通常は、オブジェクトによって定義された読み取り可能なプロパティのコレクションを返します。

1
Value XmlElement.toJSON(String key = "");

呼び出しパラメータ:

key: 文字列、使用されません

返される結果:

Value、シリアル化可能な JSON を含む値を返します

開発ガイド

基本モジュール

組み込みオブジェクト

コミュニティモジュール

オブジェクトXml要素

相続関係

メンバーのプロパティ

namespaceURI

prefix

localName

tagName

id

innerHTML

outerHTML

className

attributes

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

メンバー関数

getAttribute

getAttributeNS

setAttribute

setAttributeNS

removeAttribute

removeAttributeNS

hasAttribute

hasAttributeNS

getElementsByTagName

getElementsByTagNameNS

getElementById

getElementsByClassName

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON