Mozilla の XPointer 界面

[1] Mozilla nsIDOMXMLDocument 界面 (一部):

• evaluateFIXptr
  • 引数 expression (DOMString): FIXptr] 文字列。
  • 返値 (nsIDOMRange): 評価結果の範囲物体 (DOMRange)
  • FIXptr 式を評価
• evaluateXPointer
  • 引数 expression (DOMString): FIXptr 文字列。
  • 返値 (nsIXPointerResult): 評価結果
  • XPointer 式を評価

出典: mozilla/dom/public/idl/core/nsIDOMXMLDocument.idl <http://lxr.mozilla.org/mozilla/source/dom/public/idl/core/nsIDOMXMLDocument.idl>

[2] Mozilla nsIXPointerResult 界面:

• item
  • 引数 index (unsigned long)
• length (読取り専用属性) (unsigned long)

出典: mozilla/content/xml/document/public/nsIXPointer.idl <http://lxr.mozilla.org/mozilla/source/content/xml/document/public/nsIXPointer.idl>

[3] Mozilla nsIXPointerSchemeContext 界面:

• count (読取り専用属性) (unsigned long)
• getSchemeData (void)
  • 引数 index (unsigned long)
  • 引数 scheme (DOMString: 出力)
  • 引数 data (DOMString: 出力)

この界面は nsIXPointerSchemeProcessor が現在評価している scheme およびデータよりも前にあるすべての scheme およびデータの組が得られる文脈 を提供します。

出典: mozilla/content/xml/document/public/nsIXPointer.idl <http://lxr.mozilla.org/mozilla/source/content/xml/document/public/nsIXPointer.idl>

[4] Mozilla nsIXPointerSchemeProcessor 界面:

• evaluate (nsIXPointerResult)
  • 引数 aDocument (nsIDOMDocument): XPointer を解決する文書。
  • 引数 aContext (nsIXPointerSchemeContext): データを処理する XPointer 文脈。
  • 引数 aData (DOMString): 解決する scheme データ。
  • 返値 (nsIXPointerResult): 評価結果。
  • XPointer 式を評価します。

この界面は XPointer 枠組みを実装する XPointer 処理器から、 XPointer 処理器がみつけた scheme 毎の指定に関して順に呼ばれます。

出典: mozilla/content/xml/document/public/nsIXPointer.idl <http://lxr.mozilla.org/mozilla/source/content/xml/document/public/nsIXPointer.idl>

[5] Mozilla nsIXPointerEvaluator 界面:

• evaluate
  • 引数 aDocument (nsIDOMDocument): XPointer 式を評価する文書。
  • 引数 aExpression (DOMString): 評価する XPointer 文字列。
  • 返値 (nsIXPointerResult): 評価結果
  • XPointer 式を評価

出典: mozilla/content/xml/document/public/nsIXPointer.idl <http://lxr.mozilla.org/mozilla/source/content/xml/document/public/nsIXPointer.idl>

XPointerLib の界面

[6] XPointerLib (Mozilla 向けに開発されていた古いライブラリ) nsIXPointerService 界面:

• XPOINTERLIB_NS (読取り専用属性、string): XPointerLib 名前空間。 DOM_IGNORE_ELEMENT_ATTRIBUTE はこの名前空間に属する。
• DOM_IGNORE_ELEMENT_ATTRIBUTE (読取り専用属性、 string): XPointer 処理・作成時に XPointerLib が要素を無視するかどうかを指定する属性の名前。その属性の値は boolean。
• parseXPointerToRange
  • 引数 xptr (string): XPointer 文字列。
  • 引数 doc (nsIDOMDocument): XPointer を解決する文書。
  • 返値 (nsIDOMRange): XPointer によって示された範囲。
  • 例外 (Exception): XPointer が不正な時
  • XPointer を構文解析して DOM 範囲に。
• parseXPointerToNode
  • 引数 xptr (string): XPointer 文字列。
  • 引数 doc (nsIDOMDocument): XPointer を解決する文書。
  • 返値 (nsiDOMNode): XPointer によって示された範囲を近似した節点。
  • 例外 (Exception): XPointer が不正な時
  • XPointer を構文解析して近似的に DOM 節点に。
• createXPointerFromSelection
  • 引数 seln (nsISelection): 変換する選択。
  • 引数 doc (nsIDOMDocument): 選択を含む文書。
  • 返値 (string): 選択の XPointer 表現。
  • 文書における選択を対応する XPointer に変換。
• createXPointerFromRange
  • 引数 range (nsIDOMRange): 変換する範囲。
  • 引数 doc (nsIDOMDocument): 範囲を含む文書。
  • 返値 (string): 範囲の XPointer 表現。
  • 文書における範囲を対応する XPointer に変換。
• markElement
  • 引数 element (nsIDOMElement): 印を付ける要素。
  • 例外: 印を付けることができない時。
  • 返値 (nsIDOMElement): 印を付けた要素。
  • XPointerLib が作成・解析で無視するように要素に印を付ける。 文書に動的に要素を挿入する時に使用。
• getVersion
  • 返値 (string): XPointerLib の版。

出典: xpointerlib/src/idl/nsIXPointerService.idl - view - 1.6 <http://www.mozdev.org/source/browse/xpointerlib/src/idl/nsIXPointerService.idl?rev=1.6&content-type=text/x-cvsweb-markup>

Mvp.Xml の界面

[7] Mvp.Xml (XPointer.NET) の界面。

出典: Mvp.Xml.XPointer <http://mvp-xml.sourceforge.net/api/Mvp.Xml.XPointer.html>

[8]

• 抽象クラス Pointer: 抽象 XPointer クラス
  • 静的メソッド Compile: XPointer 指示子を構文解析して Pointer 物体に。
    • 引数 xpointer (string): XPointer 指示子。
    • 返値 (Pointer)
  • メソッド Evaluate
    • 引数 nav (XPathNavigator): XPointer 指示子を評価する Navigator。
    • 返値 (XPathNodeIterator): 指示された節点。
• クラス XPointerReader (XmlReader と IHasXPathNavigator を継承)
• クラス XPointerException (Exception を継承)
• クラス XPointerSyntaxException (XPointerException を継承)
• クラス NoSubresourcesIdentifiedException (XPointerException を継承)

メモ

[9] 注意: XPointer に対応しているといっても、 勧告になる前の古い互換性のない仕様に対応しているものだったりすることがよくあります。 (名無しさん [sage])

[10] JavaScript (ECMAScript) による XPointer の実装 <http://suika.fam.cx/www/2005/xpointer-js/xpointer-js-desc#API>

基本設計は Mozilla の実装ですが、 多少都合により変えてあります。 (名無しさん [sage])

[11] XML-Signature で XPointer を使う時、 速記指示子を使ったか scheme による指示子を使ったかで注釈節点の扱いが違ってきます。 つまり、 XML-Signature を実装するためにはどちらの方法で選択したかの情報が必要です。 (あるいは速記指示子による選択で節点集合を返す時に注釈節点を除外できるように実装するのもありか。)

(名無しさん)