XMLフォーム言語（XForms）1.0

3.2.1 共通属性

3.2.2 リンク付け属性

リンクにおける相対URIの振る舞いは，[XML Base]による処理が強く推奨されてはいるが，ホスト言語に依存する。

3.2.3 単一ノード結合属性

ref

XPathとして解釈される結合式。bind属性が指定されている場合，この属性は意味をもたない。

model

XFormsモデルセレクタ。この結合要素に関連付けられるXFormsモデルのIDを指定する。この属性は，bind属性が指定されている場合，この結合要素に関して意味をもたない。XFormsモデルの文脈決定規則については， 7.4 評価文脈 を参照。

bind

bind要素への参照。

ref又はbindのいずれかを指定する必要がある。bindが指定された場合，ノードは参照先のbindによって決定される。

model属性に指定されたIDREFがmodel要素上にはないIDを指している場合，又はbind属性に指定されたIDREFがbind要素上にはないIDを指している場合，XFormsプロセサは例外( 4.5.1 xforms-binding-exceptionイベント )を発生させる。

先頭ノード規則：サイズが1を超えるノード集合が単一ノード結合属性に割り当てられている場合，ノード集合の中から文書順で先頭のノードが使われる。

3.2.4 ノード集合結合属性

nodeset

XPathとして解釈される結合式。bind属性が指定されている場合，この属性は意味をもたない。

model

XFormsモデルセレクタ。この結合要素に関連付けられるXFormsモデルのIDを指定する。この属性は，bind属性が指定されている場合，この結合要素に対して意味をもたない。XFormsモデルの文脈決定規則については， 7.4 評価文脈 を参照。

bind

bind要素への参照。

nodeset又はbindのいずれかを指定する必要がある。bindが指定された場合，ノード集合は参照先のbindによって決定される。

model属性に指定されたIDREFがmodel要素上にはないidを指している場合，又はbind属性に指定されたIDREFがbind要素上にはないidを指している場合，XFormsプロセサは例外( 4.5.1 xforms-binding-exceptionイベント )を発生させる。

3.2.5 モデル項目特性属性

この集合はモデル項目特性のそれぞれに対応して属性を一つ含む。この属性の名前は， 6.1 モデル項目特性定義 で定義されているモデル項目特性の名前に正確に一致する。

3.3.1 model要素

共通属性：共通, イベント

オブザーバの作成を容易にするために，XMLイベントの属性を使用することができる。この要素はXFormsアクションではなく，イベントベースの振る舞いは事前定義されていない。

特殊属性：

functions

省略可能。このXFormsモデルに必要なXPath拡張関数(QNamesで表される。)のスペース区切りのリスト。この属性の使用方法については 7.12 拡張関数 を参照。

schema

省略可能。このmodel要素の外にあるXMLスキーマ文書を指すxsd:anyURIのリスト。XFormsプロセサはこの属性にリストされたすべてのスキーマを処理しなければならない。個々のXFormsモデルには，名前空間宣言当たり一つのスキーマという制限があり，これには内部のスキーマ及びリンクされたスキーマも含まれる。

備考：

schemaリストは，XFormsを含んでいる文書内の他の場所にある要素を指す“#myschema”などのURI素片を含んでもよい。

modelの使用方法の単純な例を示す。ここでは，XForms名前空間は指定されていない。

<model id="Person" schema="MySchema.xsd">
  <instance src="http://example.com/cgi-bin/get-instance" />
  ...
</model>

3.3.2 instance要素

共通属性：共通

特殊属性：

リンク付け属性

省略可能。外部定義された初期インスタンスデータへのリンク。リンク走査に失敗した場合，例外( 4.5.2 xforms-link-exceptionイベント )として処理する。

この属性及び行内内容の両方が提供された場合， 4.2.1 xforms-model-constructイベント に規定しているとおり，リンクが優先する。

初期インスタンスデータがリンクによって指定された場合，インスタンスデータは，リンクされた資源のXPathデータモデルを作成することで形成される。

初期インスタンスデータが行内内容によって指定された場合，インスタンスデータは，最初に行内内容の分離コピー（外側の祖先から継承された名前空間を含む。）を作成し，その分離コピー上にXPathデータモデルを作成することで得られる。この分離コピーは，独立した別の文書として存在する場合に整形式XMLとなり得るものでなければならない。つまり，instanceの要素内容は単一の子要素に制限される。

行内内容でインスタンスが指定されたとき，XML誤りが原因で分離コピーを作成できなかった場合，処理はxforms-link-exceptionで停止することが望ましい。この誤りは，例えば，行内内容に二つの要素ノードがあり，それが，ドキュメント要素が二つ存在するXML文書の作成を意味している場合などに発生する。

3.3.3 submission要素

この要素は，送付の対象及び方法についての宣言的な指示を表す。送付処理の詳細については， 11. 送付 を参照。

共通属性：共通

特殊属性：

bind

省略可能。bind要素への参照。この属性が指定された場合, ref属性に指定されたどの結合参照よりも優先する。

ref

省略可能。インスタンスデータの部分送付を可能にするセレクタ結合式。選択されたノード及びそのすべての子孫が送付対象となる。 デフォルト値は“/”とする。

action

必須。インスタンスデータの送付先URI。リンクにおける相対URIの振る舞いは，[XML Base]による処理が強く推奨されてはいるが，ホスト言語に依存する。

method

必須。直列化されたインスタンスデータの送付に使われるプロトコルを示す。デフォルトの値はない。

version

省略可能。直列化されるXMLの版数を示す属性。

indent

省略可能。直列化するときに読みやすくするための空白ノードを挿入するべきかどうかを示す属性。

mediatype

省略可能。XMLインスタンスの直列化のためのメディア型を示す属性。文書作成者は，指定した型がapplication/xmlと互換性があることを確実にすることが望ましい。

encoding

省略可能。直列化のための符号化を示す属性。

omit-xml-declaration

省略可能。インスタンスデータの直列化の際にXML宣言を省略するかどうかを示す属性。

standalone

省略可能。直列化されるXMLにstandalone宣言を含めるかどうかを示す属性。

cdata-section-elements

省略可能。CDATAセクションを伴う形式で直列化する要素名を示す属性。

replace

省略可能。送付実行後に返された情報をどのように処理するかを示す属性。この属性が指定されなかった場合，“all”が仮定される。

separator

省略可能。URL符号化において，名前及び値の組のそれぞれを区切る文字を示す属性。省略時の値は';'とする。

includenamespaceprefixes

省略可能。名前空間の直列化に対する制御を指定する属性。指定しなかった場合は，インスタンスデータ内のすべての名前空間ノードが直列化の対象になる。指定する場合，明示的に使用されるものを除いた，直列化の対象とする名前空間接頭辞のリストを指定する。[Exc-C14N]にあるように, 特別な値#defaultは，デフォルトの名前空間を示す。

次の例は，submission要素のさまざまなオプションがapplication/xmlとしての直列化にどのように影響するかを示す。次のXFormsの素片を考える。

<xforms:model xmlns:xforms="http://www.w3.org/2002/xforms"
              xmlns:my="http://ns.example.org/2003">
  <xforms:instance>
    <qname xmlns="">my:sample</qname>
  </xforms:instance>
  <xforms:submission method="post" action="..."/>
</xforms:model>

includenamespaceprefixes属性が指定されていないため，すべての名前空間ノードが直列化される。結果として直列化されるインスタンスデータは次のとおりになる。

<qname xmlns:xforms="http://www.w3.org/2002/xforms"
       xmlns:my="http://ns.example.org/2003">my:sample</qname>

特に，XForms名前空間が直列化されていることに注意する。この例で，必要なmy接頭辞を維持しながら，不要なXForms名前空間を含めないようにするには，includenamespaceprefixes="my"をsubmission要素に追加しなければならない。この属性を指定する場合，文書作成者は，送付されたインスタンスデータによって非明示的に使用されるすべての名前空間接頭辞を指定しなければならない。

次の属性は，"yes"|"no"ではなくxsd:booleanを使用することを除いて，[XSLT 1.0]のoutput要素の属性と(つづり，処理及びデフォルト値の点で)同一とする。

version
indent
encoding
omit-xml-declaration
cdata-section-elements

XFormsアクションモジュールで定義される要素は, そのモジュールが取り込まれる場合, submission内容モデルでも許可される。

3.3.4 bind要素

bind要素は，nodeset属性に指定されているモデル結合式によって，インスタンスデータからノード集合を選択する。bind要素の他の属性には，ノード集合の個々のノードに適用されるモデル項目特性が符号化されている。 bindにxsd:ID型の属性が存在する場合, bindはその識別子を選択されたノード集合に関連付ける。

共通属性：共通, モデル項目特性

特殊属性：

nodeset

bindが作用するノードの集合を示すモデル結合式。モデル結合式は， 7.5.2 モデル結合式 に定義されている。

insertアクションによってノードが追加されたとき，新しく追加されたノードは結合式に一致するすべてのノード集合に含められる。 9.3.5 insert要素 のinsertアクションを参照。

評価文脈に対する結合の影響の詳細については， 7.4 評価文脈 を参照。

3.5.1 extension要素

共通属性：共通

例えば, 次のとおりにRDFメタデータをフォーム制御に追加できる。

<input ref="dataset/user/email" id="email-input">
  <label>電子メールアドレスを入力してください</label>
  <extension>
    <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
      <rdf:Description rdf:about="#email-input">
        <my:addressBook>personal</my:addressBook>
      </rdf:Description>
    </rdf:RDF>
  </extension>
</input>

4.2.1 xforms-model-constructイベント

1. すべてのXMLスキーマを読み込む。遠隔の文書にアクセス又は遠隔の文書を処理しているときに誤りが発生した場合，処理は例外（ 4.5.2 xforms-link-exceptionイベント ）を生成して終了する。

2. 初期インスタンスデータ用に外部ソースが指定されている場合，それからXPathデータモデル（ 7. XFormsにおけるXPath式 ）を構築する。外部ソースが指定されず，内部の初期インスタンスデータが指定されている場合は，それを代わりに使用する。外部の初期インスタンスデータが整形式XMLでない又は取得できない場合，処理は例外（ 4.5.2 xforms-link-exceptionイベント ）を生成して終了する。いずれも指定されていない場合，この過程ではデータモデルを構築せず，利用者インタフェース構築（ 4.2.2 xforms-model-construct-doneイベント ）の過程で構築する。

3. 該当する場合，P3P[P3P 1.0]を初期化する。

4. インスタンスデータを構築する。インスタンスデータに挿入される文字列はすべて，Unicode正規化の対象となる。bind要素をすべて文書順に処理することで，すべてのモデル項目特性を初期化する。各bind要素に対して行う処理は次のとおり。

   1. bind要素のnodeset属性を評価し，ノード集合を選択する。

   2. ノード集合の各ノードに対して，bind要素内の残りの属性に従ってモデル項目特性を適用する。各属性（ 6.1 モデル項目特性定義 で定義される特性に一致する名前をもつ）の文字列値を同じ名前のモデル項目特性の局所値として複写する。

   3. 同名のモデル項目特性がノードに既に含まれている場合，このXFormsを含んでいる文書のXForms処理は例外（ 4.5.1 xforms-binding-exceptionイベント ）を生成して終了する。

5. このmodel要素に対して，xforms-rebuild，xforms-recalculate，xforms-revalidateを順番に実行する（利用者インタフェースがまだ初期化されていないため，xforms-refreshは実行しない。）。

すべてのXFormsモデルが初期化された後，xforms-model-construct-doneイベントが各model要素に振り分けられる。

4.2.2 xforms-model-construct-doneイベント

1. instanceへの最初の参照では，次に示す規則に従って，デフォルトのinstanceを作成する。

   1. ルートinstanceData要素を作成する。

   2. 利用者インタフェース制御の結合式を使用して，インスタンスデータ要素ノードをnameとして作成する。nameがQNameとして妥当でない場合，処理は例外（ 4.5.1 xforms-binding-exceptionイベント ）を生成して終了する。

2. （自動的に作成された）instanceへの２回目以降の参照では，次の処理を行う。

   1. 一致するインスタンスデータノードが見つかった場合，利用者インタフェース制御をその要素に関連付ける。

   2. 一致するインスタンスデータノードが見つからない場合，利用者インタフェース制御の結合式を使用して，インスタンスデータノードをnameとして作成する。nameがQNameとして妥当でない場合，処理は例外（ 4.5.1 xforms-binding-exceptionイベント ）を生成して終了する。

すべてのフォーム制御が初期化された後，xforms-readyイベントが各model要素に振り分けられる。

4.2.3 xforms-readyイベント

4.2.4 xforms-model-destructイベント

4.3.1 xforms-next及びxforms-previousイベント

4.3.2 xforms-focusイベント

4.3.3 xforms-help及びxforms-hintイベント

4.3.4 xforms-refreshイベント

4.3.5 xforms-revalidateイベント

1. model中のすべてのinstance要素中のすべてのインスタンスデータノードを指定されたすべてのXMLスキーマ及び関連するXMLスキーマデータ型に照らして検査する。その際，次の規則を使用する。

   1. 要素のXMLスキーマ妥当性は，局所的に有効な属性ノード，要素ノード及びテキストノードによって判定する。PSVIによって示される誤りコードの一覧にcvc-attribute.3だけしか含まれていない場合，その要素は依然妥当であるとする。これは，属性が妥当でないことでその属性を所有する要素の妥当性が失われることはないことを意味する。

   2. 属性ノードのXMLスキーマ妥当性は，XMLスキーマで定義されている“Attribute Locally Valid”の規則で判定する。

   3. テキストノードのXMLスキーマ妥当性は，String Validによって定義される，モデル結合によって関連付けられる型定義についての，正規化されたノードの内容の局所的な妥当性として定義する。テキストノードに型が関連付けられていない場合，常に妥当とする。

2. model中のすべてのinstance要素中のすべてのインスタンスデータノードを，required，constraintなど，値に対する制約を定義する結合されたすべてのモデル項目特性に照らし検査する ( 6. モデル項目特性 )。

3. 対応するモデル項目特性の評価結果がこのイベント処理の開始時と一致しないフォーム制御に対して，適切な通知イベント（ 4.4.6 xforms-validイベント ， 4.4.7 xforms-invalidイベント ， 4.4.10 xforms-readonlyイベント ， 4.4.11 xforms-readwriteイベント ， 4.4.12 xforms-requiredイベント ， 4.4.13 xforms-optionalイベント ， 4.4.14 xforms-enabledイベント ， 4.4.15 xforms-disabledイベント ）を振り分ける。

4.3.6 xforms-recalculateイベント

モデル項目特性を再計算するときにXPath式が評価されるが，その評価文脈は， 7.4 評価文脈 で計算される式に対して定義されているとおりに，そのモデル項目特性を適用するモデル結合式によって決まる。XPath式で他のインスタンスノードを参照（reference）又は言及（refer to）してもよいが，その場合はそのインスタンスノードの値が参照される。参照される各インスタンスノードから見た場合，そのインスタンスノードを直接参照するそれらの代入式はそのインスタンスノードに依存するものとする。計算式における現在のノード値への参照は明白に無視される。すなわち，ある代入式内でその代入式が関連付けられているインスタンスノードを参照している場合，そのインスタンスノードはそれ自身に依存しない。あるインスタンスノードから代入式に至る依存の経路がある場合（他のインスタンスノードを経由する場合も含める。），代入式にとってそのインスタンスノード（値は計算されるものでも，そうでなくてもよい。）は計算に必要なものとする。代入式が自身を計算に必要とする場合，その代入式は循環依存の一部とする。

再計算イベントの開始時には，例えば，利用者入力がインスタンスに伝ぱしたことによって値が変更されている一つ以上のインスタンスノードのリストLが存在する。

1. XFormsプロセサは，L中のいずれの要素も計算に必要としない代入式については再計算を行わないほうがよい。

2. XFormsプロセサは，L中の一つ以上の要素を計算に必要とする代入式について，再計算を１回だけ実行することが望ましい。

3. XFormsプロセサは，代入式Cの再計算を，Cが必要とするすべてのインスタンスノードの代入式の再計算の後に行わなければならない（同様に，XFormsプロセサは，Cに関連付けられているインスタンスノードを計算に必要とするすべての代入式の再計算の前に，代入式Cを再計算しなければならない。）。

4. 最後に，代入式が循環依存の一部であり，L中の要素を計算に必要とする場合，XFormsプロセサは例外（ 4.5.4 xforms-compute-exceptionイベント ）を報告しなければならない。

附属書D 再計算順序アルゴリズム では，適切な再計算動作を達成する方法の一つについて説明している。

4.3.7 xforms-rebuildイベント

4.3.8 xforms-resetイベント

4.3.9 xforms-submitイベント

11. 送付 を参照。

4.4.1 DOMActivateイベント

4.4.2 xforms-value-changedイベント

4.4.3 xforms-select及びxforms-deselectイベント

4.4.4 xforms-scroll-first及びxforms-scroll-lastイベント

4.4.5 xforms-insert及びxforms-deleteイベント

4.4.6 xforms-validイベント

4.4.7 xforms-invalidイベント

4.4.8 DOMFocusInイベント

4.4.9 DOMFocusOutイベント

4.4.10 xforms-readonlyイベント

4.4.11 xforms-readwriteイベント

4.4.12 xforms-requiredイベント

4.4.13 xforms-optionalイベント

4.4.14 xforms-enabledイベント

4.4.15 xforms-disabledイベント

4.4.16 xforms-in-rangeイベント

4.4.17 xforms-out-of-rangeイベント

4.4.18 xforms-submit-doneイベント

4.4.19 xforms-submit-errorイベント

11. 送付 で定義されている送付処理の失敗の指示として振り分けられる。

ターゲット：submission

バブル：はい

取消し可能：いいえ

文脈情報：失敗した送付メソッドURI（xsd:anyURI）

このイベントは通知イベントであり，このイベントに対するデフォルトアクションは存在しない。

4.5.1 xforms-binding-exceptionイベント

4.5.2 xforms-link-exceptionイベント

4.5.3 xforms-link-errorイベント

4.5.4 xforms-compute-exceptionイベント

4.6.1 input, secret，textarea，range及びupload制御の場合

• フォーム制御が対話的に変更され，incremental="true"が設定されているとき， 4.6.7 シーケンス：フォーカスの変更を伴う値の変更 で規定しているイベント列を実装に依存する間隔で起動してもよい。

• フォーム制御が対話的に変更され，incremental="true"が設定されていないとき，イベント振分けの必要はない。したがって，順序は定義されない。

• フォーカスがフォーム制御から変更され，値が変更されているとき，イベント列は 4.6.7 シーケンス：フォーカスの変更を伴う値の変更 で規定しているとおりになる。

4.6.2 output制御の場合

4.6.3 select又はselect1制御の場合

• 選択が対話的に変更され，incremental="true"が設定されているとき，イベント列は 4.6.6 シーケンス：値の変更を伴わない選択 に規定しているとおりになり，この直後に 4.6.7 シーケンス：フォーカスの変更を伴う値の変更 に規定している列が続いてもよい。

• フォーム制御が対話的に変更され，incremental="true"が設定されていないとき，イベント順序は 4.6.6 シーケンス：値の変更を伴わない選択 に規定しているとおりになる。

• フォーカスがフォーム制御から変更され，値が変更されているとき，イベント列は 4.6.7 シーケンス：フォーカスの変更を伴う値の変更 で規定しているとおりになる。

4.6.4 trigger制御の場合

• フォーム制御の活性化によって， 4.6.8 シーケンス：トリガの活性化 で定義されるイベント列が発生する。

4.6.5 submit制御の場合

• フォーム制御の活性化によって， 4.6.8 シーケンス：トリガの活性化 で定義されるイベント列が発生し，直後に 4.6.9 シーケンス：送付 で定義されるイベント列が発生する。

4.6.6 シーケンス：値の変更を伴わない選択

4.6.7 シーケンス：フォーカスの変更を伴う値の変更

4.6.8 シーケンス：トリガの活性化

4.6.9 シーケンス：送付

5.2.1 xforms:listItem

5.2.2 xforms:listItems

5.2.3 xforms:dayTimeDuration

5.2.4 xforms:yearMonthDuration

6.1.1 type特性

6.1.2 readonly特性

6.1.3 required特性

次に示すことを除き，requiredモデル項目特性は可視性，フォーカス又はナビゲーション順に関してXForms利用者インタフェースにヒントを提供しない。XFormsの文書作成者は，requiredデータを受け入れるフォーム制御を可視化することを強く求められる。XFormsプロセサはフォーム制御が必須であることを示唆してもよく，ナビゲーションの制限を含む，即時フィードバックを提供してもよい。 4. 処理モデル に，どのようにXFormsプロセサが必須値を強要するのかについての詳細な説明がある。

<instance>
  <my:person-name>
    <my:first-name>Roland</my:first-name>
    <my:last-name />
  </my:person-name>
</instance>
<bind nodeset="/my:person-name/my:last-name" required="true()"/>

6.1.4 relevant特性

<instance>
  <my:order>
    <my:item>
      <my:amount />
      <my:discount>100</my:discount>
    </my:item>
  </my:order>
</instance>
<bind nodeset="my:item/my:discount" readonly="true()"
      relevant="../my:amount &gt; 1000"/>

6.1.5 calculate特性

XFormsモデルは他の値から計算されるモデル項目を含んでもよい。例えば，各品目の数量及び単価の積の合計, 注文に支払われる税金の量などの計算値は，他のモデル項目の値を使用する計算される式として表現することができる。 4. 処理モデル で，計算がいつ，どのように実行されるのかについて詳細に説明している。

<instance>
  <my:order>
    <my:item>
      <my:amount />
      <my:discount />
    </my:item>
  </my:order>
</instance>
<bind nodeset="my:item/my:discount" calculate="../my:amount * 0.1"
      relevant="../my:amount &gt; 1000"/>

6.1.6 constraint特性

XPathがfalseと評価されるとき，関連付けられるモデル項目は妥当ではない。逆は必ずしも真ではない。 4. 処理モデル で，いつ，どのように制約が計算されるのか及び妥当性検証がいつ実行されるのかについて詳細に説明している。

<instance>
  <my:range>
    <my:from />
    <my:to />
  </my:range>
</instance>
<bind nodeset="my:to" constraint=". &gt; ../my:from" />

6.1.7 p3ptype特性

このモデル項目特性は，P3Pデータ型システム[P3P 1.0]に基づき，関連付けられるインスタンスデータノードによって収集されるデータの種類についての情報を保持する。この情報は，既知のデータを供給するなど，フォーム入力を楽にするための機能として使用されてもよい。

<instance>
  <my:person-name>
    <my:first-name />
    <my:last-name />
  </my:person-name>
</instance>
<bind type="my:nonEmptyString" nodeset="my:first-name"
      p3ptype="user.name.given"/>

6.2.1 原子データ型

1. インスタンスデータに関連付けられるXMLスキーマ

2. インスタンスデータ内のXMLスキーマxsi:type属性

3. XForms結合を使用してインスタンスデータノードと関連付けられるXFormsのtype制約

4. 型制約が提供されない場合，インスタンスデータノードはtype="xsd:string"となる（文字列をデフォルトとする規則）。

次に示すデータ型の定義は，xsd:stringを基本とし，制約ファセットが追加されたものとする。

<xsd:simpleType name="nonEmptyString">
  <xsd:restriction base="xsd:string">
    <xsd:minLength value="1"/>
  </xsd:restriction>
</xsd:simpleType>

<my:first-name xsi:type="my:nonEmptyString"/>

<instance>
  <my:first-name />
</instance>
<bind type="my:nonEmptyString" nodeset="/my:first-name"/>

7.3.1 getInstanceDocument()メソッド

7.3.2 rebuild()メソッド

7.3.3 recalculate()メソッド

7.3.4 revalidate()メソッド

7.3.5 refresh()メソッド

7.5.1 動的依存性

7.5.2 モデル結合式

モデル結合式は，モデル項目特性を宣言するのに使用できる結合式であり，bind要素の属性で使用される。

通常，モデル結合式内の動的依存性は手動による依存性の再構築を必要とする。

7.5.3 UI結合式

結合参照は，ここで記述するとおりに，フォーム制御をその背後にあるインスタンスデータに結合するために使用される。属性名ref及びnodesetは，それぞれ単一ノードとノード集合とを区別する。 3.2.3 単一ノード結合属性 及び 3.2.4 ノード集合結合属性 を参照。

UI結合式内では，動的依存性は適合プロファイルに基づいて許可される。

7.5.4 他のXML語い(彙)内でのUI結合

XFormsの結合メカニズムは，他のXML語い(彙)がここに示す任意の方法を使用して利用者インタフェース制御をXFormsモデルに結合することを可能にしている。例として，XForms結合属性bindは，XHTML 1.x利用者インタフェース制御内で次のとおりに使用される。 3.2.3 単一ノード結合属性 及び 3.2.4 ノード集合結合属性 を参照。

<html:input type="text" name="..." xforms:bind="fn"/>

7.5.5 結合の例

<xforms:model id="orders">
  <xforms:instance xmlns="">
    <orderForm>
      <shipTo>
        <firstName>John</firstName>
      </shipTo>
    </orderForm>
  </xforms:instance>
  <xforms:bind nodeset="/orderForm/shipTo/firstName" id="fn" />
</xforms:model>

<xforms:input ref="/orderForm/shipTo/firstName">... 

<xforms:input bind="fn">... 

<xforms:input model="orders" ref="/orderForm/shipTo/firstName">... 

7.7.1 boolean-from-string()関数

7.7.2 if()関数

7.8.1 avg()関数

7.8.2 min()関数

7.8.3 max()関数

7.8.4 count-non-empty()関数

7.8.5 index()関数

関数indexは，repeatのIDREFを示す文字列型の引数を採り，指定されているrepeatの1を基準とする現在の繰返しインデクスを返す。repeat及びそれに関連する繰返しインデクスの詳細については 9.3.1 repeat要素 を参照。指定された引数がrepeatを特定できるものでない場合，NaNを返す。

<xforms:trigger>
  <xforms:label>Add to Shopping Cart</xforms:label>
  <xforms:insert ev:event="DOMActivate" position="after"
                 nodeset="items/item" at="index('cartUI')"/>
</xforms:trigger>

7.9.1 property()関数

versionは，XForms 1.0の場合，文字列“1.0”のとおりに定義される。

conformance-level文字列は 12. 適合性 で定義される。

<xforms:instance>
  ...
  <xforms:bind nodeset="message"
               calculate="concat( 'created with XForms ', property('version'))"/>
...
</xforms:instance>

7.10.1 now()関数

7.10.2 days-from-date()関数

7.10.3 seconds-from-dateTime()関数

7.10.4 seconds()関数

7.10.5 months()関数

7.11.1 instance()関数

<xforms:instance xmlns="" id="orderform">
  <orderForm>
    <shipTo>
      <firstName>John</firstName>
    </shipTo>
  </orderForm>
</xforms:instance>

ref="instance('orderform')/shipTo/firstName"

8.1.1 すべてのフォーム制御に共通の実装必要条件

XForms利用者インタフェース制御は， 6. モデル項目特性 で定義される結合属性を使用して，背後にあるインスタンスデータに結合される。

フォーム制御は，ラベル, ヘルプ文, ナビゲーション, 及びキーボードのショートカットキーなどの各機能において統一的な手法を採用することによって，アクセシビリティを実現する。国際化の問題については，XHTMLと同じ設計指針に従うことで解決される。フォーム制御はすべて，聴覚メディア及び視覚メディアとして提示するのに適している。

フォーム制御は，具体的な実装を提供する能力を維持しながら，抽象度の高い意味をカプセル化する。例えば，フォーム制御selectは，利用者に集合から項目を選択させるものとする。これらのフォーム制御では，基底にある制御の機能的な側面と，提示又は振る舞いの側面とは区別される。この分離によって，特定のフォーム制御の基底にある目的を表現することが可能になる。この利用者との対話の基本概念の定義については[AUI97]を参照。

フォーム制御は，可視化されたとき，そのフォーム制御に結合している背後にあるデータの値を表示する。フォーム制御を介して利用者に提示されるデータは，結合しているインスタンスデータに直接対応しなければならないが，表示形式が字句値と一致している必要はない。例えば，利用者エージェントは，区切り文字も含め，日付，時刻，期間及び数値を表示するのに適切な規約を使用することが望ましい。

フォーム制御はすべて，実装についての次の要求事項を満たさなければならない。

• simpleContentをインスタンスデータに書き込むフォーム制御は，XForms動作 10.1.9 setvalue要素 で定義されるのと全く同じに動作しなければならない。

• simpleContentのインスタンスデータを読み込むフォーム制御はすべて，次のように動作しなければならない。

  • 要素ノード:テキスト子ノードが存在する場合，最初のテキスト子ノードの文字列の値を返す。そうでなければ“”（空の文字列）を返す。

  • 属性ノード: ノードの文字列の値を返す。

  • テキストノード : ノードの文字列の値を返す。

  • 名前空間，処理命令，コメント及びXPathのルートノード：振る舞いは未定義とする。

• フォーム制御は，妥当な状態のときの可視化と妥当でない状態のときの可視化とを区別しなければならない。この振る舞いはスタイルシートから制御可能にすることが望ましい。

• フォーム制御は，結合しているインスタンスデータにそのフォーム制御で可視化できない値が含まれている場合に，それを示さなければならない。この振る舞いはスタイルシートから制御可能にすることが望ましい。

• フォーム制御は，要求に応じて，妥当性又は関連するモデル項目特性などのフォーム制御の現在の状態について説明を可視化しなければならない。この振る舞いはスタイルシートで制御可能にすることが望ましい。

• 利用者指定の説明が利用不可能な場合，フォーム制御は上記のものにデフォルトの説明を提供しなければならない。

8. フォーム制御 では，次を指定することによってさまざまなフォーム制御を定義する。

説明
共通属性
特殊属性
例
データ結合制限
実装必要条件

8.1.2 input要素

共通属性：共通，UI共通，単一ノードUI結合

特殊属性：

入力モード

このフォーム制御は入力モードのヒントを受け入れる。 附属書E 入力モード を参照。

incremental

trueの場合，このフォーム制御はxforms-value-changedイベントを追加生成する。この属性のデフォルト値はfalse。

例：

<input ref="order/shipTo/street" class="streetAddress">
  <label>市町村及び番地</label>
  <hint>市町村名及び番地を入力してください。</hint>
</input>

上の例では，class属性はフォーム制御の表示サイズを指定するためにスタイルシートで使用される。入力できる文字数に関する制約はこれらの表示上の特性から得られるのではなく，背後にあるXFormsモデル定義から得られる。

上の例のグラフィカルブラウザでの可視化の例を次に示す。

データ結合制限：任意のsimpleContent(xsd:base64Binary，xsd:hexBinary又はこれらから派生した任意のデータ型を除く。)に結合。

実装必要条件：結合されたデータ型に対応する字句値の入力を許可しなければならない。実装は，データ型の入力のための便利な手段を提供することが望ましく，数の表現などの現地化及び国際化の問題も考慮に入れることが望ましい。例えば，xsd:date型のインスタンスデータノードと結合しているinputでカレンダー制御を提供すること，同様に，boolean型と結合しているinput制御をチェックボックスとして可視化することが考えられる。

<input ref="order/shipDate">
<label>発送日</label>
<hint>この注文品の発送日を入力してください。</hint>
</input>

上の例のグラフィカルブラウザでの可視化の例を次に示す。

利用者は，テキスト編集ボックスに日付を入力するか，ボタンを押してカレンダーを開くことができる。

8.1.3 secret要素

共通属性：共通，UI共通，単一ノード結合

特殊属性：

入力モード

このフォーム制御は入力モードのヒントを受け入れる。 附属書E 入力モード を参照。

incremental

trueの場合，このフォーム制御はxforms-value-changedイベントを追加生成する。この属性のデフォルト値はfalse。

例：

<secret ref="/login/password">
  <label>パスワード</label>
  <hint>入力するパスワードは表示されません。</hint>
</secret>

上の例のグラフィカルブラウザでの可視化の例を次に示す。

データ結合制限：inputと同じ。

実装必要条件：アクセシビリティを考慮しているものも含め，実装は，このフォーム制御に入力される値を隠さなければならない。考えられる一つの方法として，実際に入力された文字の代わりに“*”又は同様の文字を可視化する方法がある。これによって提供されるセキュリティのレベルは簡略的なものにすぎないことに注意する必要がある。機密性が非常に高い情報を扱うには，XFormsで論じる範囲を超えた，別のセキュリティ対策が必要になる。

8.1.4 textarea要素

共通属性：共通，UI共通，単一ノード結合

特殊属性：

入力モード

このフォーム制御は入力モードのヒントを受け入れる。 附属書E 入力モード を参照。

incremental

trueの場合，このフォーム制御はxforms-value-changedイベントを追加生成する。この属性のデフォルト値はfalse。

例：

<textarea ref="message/body" class="messageBody">
<label>メッセージ本文</label>
<hint>メッセージをここに入力してください。</hint>
</textarea>

上の例では，class属性はフォーム制御の表示サイズを指定するためにスタイルシートで使用される。入力できる文字数に関する制約はこれらの表示上の特性から得られるのではなく，背後にあるXFormsモデル定義から得られる。

上の例のグラフィカルブラウザでの可視化の例を次に示す。

データ結合制限：xsd:string又は派生した任意のsimpleContentに結合。

実装必要条件：複数行のテキストを含む，結合するデータ型に対応する字句値の入力を許可しなければならない。

8.1.5 output要素

共通属性：共通，単一ノード結合 (省略可能)

特殊属性：

appearance

このフォーム制御はUI共通属性グループを使用しないが，上で定義したとおりに，appearance属性は含んでいる。

value

評価対象のXPath式。評価結果の文字列がフォーム制御によって可視化される。結合属性がノードを選択するために存在する場合，この属性は無効になる。評価文脈は，単一ノード結合の評価に適用されるものと同じとする。式が参照するいずれかのノードに変更があった場合，XPath式は常に再評価される。

例：

請求額：
<output ref="order/totalPrice"/>
 円 - 請求理由は次のとおりです：

上の例のグラフィカルブラウザでの可視化の例を次に示す。

データ結合制限：任意のsimpleContentに結合。

実装必要条件：結合されたデータ型に対応する字句値の表示を許可しなければならない。実装は，データ型の視覚化のための便利な手段を提供し，数値の表現などの現地化及び国際化の問題を考慮することが望ましい。

8.1.6 upload要素

共通属性：共通，UI共通，単一ノード結合

特殊属性：

mediatype

アップロードの対象となり得るデータのソースを決定するのにXFormsプロセサによって使用される，スペースによって区切られたメディア型の一覧。

incremental

trueの場合，このフォーム制御はxforms-value-changedイベントを追加生成する。この属性のデフォルト値はfalse。

例：

<upload ref="mail/attachment" mediatype="image/*">
  <label>画像を選択：</label>
  <filename ref="@filename" />
  <mediatype ref="@mediatype" />
</upload>

上の例のグラフィカルブラウザでの可視化の例を次に示す。

実装必要条件：

• 活性化されたとき，子要素filenameが存在してファイル名が利用可能な場合，uploadはアップロードするデータのファイル名をインスタンス内の，子要素filename上の結合属性によって示されるノードに置く。

• 活性化されたとき，子要素mediatypeが存在してメディア型が利用可能な場合，uploadはアップロードするデータのメディア型をインスタンス内の，子要素mediatype上の結合属性によって示されるノードに置く。

データ結合制限：xsd:anyURI，xsd:base64Binary及びxsd:hexBinary，又はこれらから制限によって派生したデータ型だけにこのフォーム制御を結合できる。

実装必要条件：base64Binary又はhexBinaryデータ結合に関して

• xsd:base64binary，xsd:hexBinary又はこれらから制限によって派生した型のインスタンスデータノードに結合されている場合，活性化されたときに，uploadは指定された符号化を使用してバイナリの内容をノードの内容として配置する。

実装必要条件：anyURIデータ結合に関して

• xsd:anyURI型（又はこれから制限によって派生した型)のインスタンスデータノードに結合している場合，活性化されたとき，uploadはノードの内容としてURIを配置する。

  セキュリティ上の理由から，XFormsプロセサは，明示的な利用者の許可なしに，このフォーム制御に結合するURIが指す場所を参照してはならない。

  備考：

  実装者は， 11.4 multipart/relatedとしての直列化 及び 11.5 multipart/form-dataとしての直列化 に必要になるため，uploadでバイナリデータ，メディア型及びファイル名とそのURIとを結び付けなければならないことに注意する。

• ファイルシステムを伴う実装は特定のファイルを選択するfile uploadをサポートすることが望ましい。また，デフォルトで表示されるファイル型には，mediatype属性に指定されたメディア型が反映されることが望ましい。例えばメディア型に“audio/*”型が指定された場合，デフォルトでファイルダイアログに表示されるのはaudioファイル型だけになるようにする。

実装必要条件：すべてのデータ結合に関して

• 特定のペン・座標読取り装置を伴う実装では，ペン書きオプションをサポートし，ペン使用の入力をその場で行えるようにすることが望ましい（その他のポインティングデバイスを伴う実装ではこれをサポートしてもよい。）。

• 特定のオーディオ録音機能を伴う実装では，オーディオ録音オプションをサポートし，オーディオクリップの録音をその場で行えるようにすることが望ましい。

• ディジタルカメラ，スキャナインタフェース又はスクリーンキャプチャーを伴う実装では，イメージ取得オプションをサポートし，接続された装置からのイメージのアップロードをその場で行えるようにすることが望ましい。

• ビデオ録画機能を伴う実装では，ビデオ録画オプションをサポートすることが望ましい。

• 3D機能を伴う実装では，3Dインタフェースオプションを提供することが望ましい。

• 実装では，独自の実装を提供してもよい（例えば，mediatypeがtext/rtfの場合に編集ウィンドウで独自のワードプロセサを起動するなど)。

• ここで言及されなかった入力装置を実装でサポートすることも推奨される。

• 特定のmediatypeのアップロードをサポートできない場合，実装はそのことを利用者に明らかにしなければならない。

filename子要素については 8.3.1 filename要素 ，mediatypeについては 8.3.2 mediatype要素 を参照。

8.1.7 range要素

共通属性：共通，UI共通，単一ノード結合

特殊属性

start

（背後にあるデータに適切な）範囲の開始点を示す省略可能なヒント。指定された場合，この値は背後のモデルによって指定された制約を更に限定する。

end

（背後にあるデータに適切な）範囲の終了点を示す省略可能なヒント。指定された場合，この値は背後のモデルによって指定された制約を更に限定する。

step

値の増分又は減分を示す省略可能な値。背後のデータの二つの値の差分を表すことができる型でなければならない。

incremental

trueの場合，このフォーム制御はxforms-value-changedイベントを追加生成する。この属性のデフォルト値はfalse。

例：

<range ref="/stats/balance" start="-2.0" end="2.0" step="0.5">
  <label>バランス</label>
</range>

上の例のグラフィカルブラウザでの可視化の例を次に示す。

データ結合制限：xsd:duration，xsd:date，xsd:time，xsd:dateTime，xsd:gYearMonth，xsd:gYear，xsd:gMonthDay，xsd:gDay，xsd:gMonth，xsd:float，xsd:decimal，xsd:doubleの各データ型及びこれらから制限によって派生したデータ型だけを結合。

実装必要条件：結合するデータ型に対応する値の入力を許可しなければならない。実装では，上限値, 下限値及びステップサイズが指定されていればそれらを利用者に知らせることが望ましい。インスタンスデータの値が上限又は下限を超えている場合，フォーム制御は範囲外状態を示さなければならない。グラフィカル環境では，このフォーム制御は“スライダ”又は“回転式制御”として可視化されてもよい。

この要素の各属性はメタデータをカプセル化するが，このメタデータは，XFormsモデルから得られる型情報と組み合わせることで，例えばスピーチなどの提示様式を使用するなど，アクセシビリティ支援を行う場合に意味のあるプロンプトを生成するのに十分なものとする。つまり，下に示す例では，聴覚に頼る利用者のためのエージェントが“2001年1月1日から2001年12月31日までの範囲にある日付を選んでください”のように発声することが考えられる。

背後にあるデータ型とstart及びendとが重なっている場合，最も限定的な範囲を使用することが望ましい。

例：

<range ref="/order/shipDate" start="2001-01-01" end="2001-12-31">
  <label>出荷日</label>
</range>

8.1.8 trigger要素

共通属性：共通，UI共通，単一ノード結合 (省略可能)

例：

<trigger>
  <label>ここをクリック</label>
</trigger>

データ結合制限：任意のノードに結合できる。このフォーム制御は，結合するノードのモデル項目特性から影響を受けるが，フォームデータとの直接の相互作用はない。したがって，結合属性は必須ではない。

実装必要条件：利用者エージェントは，フォーム制御上にDOMActivateイベントを生成する手段を提供しなければならない。グラフィカルな実装では，ラベルの付いた押しボタンとしてこのフォーム制御を可視化することが考えられる。スタイルシートを使用して，このフォーム制御をイメージ，ハイパーリンク又は他の表示形式としてスタイル設定することができる。

8.1.9 submit要素

共通属性：共通, UI共通, 単一ノード結合 (省略可能)

特殊属性：

submission

submission要素を指す必須の属性。

例：

<submit submission="timecard">
  <label>タイムカードの送付</label>
</submit>

データ結合制限：任意のノードに結合できる。このフォーム制御は，結合するノードのモデル項目特性から影響を受けるが，フォームデータとの直接の相互作用はない。したがって，結合属性は必須ではない。

実装必要条件：イベントDOMActivateを受け取ると，このフォーム制御は必須の属性submissionによって指定されたsubmission要素にイベントxforms-submitを振り分ける。1度活性化されると，送付処理がxforms-submit-doneイベント又はxforms-submit-errorイベントで完了するまで，この制御はさらなる活性化に利用できてはならない。

8.1.10 select要素

共通属性：共通, UI共通, 単一ノード結合

特殊属性：

selection

リスト中に自由な入力を許可するかどうかを決定する省略可能な属性。デフォルトは“closed”。

incremental

trueの場合，このフォーム制御はxforms-value-changedイベントを追加生成する。このフォーム制御のデフォルトはtrue。

例：

<select ref="my:flavors"> 
<label>味</label> 
  <choices>
    <item> 
      <label>バニラ</label> 
      <value>v</value>
    </item> 
    <item> 
      <label>ストロベリー</label> 
      <value>s</value>
    </item> 
    <item> 
    <label>チョコレート</label> 
      <value>c</value>
    </item> 
  </choices>
</select> 

上の例では，複数の味を選択することができる。

フォーム制御selectは，グラフィカルブラウザでは次のいずれかのように可視化されることが考えられる。

appearance="full"	appearance="compact"	appearance="minimal"

通常，フォーム制御の外観を厳密に決定するのにはスタイルシートが使用されるが，外観を指定する手段としてappearance属性を使用できる。属性の値は次のいずれかとする。

“full”：選択肢のすべてを常に可視化する。
“compact”：可視化する選択肢の数を固定する。必要に応じてスクロール機能を使用する。
“minimal”：可視化する選択肢の数を最小にする。一時的に選択肢を追加表示する機能をもつ。

データ結合制限：シーケンスを保持することができる任意のsimpleContentに結合できる。simpleContentへの結合の制限は，ここで規定しているとおりに，選択肢が利用者インタフェース制御の一部として記述される場合に存在する。動的に選択肢を作成するためのitemset要素（ 9.3.3 itemset要素 を参照）を使用することで，利用可能にする選択肢をXFormsモデルから入手することができるが，その場合はsimpleContentへの結合の制限は緩和される。

<item>
  <value>United States of America</value>
  ...
</item> 

実装必要条件：選択肢のそれぞれについてラベルが存在してなければならず，何も選択されないことも含め，選択は幾つでも許可されなけらばならない。このフォーム制御は，選択された選択肢に対応する値をref属性によって示される場所にスペース区切りのリストとして格納する。格納される値は，value要素の内容として直接指定されるか，value要素上の結合属性によって間接的に指定される。

このフォーム制御に結合されるデータ型には，xsd:stringなどの非一覧表型の値空間，及び一覧表型と非一覧表型とのユニオン(追加可能な一覧表と呼ばれる。)を含めてもよいことに注意する。この場合，制御selectに属性selection="open"が存在してもよく，それに対して，フォーム制御は 8.1.2 input要素 に規定しているような自由形式での入力を許可することが望ましい。フォーム制御は，自由形式の入力を介して複数の値が入力されるのを許可してもよい。

“closed”の場合：指定された項目の格納値の一つ以上と初期インスタンス値が一致する場合，その項目が選択される。一致するものがない場合，最初に選択される項目はない。選択された値のいずれかが，選択肢のどの格納値とも一致しない場合，フォーム制御は範囲外状態を示さなければならない。

“open”の場合：一つ以上の項目によって指定される格納値と初期インスタンス値が一致する場合，それらの項目がすべて選択される。一つ以上の項目によって指定される格納値と初期インスタンス値が一致しない場合，それらの一致しない項目は，自由形式入力を介して入力されたのと同じように，選択された値になる。自由形式入力のテキストはinputフォーム制御 8.1.2 input要素 の場合と同様に扱われ，複数になることもある。complexTypesを伴う動的な選択を行う場合，“open”は無効となる。

実装のヒント:アクセシビリティ支援として，選択肢の最初から最後まで，利用者に一通り確認させることが考えられる。その場合，マーク付け内で選択肢をグループ化することで，選択肢が多数である場合のナビゲーションを改善することも検討する。

8.1.11 select1要素

共通属性：共通，UI共通，単一ノード結合

特殊属性：

selection

リスト中に自由な入力を許可するかどうかを決定する省略可能な属性。デフォルトは“closed”。

incremental

trueの場合，このフォーム制御はxforms-value-changedイベントを追加生成する。このフォーム制御のデフォルトはtrueとする。

例：

<select1 ref="my:flavor">
  <label>味</label>
  <item>
    <label>バニラ</label>
    <value>v</value>
  </item>
  <item>
    <label>ストロベリー</label>
    <value>s</value>
  </item>
  <item>
    <label>チョコレート</label>
    <value>c</value>
  </item>
</select1>

上の例で，選択肢から一つを選択すると，選択した項目に関連する値，つまりその項目のvalue要素で指定される値が，背後のインスタンスデータ内の場所icecream/flavorに設定される。

上の例のグラフィカルブラウザでの可視化の例を次に示す。

appearance="full"	appearance="compact"	appearance="minimal"

データ結合制限：任意のsimpleContentに結合できる。simpleContentへの結合の制限は，ここで規定しているとおりに，選択肢が利用者インタフェース制御の一部として記述される場合に存在する。動的に選択肢を作成するためのitemset要素（ 9.3.3 itemset要素 を参照）を使用することで，利用可能にする選択肢をXFormsモデルから入手することができるが，その場合はsimpleContentへの結合の制限は緩和される。

実装必要条件：選択肢のそれぞれについてラベルが存在していなければならず，選択は常に一つだけ許可されなけらばならない。このフォーム制御は，選択された選択肢に対応する値をref属性によって示される場所に格納する。格納される値は，value要素の内容として直接指定されるか，value要素上の結合属性によって間接的に指定される。

このフォーム制御に結合されるデータ型には，xsd:stringなどの非一覧表型の値空間，及び一覧表型と非一覧表型とのユニオン(追加可能な一覧表と呼ばれる。)を含めてもよいことに注意する。この場合，制御select1に属性selection="open"が存在してもよく，それに対して，フォーム制御は 8.1.2 input要素 に規定しているような自由形式での入力を許可することが望ましい。

“closed”の場合：指定項目の格納値の一つと初期インスタンス値が一致する場合，その項目が選択される。一致するものがない場合，フォーム制御は範囲外状態を示さなければならない。

“open”の場合：項目の一つによって指定される格納値と初期インスタンス値が一致する場合，最初に一致した項目が選択される。一致しない場合，最初の字句値が選択された値になる。自由形式入力のテキストはinputフォーム制御 8.1.2 input要素 の場合と同様に扱われる。

利用者インタフェースは，このフォーム制御をプルダウンリスト，ラジオボタンのグループなどに可視化してもよい。appearance属性はどの表示が最も適切かについてのヒントを提供するが，CSSなどのスタイル情報を優先させることが望ましい。

8.2.1 choices要素

共通属性：共通

8.2.2 item要素

共通属性：共通

8.2.3 value要素

共通属性：共通，単一ノード結合 (省略可能)

データ結合制限：結合する選択制御のデータ型に従うすべての字句値が有効でなければならない。

行内内容及びref属性が両方とも指定された場合，ref属性が使用される。

8.3.1 filename要素

共通属性：共通，単一ノード結合

次の例では，利用者はイメージを選択するように促される。活性化されたとき，uploadはイメージのバイナリデータ又はイメージのURIをmail/attachmentに配置する。いずれが配置されるかは，mail/attachmentに宣言された型による。ファイル名（例えば“me.jpg”）が属性ノードmail/attachment@filenameに配置され，mediatype（例えば“image/jpeg”）が属性ノードmail/attachment@mediatypeに配置される。

例：

<upload ref="mail/attachment" mediatype="image/*">
  <label>添付する画像を選択してください</label>
  <filename ref="@filename"/>
  <mediatype ref="@mediatype"/>
</upload>

8.3.2 mediatype要素

共通属性：共通，単一ノード結合

8.3.3 label要素

共通属性：共通, 単一ノード結合（省略可能），リンク付け

特殊属性：

リンク付け属性

外部ラベルへのリンク。リンク走査に失敗した場合は，誤りとして扱われる（ 4.5.3 xforms-link-errorイベント ）。

指定されたラベルはインスタンスデータ内，遠隔ドキュメント又は内部テキストとして存在できる。要素内にラベルのソースが複数指定された場合，その優先順位は，単一ノード結合属性，リンク付け属性，内部テキストの順になる。

XFormsを含んでいるフォーム制御にフォーカスが移動したとき，ここにカプセル化されたメタデータは，アクセシビリティ支援によって発声されることが考えられる。

8.3.4 help要素

共通属性：共通, 単一ノード結合（省略可能），リンク付け

特殊属性：

リンク付け属性

外部ヘルプ情報へのリンク。リンク走査に失敗した場合は誤りとして扱われる（ 4.5.3 xforms-link-errorイベント ）。

指定されたメッセージは，インスタンスデータ，遠隔のドキュメント，又は内部のテキストとして存在することができる。要素内に複数のメッセージが指定された場合，その優先順位は，単一ノード結合属性，リンク付け属性，内部テキストの順になる。

この要素の例については， 10.1.12 message要素 を参照。

8.3.5 hint要素

共通属性：共通，単一ノード結合（省略可能），リンク付け

特殊属性：

リンク付け属性

外部ヒントへのリンク。リンク走査に失敗した場合は誤りとして扱われる（ 4.5.3 xforms-link-errorイベント ）。

指定されたメッセージは，インスタンスデータ，遠隔のドキュメント，又は内部のテキストとして存在することができる。要素内に複数のメッセージが指定された場合，その優先順位は，単一ノード結合属性，リンク付け属性，内部テキストの順になる。

この要素の例については， 10.1.12 message要素 を参照。

8.3.6 alert要素

共通属性：共通，単一ノード結合（省略可能），リンク付け

特殊属性：

リンク付け属性

外部警告へのリンク。リンク走査に失敗した場合は誤りとして扱われる（ 4.5.3 xforms-link-errorイベント ）。

指定されたメッセージは，インスタンスデータ，遠隔のドキュメント，又は内部のテキストとして存在することができる。要素内に複数のメッセージが指定された場合，その優先順位は，単一ノード結合属性，リンク付け属性，内部テキストの順になる。利用者への提示の例については， 附属書F XForms及びスタイル設定 を参照。

9.1.1 group要素

共通属性：共通, UI共通, 単一ノード結合 (省略可能)

省略可能なlabel要素は，それがgroupの最初の子要素として現われる場合，特別な意味をもち，group全体のラベルとして機能する。

例：

<group ref="address">
  <label>発送先住所</label>
  <input ref="line_1">
    <label>住所１</label>
  </input>
  <input ref="line_2">
    <label>住所２</label>
  </input>
  <input ref="postcode">
    <label>郵便番号</label>
  </input>
</group>

groupに入力フォーカスを設定すると，そのgroup内のナビゲーション順で最初のフォーム制御にフォーカスが設定される。

9.2.1 switch要素

共通属性：共通, UI共通, 単一ノード結合 (省略可能)

例：

<switch>
  <case id="in" selected="true">
    <input ref="yourname">
      <label>名前を教えてください</label>
      <toggle ev:event="DOMActivate" case="out"/>
    </input>
  </case>
  <case id="out" selected="false">
    <html:p>こんにちは，<output ref="yourname" />さん
      <trigger id="editButton">
        <label>編集</label>
        <toggle ev:event="DOMActivate" case="in"/>
      </trigger>
    </html:p>
  </case>
</switch>

この例では，最初のcaseに含まれる利用者インタフェース部分が最初に表示され，利用者に名前の入力を要求する。利用者が値を入力し，enterを押すことなどによって制御を活性化することで，読込み専用のoutputを可視化する別のcaseに切り替わり，更に，“編集”というラベルが付けられたtriggerを活性化することで元のcaseに戻る。

9.2.2 case要素

共通属性：共通

特殊属性：

selected

省略可能。caseに対する選択の状態。デフォルト値は“false”とする。

switch内の複数のcaseがselected="true"である場合，最初のcaseが選択されたままになり，その他はすべて選択が解除される。どれも選択されていない場合，最初のものが選択される。

9.2.3 toggle要素

共通属性：共通, イベント

特殊属性：

case

必須。case要素を示す。

9.3.1 repeat要素

<repeat nodeset="/cart/items/item">
  <input ref="." ...>
    <label>...</label>
  </input>
  <html:br/>
</repeat>

共通属性：共通, UI共通, ノード集合結合

特殊属性：

startindex

省略可能。1から開始される繰返しインデクス。デフォルト値は1とする。

number

省略可能。集合に属する要素のうちの幾つを表示するかに関するXFormsプロセサへのヒント。

この要素は，カプセル化された利用者インタフェース制御を同種の集りの各要素に結合することによって，その集りに対して動作する。この要素の属性は，集りのメンバの幾つがその時々で利用者に提示されるかを指定する。この集りの操作には，XFormsアクション（ 10. XFormsアクション を参照）insert，delete及びsetindexを使用できる。特殊な利用者インタフェース相互作用を考慮しない場合，繰返しを表示する別の方法は，その繰返しを“展開”することとする。返されるノード集合のitem要素の数が四つであると仮定すると，上の例は次と同様とする。

<!-- unrolled repeat -->
  <input ref="/cart/items/item[1]" .../><html:br/>
  <input ref="/cart/items/item[2]" .../><html:br/>
  <input ref="/cart/items/item[3]" .../><html:br/>
  <input ref="/cart/items/item[4]" .../><html:br/>

<model>
  <instance>
    <my:lines>
      <my:line name="a">
        <my:price>3.00</my:price>
      </my:line>
      <my:line name="b">
        <my:price>32.25</my:price>
      </my:line>
      <my:line name="c">
        <my:price>132.99</my:price>
      </my:line>
      </my:lines>
  </instance>
</model>
  ...
<repeat id="lineset" nodeset="/my:lines/my:line">
  <input ref="my:price">
    <label>品目</label>
  </input>
  <input ref="@name">
    <label>名称</label>
  </input>
</repeat>
        
<trigger>
  <label>新しい品目を現在の品目の後ろに追加</label>
  <action ev:event="DOMActivate">
    <insert nodeset="/my:lines/my:line" at="index('lineset')"
      position="after"/>
    <setvalue ref="/my:lines/my:line[index('lineset')]/@name"/>
    <setvalue ref="/my:lines/my:line[index('lineset')]/price">0.00</setvalue>
  </action>  
</trigger>
          
<trigger>
  <label>現在の品目を削除</label>
  <delete ev:event="activate" nodeset="/my:lines/my:line"
    at="index('lineset')"/>
</trigger>

9.3.2 属性を使用する繰返し構造の作成

<table>
  <repeat nodeset="...">
    <tr>
      <td>...</td>
      ...
    </tr>
  </repeat>
</table>

<html:table xforms:repeat-nodeset="...">
  <html:tr>
    <html:td><xforms:output ref="..."/></html:td>
  </html:tr>
</html:table>

<repeat ...>
  ...
</repeat>

<repeat ...>
  <group>...</group>
</repeat>

<group repeat-...>
  ...
</group>

9.3.3 itemset要素

この要素を使用すれば，select制御及びselect1制御の選択肢を動的に作成することができ，その場合，利用可能な選択肢は実行時に決まる。利用可能な選択肢を保持するノード集合は属性nodesetによって指定される。repeatの場合と同様，このノード集合は同種の集りであることが望ましい。子要素であるlabel及びvalueは，ラベル及び格納値を間接的に指定する。itemsetの実行時の効果は，利用可能な選択を静的に記述するchoices要素を使用する場合と同じであることに注意する。

共通属性：共通, ノード集合結合

次の例は，アイスクリームの風味の動的なリストを指定するためのselect制御内のitemset要素を示している。

<model id="cone">
  <instance>
    <my:icecream>
      <my:order/>
    </my:icecream>
  </instance>
</model>
<model id="flavors">
  <instance>
    <my:flavors>
      <my:flavor type="v">
        <my:description>バニラ</my:description>
      </my:flavor>
      <my:flavor type="s">
        <my:description>ストロベリー</my:description>
      </my:flavor>
      <my:flavor type="c">
        <my:description>チョコレート</my:description>
      </my:flavor>
    </my:flavors>
  </instance>
</model>

<!-- user interaction markup -->

<select model="cone" ref="my:order">
  <label>味</label>
  <itemset model="flavors" nodeset="/my:flavors/my:flavor">
    <label ref="my:description"/>
    <copy ref="my:description"/>
  </itemset>
</select>

<!-- For all three items selected, this example produces instance data like
     <my:icecream>
       <my:order>
         <my:description>バニラ</my:description>
         <my:description>ストロベリー</my:description>
         <my:description>チョコレート</my:description>    
       </my:order>
     </my:icecream>
-->

9.3.4 copy要素

この要素は構造的な面で 8.2.3 value要素 に類似しているが，使用できるのがitemset内だけである点と，動作の対象が単純な値ではなくインスタンスデータの部分木である点とが異っている。

共通属性: 共通, 単一ノード結合 (省略可能)

itemが選択されたとき，次の規則が適用される。

• リストフォーム制御内の結合属性によって指定されたターゲットノードは要素ノードでなければならない。そうでない場合は例外が発生する（ 4.5.1 xforms-binding-exceptionイベント ）。

• itemに関連付けられている，copy上の結合属性によって指定された要素ノードがターゲットノードの子要素としてディープコピーされる。

• 計算に必要な依存関係が完全に再構築される。

itemの選択が解除されたとき，次の規則が適用される。

• リストフォーム制御内の結合属性によって指定されたターゲットノードは要素ノードでなければならない。そうでない場合は例外が発生する（ 4.5.1 xforms-binding-exceptionイベント ）。

• itemに関連付けられている，copy上の結合属性によって指定された要素ノードが削除される。

• 計算に必要な依存関係が完全に再構築される。

9.3.5 insert要素

共通属性：共通, イベント, ノード集合結合

特殊属性：

at

必須。挿入位置を決定するために評価されるXPath式。

position

必須。“before”（前に挿入）又は“after”（後に挿入）のいずれかを選択する。

insert処理の規則は次のとおりとする。

1. 結合属性nodesetを評価することによって，更新対象の同種の集りを決定する。

2. 原型として使用する集りのメンバを決定するために，対応する初期インスタンスデータのノード集合に位置付ける。挿入するノードを生成するために，この集りの最後のメンバのクローンを作成する。最後に，この新しく作成したノードを，インスタンスデータの，position属性及びat属性によって指定された位置に挿入する。

   at属性の評価結果によって，挿入のインデクス，つまりノード集合に対するインデクスを表す数値が決まる。at属性は，ノード集合結合の文書順で最初のノードを文脈ノード，ノード集合結合のサイズを文脈サイズとし，文脈位置を1として評価される。position属性によって，新しいノードをそのインデクスの前又は後のいずれに挿入するのかが決まる。

   インデクスの決定規則は次のとおりとする。

   1. 属性atに指定されたXPath表現の戻り値は，XPath関数round()の規則に従って処理される。例えば，リテラル“1.5”は“2”になり，リテラル“string”はNaNになる。

   2. 結果がNaNである場合，insertはノード集合の最後への追加になる。

   3. 結果として得られたインデクスは，それがノード集合の妥当な範囲にない場合，1又はノード集合のサイズのいずれか近い値に置き換えられる。

3. ノードを追加した同種の集りに結合しているすべての繰返しに対するインデクスを，新たに追加したノードを指すように更新する。内側の入れ子として存在する繰返しのためのインデックスを1に再初期化する。

4. 挿入処理が正常に終了した場合，イベントxforms-insertを振り分ける。

このアクションの結果，新たに作成されたデータノードがXFormsインスタンスデータに挿入される。このノードは，処理モデルの初期化（ 4.2 初期化イベント を参照）で定義されるとおりに作成される。例えば，これが繰返し構造と共に使用された場合，背後にある集り内の新しい項目に値を設定するのに必要な利用者インタフェースのインスタンスが作成される。

insertを繰り返す構造と共に使用する例については， 9.3.1 repeat要素 を参照。insertと共にXForms setvalueアクションを使用することで，新しく挿入されたノードに対する初期値を指定できることに注意する。

9.3.6 delete要素

共通属性：共通, イベント, ノード集合結合

特殊属性：

at

必須。削除位置を決定するために評価されるXPath式。

delete処理の規則は次のとおりとする。

1. 結合属性nodesetを評価することによって，更新対象の同種の集りを決定する。集りが空の場合，deleteアクションは無効とする。

2. n番目の要素ノードをインスタンスデータから削除する。nは， 9.3.5 insert要素 で定義されるノード集合インデクスの評価から返される数値とする。n番目のノードが存在しない場合，この操作は無効とする。

3. 削除処理後のインデクスが指すノードは，次の場合を除いて，削除処理前と同じであることが望ましい。

   • 集り内に残っていた最後の項目が削除された場合，インデクス位置は0になる。

   • 削除されたノードをインデクスが指していた場合で，そのノードが集り内の最後の項目であった場合，インデクスは削除後の集り内で最後のノードを新たに指す。内側の繰返しのインデックスは再初期化される。

   • 削除されたノードをインデクスが指していた場合で，そのノードが集り内の最後の項目ではなかった場合，インデクス位置は変更されない。内側の繰返しのインデクスは再初期化される。

   繰返しの再初期化とは，それが空の場合にインデクスを0に変更し，それ以外の場合は1に変更することを意味する。

4. deleteが正常終了した場合，イベントxforms-deleteを振り分ける。

このアクションの結果，インスタンスデータ内のノードは削除される。

deleteを繰返し構造と共に使用する例については， 9.3.1 repeat要素 を参照。

9.3.7 setindex要素

このアクションは，ある項目を繰返し内で現在指し示されるものとして設定する（ 9.3.1 repeat要素 ）。

共通属性：共通, イベント

特殊属性：

repeat

必須。繰返し要素を示す。

index

必須。繰返し内の1を基準とする相対位置として評価されるXPath式。

指定されたインデクスが0以下である場合，xforms-scroll-firstイベントが振り分けられ，インデクスは1に設定される。指定されたインデクスが繰返しの最後の項目のインデックスよりも大きい場合，xforms-scroll-lastイベントが振り分けられ，インデクスは最後の項目のインデクスに設定される。インデクスがNaNと評価される場合，このアクションは無効とする。内側の入れ子の繰返しのためのインデクスは1に再初期化される。このアクションの結果，実装内の計算に必要な依存関係を管理するためのデータ構造は再構築又は更新される。

9.3.8 繰返し処理

repeat要素の本体内に含まれるマーク付けは，背後にある集りの各メンバに対して利用者インタフェースを生成することを指定する。利用者インタフェースの初期化中（ 4.2.2 xforms-model-construct-doneイベント を参照），repeatに対して次のステップが実行される。

1. このrepeatの操作対象である同種の集りに位置付けるために，nodeset属性を評価する。

2. ソース文書内にあるinstance要素内の対応するノードに位置付ける。これらのノードは初期値を提供し，（繰り返す）集りのメンバを作成するための原型インスタンスとして機能する。

3. この繰返し構造のためのindexをstartindexの値に初期化する。startindexが1より小さい場合は1とし，初期のノード集合のサイズより大きい場合はノード集合のサイズとする。

4. repeat要素内に指定された利用者インタフェースのテンプレートをこの原型インスタンスに結合する。原型のインスタンスと利用者インタフェース制御のための結合制限との間で型の不整合がある場合，誤りを送信し，処理を停止する。

5. repeatで指定された利用者インタフェースを，repeat要素上の属性で指定された集りのメンバの必要数だけ生成する。

繰返し構造のための処理モデルでは，インスタンスデータ中の現在の項目を指すインデクスが使用される。この繰返しインデクスは，XForms index関数 7.8.5 index() 関数 を介してアクセスされ，XForms setindexアクション 9.3.7 setindex要素 を介して操作される。このインデクスはinsert及びdelete操作のための参照ポイントとして使用される。repeat要素内に含まれるXFormsフォーム制御では，値の格納先である集り内の項目のインデクスが明示的に指定されないことに注意する。これは意図されたものであり，これによって文書作成及び処理モデルの両方ともが単純なものに保たれる。

繰返しに付けられた結合式は，個々のノードではなく，値の格納先である集りのノード集合を返す。repeat要素の本体内で，結合は，インデクスによって決定されるノードの文脈ノードで評価される。繰返し処理はXPath式を使用してrepeat要素の操作対象の集りを決定する。初期インスタンスデータは同種の集りの原型メンバを供給する。この原型メンバは，UIの初期化（ 4.2.2 xforms-model-construct-doneイベント を参照）中に同種の集りのメンバを作成するのに使用される。また，insertアクションによる集りの新しいメンバの作成時にも使用される。同種の集りを作成するために，初期インスタンスデータには，集りの少なくとも一つのメンバを指定しなければならない。この要求事項は，スキーマに加えてインスタンスデータを必要とするのに類似しており，その理由も同じとする。

repeat内のフォーム制御は，集りの個々の項目に値を格納するのに適切なものである必要がある。この単純ではあるが強力な機能によって，XFormsモデルに集りの入れ子が指定されている場合に，対応する利用者インタフェースでrepeat要素を入れ子にすることができる。

9.3.9 繰返しの入れ子

repeat要素入れ子にして，構造化データを編集するためのより強力な利用者インタフェースを作成することができる。 G.2 XFormsを使用した階層型ブックマークの編集 は，複数の節内のブックマークから成る階層データを編集するのに繰返しの入れ子を使用するフォームの例とする。この例の一部として現われる次のinsert文について考える。

<xforms:insert nodeset="/bookmarks/section[index('repeatSections')]/bookmark"
               at="index('repeatBookmarks')"
               position="after"/>

この例で，上のinsertステートメントは，現在選択されている節に新しいブックマークのエントリを加えるために使用されている。 内部の（入れ子にされた）繰返しは，この選択された節内のブックマークを操作する。この内側の繰返しのインデクス（インデクスはXForms index関数によって返される。）は，1から開始される。したがって，新しい空のブックマークの節が作成され，現在のもの（current）になった後，最初のブックマークの挿入操作では，新しく作成されたブックマークがリストの先頭に追加される。

9.3.10 利用者インタフェースの相互作用

要素repeatを使用すれば，利用者の対話を同種の集りに結合することができる。可視化される項目の数は集り内の有効な総数より少ない可能性もある。その場合，同時に表示される繰返し項目は，その一部分だけになる。例えば，GUIにスクロールテーブルが表示されることが考えられる。繰返しインデクスによって示される現在の項目は，例えば，表示領域外にスクロールされるのではなく，常に利用者から利用可能になることが望ましい。 10. XFormsアクション に列挙されたXFormsアクションをイベントリスナ内で使用して，エントリをスクロール，挿入及び削除することによって，値の格納先である同種の集りを操作してもよい。

要素repeatによってカプセル化されたマーク付けは，利用者に提示される利用者対話のためのテンプレートの役割を果たすことに注意する。その結果，生成された利用者インタフェースの一部分を，静的に記述したidref属性を使用して参照することは不可能である。したがって，XForms 1.0ではrepeat要素内のswitch構造の振る舞いを定義しない。XFormsの将来の版で，実装の経験及び利用者からのフィードバックに基づいてrepeat内のswitchの振る舞いが定義される可能性もある。

10.1.1 action要素

共通属性：共通，イベント

<trigger>
  <label>ここをクリック</label>
  <action ev:event="DOMActivate">
    <reset model="thismodel"/>
    <setvalue ref="."/>
  </action>
</trigger>

上の例で，ev:event="DOMActivate"がaction要素上に現れることに注意する必要がある。含まれるアクションのいずれか又は両方にev:event="DOMActivate"を配置しても無効とする。これは上の例が，[XML Events]属性であるobserver及びhandlerのデフォルトに依存しているためとする。 XMLイベントの規定に定義されるとおりに，observer属性及びhandler属性の両方が省略された場合は，親がovserverになる。したがって，ev:event="DOMActivateD"をactionの子要素に置いた場合，action要素が個々のイベントのobserverになる。その結果，イベントはaction要素ではなくtrigger要素に到着するため，これらのアクションは起動されない。

遅延更新： XFormsアクションの中には，action要素の子孫要素として指定された場合に，インスタンスデータに対して遅れて適用される効果をもつものが多くある。

実装では，遅延更新を実現するのにどのような方法を採用してもよいが，結果は定められたとおりにならなければならない。つまり，一連のアクションによってインスタンスデータが変更された後，最も外側のアクションハンドラの処理が終了するまで，計算に必要な依存関係の再構築，再計算，妥当性の再検証及びフォーム制御のリフレッシュは行われてはならない。最も外側にある各アクションハンドラは，それらのアクションハンドラの終了時にrebuild，recalculate，revalidate及びrefreshのアクションが必要であるかどうかを示す，初期値がfalseである論理値フラグをもつと考えることができる。

rebuild，recalculate，revalidate，refreshを直接呼び出すアクションは，その動作を直ちに実行し，対応するフラグをクリアする。この範ちゅうに属するXFormsアクションは次のとおり。

rebuild
recalculate
revalidate
refresh

インスタンスデータの木構造を変更するXFormsアクションは，四つのフラグをすべてtrueにセットする。この範ちゅうに属するXFormsアクションは次のとおり。

insert
delete

インスタンスノードの値だけを変更するXFormsアクションは，recalculate，revalidate及びrefreshの各フラグをtrueにセットし，rebuildフラグについては変更しない。この範ちゅうに属するXFormsアクションは次のとおり。

setvalue

最後に，resetアクションは動作を直ちに実行し，すべてのフラグをクリアする。

10.1.2 dispatch要素

1. 事前定義されたXFormsイベント（つまりxforms-event-name）。この場合は，bubbles及びcancelable属性は無視され， 4. 処理モデル で定義された標準の意味が適用される。

2. XFormsの文書作成者によって作成される，XFormsでの解釈が事前定義されていないイベント。デフォルトでXFormsプロセサによって処理されることはない。

共通属性：共通，イベント

特殊属性：

name

必須。振り分けるイベントの名称。

target

必須。イベントのターゲットを示す。

bubbles

省略可能。このイベントが，[DOM2 Events]で定義されているようなバブル動作を伴うかどうかを示す論理値。デフォルト値はカスタムイベントの定義による。事前定義されたイベントに対しては，この属性は無効とする。

cancelable

省略可能。このイベントが，[DOM2 Events]で定義されているような取消し可能なものであるかどうかを示す論理値。デフォルト値はカスタムイベントの定義による。事前定義されたイベントに対しては，この属性は無効とする。

10.1.3 rebuild 要素

このアクションは，通常のイベントフローに従わずに直接，xforms-rebuild処理を起動する。このアクションによって，XFormsプロセサは，インスタンスデータノード内の計算に必要な依存関係を把握するのに使用される内部データ構造を再構築する（ 4.3.7 xforms-rebuildイベント を参照）。

共通属性：共通，イベント

特殊属性：

model

省略可能。 3.2.3 単一ノード結合属性 で定義されているXFormsモデルセレクタ。

10.1.4 recalculate要素

このアクションは，通常のイベントフローに従わずに直接，xforms-recalculate処理を起動する。その結果，値が再計算される必要のあるインスタンスデータノードは，処理モデルで定義されているとおりに更新される（ 4.3.6 xforms-recalculateイベント を参照）。

共通属性：共通，イベント

特殊属性：

model

省略可能。 3.2.3 単一ノード結合属性 で定義されているXFormsモデルセレクタ。

10.1.5 revalidate要素

このアクションは，通常のイベントフローに従わずに直接，xforms-revalidate処理を起動する。この結果，インスタンスデータは処理モデルに定義されているように妥当性が再検証される（ 4.3.5 xforms-revalidateイベント を参照）。

共通属性：共通，イベント

特殊属性：

model

省略可能。 3.2.3 単一ノード結合属性 で定義されているXFormsモデルセレクタ。

10.1.6 refresh要素

このアクションは，通常のイベントフローに従わずに直接，xforms-refresh処理を起動する。この結果，XForms利用者インタフェースはリフレッシュされ，利用者インタフェース制御の表示は背後にあるインスタンスデータの状態を反映するように更新される（ 4.3.4 xforms-refreshイベント を参照）。

共通属性：共通，イベント

特殊属性：

model

省略可能。 3.2.3 単一ノード結合属性 で定義されているXFormsモデルセレクタ。

10.1.7 setfocus要素

このアクションは，control属性で指定されたフォーム制御にxforms-focusイベント（ 4.3.2 xforms-focusイベント ）を振り分ける。このイベントは，accesskeyなどのXFormsアクセシビリティ機能を実現するために，内部的に呼び出されることに注意する必要がある。

共通属性：共通，イベント

特殊属性：

control

必須。フォーム制御を示す。

繰返し構造にフォーカスを設定する場合は，その繰返しのインデクスが指す繰返し項目にフォーカスを設定する。

10.1.8 load要素

共通属性：共通，イベント，単一ノード結合 (省略可能)

特殊属性：

resource

ロードする外部資源へのリンク。このリンクは，この要素と指定された遠隔資源との間の[XLink 1.0]リンクとして定義されるものとする。リンク動作の制御はXMLイベントによって定義されるため，XLinkのactuate値は定義されない。XLinkのshow値は，show属性に依存する。リンク走査に失敗した場合は誤りとして処理される（ 4.5.3 xforms-link-errorイベント ）。

show

省略可能。リンクの振る舞いを示す。この属性が指定されない場合，デフォルト値として“replace”が仮定される。

インスタンスデータ内のURIを示す単一ノード結合属性又はリンク付け属性のいずれかが必要とする。両方指定された場合，このアクションは無効になる。

show属性に指定できる各値は，次に示すとおりに，リンク走査によって到達した文書（又は文書の一部）の処理を指定するものとする。

new

文書は，新しい表示文脈，例えば，新しいウィンドウにロードされる。元のウィンドウではフォーム処理が引き続き行われる。

replace

文書は現在のウィンドウ内にロードされる。フォーム処理は，利用者が新しい文書への移動を手動で要求した場合と全く同じように中断する。

10.1.9 setvalue要素

共通属性：共通，イベント，単一ノード結合

特殊属性：

value

省略可能。XPath式。このXPath式の評価結果が選択されたインスタンスデータノードに格納される。単一ノード結合の結果が，このXPath式の評価文脈になる。

setvalue要素の内容は，設定されるリテラル値を示す。この指定方法は，value属性を使用して計算された値を指定する方法の代替として使用できる。これらの方法を比較する二つの例を次に示す。

<setvalue bind="put-here" value="a/b/c"/>

<setvalue bind="put-here">literal string</setvalue>

文字列はすべて，次のとおりに，インスタンスデータに挿入される。

• 要素ノードの場合：要素に子テキストノードが存在する場合，最初のテキストノードが新しい値に対応するものに置き換えられる。子テキストノードが存在しない場合，子テキストノードが作成されて新しい値に対応付けられ，最初の子ノードとして追加される。

• 属性ノードの場合：属性の文字列値が新しい値に対応する文字列に置き換えられる。

• テキストノードの場合：テキストノードが新しい値に対応するものに置き換えられる。

• 名前空間，処理命令，コメント及びXPathのルートノードの場合：振る舞いは未定義。

10.1.10 send要素

このアクションは，xforms-submitイベントを振り分けることによって送付処理を開始する。xforms-submitイベントの処理は処理モデルで定義されている（ 4.3.9 xforms-submitイベント を参照）。

共通属性：共通，イベント

特殊属性：

submission

必須。submission要素を示す。

<dispatch target="mysubmitinfo" name="xforms-submit"/>

10.1.11 reset要素

このアクションは，指定されたmodelにxforms-resetイベントを振り分けることによって，リセット処理を開始する。xforms-resetイベントの処理は処理モデルで定義されている（ 4.3.8 xforms-resetイベント を参照）。

共通属性：共通，イベント

特殊属性：

model

省略可能。 3.2.3 単一ノード結合属性 で定義されているXFormsモデルセレクタ。

10.1.12 message要素

共通属性：共通，イベント，単一ノード結合 (省略可能)

特殊属性：

リンク付け属性

外部メッセージへのリンク。リンク走査に失敗した場合は誤りとして処理される（ 4.5.3 xforms-link-errorイベント ）。

level

必須。("ephemeral"|"modeless"|"modal"|QName-but-not-NCName)のいずれかであるメッセージレベル識別子。この規定では，QName値のための振る舞いを定義しない。

メッセージとして指定できるのは，インスタンスデータ内，遠隔文書内，又は内部テキストとして存在するものとする。この要素内に複数のメッセージソースが指定されている場合，優先順位は，単一ノード結合属性，リンク付け属性，内部テキストの順になる。

グラフィカルブラウザにおけるmodalメッセージの可視化の例を次に示す。

<model>
  <message level="modal" ev:event="xforms-ready">これは演習ではありません！</message>
  ...
</model>

modelessメッセージはhelpメッセージを表示するために基礎になる。グラフィカルブラウザにおけるhelpメッセージの可視化の例を次に示す。

<secret ref="/login/password">
  <label>Password</label>
  <help>パスワードをお忘れですか？ クレジットカードをお手元に用意して，1-900-555-1212
        に電話してください。</help>
</secret>

ephemeralメッセージはhintメッセージを表示するために基礎になる。グラフィカルブラウザにおけるhintメッセージの可視化の例を次に示す。

<input ref="po/address/street1">
  <label>市町村及び番地</label>
  <hint>市町村名及び番地を入力してください。</hint>
</input>

10.1.13 insert, delete及びsetindexアクション

10. XFormsアクション で詳述したアクションハンドラに加えて，XFormsには， 9.3.5 insert要素 , 9.3.6 delete要素 及び 9.3.7 setindex要素 の三つのアクションがXForms繰返しモジュールの一部として定義されている。

12.1.1 完全XForms

この適合性レベルは，標準デスクトップブラウザ上又は，サーバ側構成要素を伴う分散XFormsプロセサに見られるような，より強力なフォーム処理に適している。完全XFormsは，( 7.9.1 property()関数 で定義されている)propertyメソッドが“conformance-level”パラメタ文字列と共に呼び出されたときに“full”を返すように実装しなければならない。

12.2.1 XForms適合プロセサ

• [XML 1.0]

• [XML Names]

• [XML Events]

• [XPath 1.0] すべての機能を実装する。

• [XML Schema part 2]

すべてのXFormsプロセサは，主要モジュール，MustUnderstandモジュール，フォーム制御モジュール，グループモジュール，スイッチモジュール，繰返しモジュール及びアクションモジュールを完全にサポートしなければならない。

すべてのXFormsプロセサは，XForms処理モデル及び 4. 処理モデル にリストされているすべてのイベント，xsd:anyURIを処理するためのhttpスキーム，並びに 11. 送付 に定義されているすべての直列化メソッドもサポートしなければならない。

ホスト言語は，その他の適合性に関する要求事項を導入してもよい。

完全XFormsプロセサは，この規定で定義された必須機能をすべて実装しなければならない。

12.2.2 XForms適合文書

• [XML 1.0]

• [XML Names]

• [XML Events]

• [XML Schema part 2]

XForms要素は一般的に，それを含んでいる文書内の複数の場所に挿入される。挿入された各素片のルート要素はmodel，フォーム制御，group，repeat又はswitchのどれかでなければならない。挿入されたそれぞれのXForms素片は，XFormsのスキーマ（ 附属書A XFormsのためのスキーマ ）に照らして妥当でなければならない。

ホスト言語は，その他の適合性に関する要求事項を導入してもよい。

完全XForms適合文書はすべて，この規定の必須部分のすべてに適合しなければならない。

12.2.3 XForms適合生成器