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内だけである点と，動作の対象が単純な値ではなくインスタンスデータの部分木である点とが異っている。

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