<navigationBar>要素 |
![]() |
ネームスペース: | http://xmlns.oracle.com/uix/ui |
派生元: | <ui:base>要素 |
グループ: | UIX Components |
要素の型: | UINode |
構文 |
![]() |
<navigationBar
[ blockSize="unsignedInt"
]
[ destination="anyURI"
]
[ formName="string"
]
[ formSubmitted="boolean"
]
[ maxValue="unsignedInt"
]
[ minValue="unsignedInt"
]
[ name="string"
]
[ typeText="string"
]
[ unvalidated="boolean"
]
[ value="unsignedInt"
] >
</navigationBar>
説明 |
![]() |
<navigationBar>要素は、多数のステップまたはレコード内での現在位置をユーザーに示すために使用されます。ユーザーは、これらのステップまたはレコード間を、生成されたリンクを使用して移動できます。 NavigationBarには、シングルステップとマルチステップの2つの異なるタイプがあります。デフォルトのシングルステップ・バーは、ウィザード内のステップなど、知られている一連のステップの進捗を示します。テキストは「ステップ3/6」の形式で生成されます。 マルチステップNavigationBarは、非常に多くのレコードを持つ表内で使用され、「11-20/100」の形式のテキストを含み、外観が異なります。TableBean自体が、自身のレンダリングの一部としてマルチステップNavigationBarを作成するため、クライアントはTableBeanに依存することになります。 注意: 現在の仕様では、TableBean外でのマルチステップNavigationBarの作成は必要とされていません。そのような使用方法の可能性について現在検討されています。最終的にそのシナリオを採用しないことに決めた場合、スタンドアロンのマルチステップNavigationBarを作成する機能は、将来のリリースではなくなる可能性があります。 表示するNavigationBarのタイプはblockSizeプロパティにより指定します。デフォルトは定数"-1"で、シングルステップNavigationBarがレンダリングされます。これをその他の任意の値に設定すると、NavigationBarは、現行の表示ブロック・サイズとして指定した数のレコードを持つマルチステップ・コントロールとしてレンダリングされます。 blockSizeを特殊な値であるゼロに設定すると、範囲がなく、リンクが使用できないNavigationBarがレンダリングされます。 minValueプロパティおよびmaxValueプロパティにより、ナビゲーション可能なレコードまたはステップの範囲が決まります。たとえば、ステップ1からステップ10までのナビゲーションの場合、minValueを1にmaxValueを10に設定する必要があります。1000から100000の社員番号のナビゲーションの場合は、1000をminValueとして、100000をmaxValueとして使用します。minValueプロパティのデフォルトは1であるのに対し、maxValueプロパティのデフォルトは特殊なUIConstant値である-1です。-1を指定すると、ナビゲーションの範囲が不明であることを反映して、レンダリングが変更されます。 valueプロパティにより、シングルステップ・ナビゲーションの現在のステップ、またはマルチステップ・ナビゲーションで現在表示されている最初のレコードが決まります。 NavigationBarによるナビゲーション・リンクは、引数を持つ標準的なURLとしても、値付きの送信フォームとしてもレンダリングできます。 デフォルトでは、NavigationBarにより、2つのプロパティdestinationおよびnameに基づいてURLリンクが生成されます。destinationプロパティには、生成されるすべてのリンクのリンク先となるベースURLを指定します。nameプロパティは、sourceパラメータに変換され、イベントのソースを示します。URLのパラメータには、gotoイベントID、sourceパラメータとして渡されるNavigationBarのnameプロパティ、表示する要求値またはステップの値が含まれています。NavigationBarがTableBeanにより作成され、レンダリングされる場合、NavigationBarは、自身をレンダリングする表の名前を継承します。 たとえば、シングルステップNavigationBarのステップ3/6で、destinationプロパティが"http://bali.com/navigate.jsp"の値に、nameプロパティが"testNav"に設定されている場合、「戻る」リンクのリンク先は次のように生成されます。
"testTable"という名前のTableBeanで、「11-20/100」と表示されるマルチステップのNavigationBarが作成された場合、「10行前へ」リンクのリンク先は次のように生成されます。
NavigationBarでは、JavaScriptを使用してフォームの送信を引き起すリンクもレンダリングできます。フォームの値に加えてユーザーの要求したナビゲーションを示す値を非表示として同時に送信するため、編集可能なフォーム・コントロールを含むTableBeanによってレンダリングされるNavigationBarの場合に役立ちます。 NavigationBarにフォームベースのURLをレンダリングさせるには、NavigationBarBeanまたはNavigationBarBeanを作成するTableBeanのformSubmittedプロパティをtrueに設定します。その結果、次の名前の非表示のフィールドがレンダリングされます。
サーバーでは、これらの非表示フィールドは、ServletRequestからの直接パラメータとして取得できます。フォームがナビゲーション・イベントの一部として送信されなかった場合、これらのパラメータには値は設定されません。
NavigationBarのプロパティ
ナビゲーション・リンク
"http://bali.com/navigate.jsp?event=goto&source=testNav&value=2"
そして、「次へ」リンクのリンク先は次のように生成されます。
"http://bali.com/navigate.jsp?event=goto&source=testNav&value=4"
"http://bali.com/navigate.jsp?event=goto&source=testTable&value=1&size=10"
そして、次「10行後へ」リンクのリンク先は次のように生成されます。
"http://bali.com/navigate.jsp?event=goto&source=testTable&value=20&size=10"
これらはページにレンダリングされます。ユーザーがNavigationBarリンクを選択した結果、フォームが送信される場合、eventフィールドはgotoという値に、sourceフィールドはそのイベントを生成するNavigationBarまたはTableの名前に、valueフィールドはナビゲーションのターゲット値に、sizeフィールドは表示するレコード数に設定されます。sizeフィールドは、シングルステップのNavigationBarにはレンダリングされません。
例 |
![]() |
次の例では、シングルステップ・ナビゲーション・バーが作成されます。5つのステップがあり、現在ステップ3にいます。
<navigationBar minValue="1" maxValue="5" value="3"/>
次の例では、レコード・ナビゲータが作成されます。レコードは25ずつ表示され、現在のビューはレコード34(100の内)上にあります。
<navigationBar minValue="1" maxValue="100" value="34" blockSize="25"/>
属性 |
![]() |