getStringValues (DOMDocument - JavaScript)

XPath に一致するデータエレメントのストリング値を取得します。

定義場所

構文

getStringValues(xpath:string) : string[]

getStringValues(xpath:string, selectionNS:NamespaceContext) : string[]

パラメータ	説明
`xpath`	文書に関連付けられたエレメントの XPath です。
`selectionNS`	namespace コンテキストです。

戻り値	説明
`string[]`	エレメントのデータ値です。

使用法

このメソッドは DOMElement の getStringValue と同等です。

スキーマでは、これらのデータエレメントを string と定義する必要があります。データプロパティでは、関連あるフィールドの表示タイプが String でなければなりません。

XPath が名前空間プレフィックスを含む場合は、以下のいずれかに従ってください。

第 2 パラメータで名前空間を定義し、最初に新規の DOMNamespaceContextImpl オブジェクトを作成してから addNamespace で名前空間を追加する。
setSelectionNamespaces で名前空間を定義してから、第 2 パラメータを指定せずにこのメソッドを使用する。

例

(1) これは、ボタンの onclick イベントの例です。索引によって指定された文書からエレメントを取得します。requestScope 変数がページの編集ボックスにバインドされているため、ユーザーが i を指定してからボタンをクリックすると、s または msg が返されます。

var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i >= 0 && requestScope.i < dc.getDocumentCount()) {
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var dom = doc.getDOM();
		var s = dom.getStringValues("//element0");
		requestScope.s = s.join(", ");
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}

(2) これは、ボタンの onclick イベントの例です。名前空間を使用して、索引によって指定された文書からエレメントを取得します。requestScope 変数がページの編集ボックスにバインドされているため、ユーザーが i を指定してからボタンをクリックすると、s または msg が返されます。

var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i >= 0 && requestScope.i < dc.getDocumentCount()) {
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var dom = doc.getDOM();
		var ns = new NamespaceContextImpl();
		ns.addNamespace("s", "http://mynamespace.com");
		var s = dom.getStringValues("//s:element0", ns);
		requestScope.s = s.join(", ");
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}