データ変換リファレンス

データ変換名前空間の概要や、要素・属性を解説します。

1. 概要

データ変換名前空間の概要を説明します。

1.1. 用途・役割

カット&ペースト、ドラッグ&ドロップ時のデータ変換を実現するために使用する名前空間です。

1.2. 名前空間URI参照

データ変換名前空間URI参照は http://xmlns.xfytec.com/data-transfer です。 以下の説明で、データ変換の要素を記述するときは、dtf:という名前空間プレフィックスを使用します。

このほか、以下の説明中に出現する名前空間と、その名前空間に使用している名前空間プレフィックスは次のとおりです。

2. データ変換名前空間で定義されている要素・属性

データ変換の要素は、次のコマンドインストラクションで使用されます。

また、次のイベント中に参照することが可能です。

また、必要ならば、次のコマンドインストラクションで使用できます。

以下、データ変換名前空間で定義されている要素や属性を解説します。

2.1. データ変換

データ変換機能の要素・属性は以下のとおりです。

dtf:string 要素

カット&ペーストやドラッグ&ドロップで、対象のデータをテキストデータとしたときに貼り付けられるデータを記述する要素です。

属性:

属性はありません。

内容:

dtf:string要素内には、カット&ペーストやドラッグ&ドロップ対象のデータをテキストデータで表現した文字列を記述します。

dtf:fragment 要素

カット&ペーストやドラッグ&ドロップで、対象のデータをXML文書フラグメントとしたときに貼り付けられるデータを記述する要素です。

属性:
independent

yesまたはnoを設定します。yesの場合はボキャブラリとして完全独立なフラグメントであることを表します。noの場合は、ボキャブラリの部分フラグメントであることを表します。

完全独立なフラグメントは、そのフラグメントに含まれる内容だけで対象のボキャブラリの文書として成立するフラグメントです。部分フラグメントは、それだけでは対象のボキャブラリの文書として成立しないフラグメントです。

例えばSVGの場合、svg要素を頂点とするフラグメントは、SVG文書として成り立つので、完全独立なフラグメントということができます。一方、circle要素を頂点とするフラグメントは、それだけではSVG文書にはならないので、部分フラグメントになります。

省略された場合は、noとして扱われます。

内容:

dtf:fragment要素内には、カット&ペーストやドラッグ&ドロップ対象のデータをXML文書フラグメントで表現したデータを記述します。

3. データ変換の補完方法

カット&ペーストやドラッグ&ドロップの対象となるデータにはデータ変換名前空間のXML文書フラグメントを指定します。対象にデータ変換名前空間ではないXML文書フラグメントが指定された場合は、次の方法で補完されます。

  1. 指定されたXML文書フラグメントを内容とするdrf:fragment要素を作成する。
  2. 指定されたXML文書フラグメントに含まれるテキストノードのみを連結したものを内容とするdrt:string要素を作成する。
  3. 作成した2つの要素を持つフラグメントを、カット&ペーストやドラッグ&ドロップの対象のXML文書フラグメントとする。