<navigate>要素
ネームスペース: http://xmlns.oracle.com/uix/controller
派生元: <ctrl:eventHandler>要素
グループ: UIX Controller
要素の型: EventHandler

<navigate>要素は、ページ・ナビゲーションを実行する宣言バインディングを定義します。 ナビゲーションはハードコードされるため、直接関係するのは主にアプリケーションのプロトタイプ設計者ですが、他の開発者にも有益な場合があります。

構文
<navigate
      parameter="string"
>
     <!-- The following child can be anything derived from the given element -->
   <when></when>
</navigate>

注意:
  • この要素は派生元要素のすべての属性と子要素を持つことができます。

  • 説明

    <navigate>要素は、1つのイベント・パラメータとパラメータに対する条件値のリストからなります。 各値に対応して、ターゲット・ページを指定します。 リスト内にパラメータと一致する値が見つからない場合、ナビゲーションは実行されず、同じページが再表示されます。

    開発者への注意: <navigate>要素は、EventResult内のPageオブジェクトを受け入れるPageFlowEngineでのみ機能します。 これは、デフォルト・エンジン(TrivialPageFlowEngine)には該当しますが、カスタム・エンジンを使用する場合は該当しない場合があります。


    次の例では、<navigate>要素はgotoイベントを処理します。 valueパラメータを調べ、1、2または3に一致する場合、対応するページであるfirst、secondまたはthirdが、イベントへの応答としてレンダリングされます。

    <handlers>
      <event name="goto">
        <navigate parameter="value">
          <when value="1" page="first"/>
          <when value="2" page="second"/>
          <when value="3" page="third"/>
        </navigate>
      </event>
    </handlers>

    属性

    説明
    parameter ナビゲーション・イベントのgotoなどでチェックの対象となるイベント・パラメータの名前。  必須。
    string

    子要素

    説明 必須 組込み可能な数
    <when>
    任意の数の値。
    いいえ 無限