レコード・セットをスクロールするコンポーネントを挿入する際に使用します。スクロールするレコード・セット数は、バインドされたデータソースのrangeSizeによって異なります。
<jbo:DataScroller
datasource="datasourceId"
[ targetURL="event-handling page | the JSP with the component" ]
[ relativeUrlPath="component's JSP page | DataScrollerComponent.jsp" ]
/>
バインド先のデータソースの表示範囲を変更できるようにするには、<jbo:DataScroller>
コンポーネント・タグを使用します。 範囲の位置を変更することにより、ユーザーはデータソースのレコードを一度に複数の単位で移動できます。通常、DataScrollerコンポーネントとDataTableコンポーネントを併用して現在の範囲を表示します。 DataScrollerコンポーネントとDataTableコンポーネントを併用する場合は、これらのコンポーネントが同じデータソースにバインドされている必要があります。
DataScrollerコンポーネントがスクロールするレコード数は、ビュー・オブジェクトの範囲サイズで制御されます。 JSPページでは、<jbo:DataSource>
データ・タグのrangeSize
属性を設定することにより範囲サイズを制御できます。 たとえば、rangeSizeを10に指定すると、DataScrollerコンポーネントはデータソースの現在の範囲の位置を一度に10レコードずつ移動します。 DataScrollerコンポーネントがバインドされるデータソースに対してrangeSizeを設定しない場合、DataScrollerコンポーネントはレコードを1つずつスクロールします。
DataScrollerコンポーネントによりレンダリングされたスクローラは、現在の範囲の最初と最後の行の索引を表示します。表示可能な範囲全体の行数も表示します。ユーザーは、スクローラの「Next」および「Previous」アクション・リンクをクリックして範囲の位置を変更できます。DataScrollerコンポーネントは、範囲の位置に応じて次の範囲操作アクションを処理します。
注意: スクローラのレンダリング時に、範囲の位置が最後または最初のセットにある場合、「Next」または「Previous」アクション・リンクは選択不可の状態で表示されます。
通常、同じJSPページを使用してデータ・スクローラの表示、操作イベントの処理およびレコードの表示を行います。 この場合、targetURL
の値を指定する必要はありません。同じJSPページで操作と表示が可能なのは、DataScrollerコンポーネントが次の2つの処理を行うためです。
操作と表示を別々のJSPページで実行する場合は、targetURL
属性に表示ページの名前を指定します。
DataScrollerコンポーネントをJSPページに追加する場合、アプリケーション・モジュールは、ステートレス・モードではなく、ステートフル・モードまたはリザーブ・モードで解放する必要があります。ステートフル・モードまたはリザーブ・モードを使用することにより、次回JSPページが実行される際(ユーザーがデータ・スクローラ操作イベントをトリガーした直後)には範囲の位置が保存されます。
DataScrollerに指定するデータソースでは、ビュー・オブジェクトを順方向のみのモードで使用しないでください。 <jbo:DataSource>
データ・タグのforwardonly
属性のデフォルト設定はfalse
です。 forwardonly
属性をtrue
に設定すると、ビジネス・コンポーネント・データ・タグ・ライブラリのコンポーネント・タグを使用するJSPページでランタイム・エラーが発生します。
<jbo:DataSource>
データ・タグで定義したデータソースID。
/navigate.do
になります。
relativeUrlPath: (オプション)コンポーネント・タグを実装するJSPファイルの場所。デフォルトでは、JDeveloperに用意されているDataScrollerComponent.jsp
ファイルを参照します。コンポーネントの動作をカスタマイズするために独自のコンポーネント実装ファイル(.jsp
)の名前を指定できます。カスタマイズ済の既存のコンポーネント実装ファイル(.jsp
)を参照するよう名前を編集することもできます。
作成または参照するファイルがプロジェクトのHTMLルート・ディレクトリにある場合は、相対パスを指定する必要があります。 たとえば、カスタム・コンポーネント実装ファイルMyDataScrollerComponent.jsp
をcomponents
というプロジェクトのHTMLルート・ディレクトリに作成した場合、relativeUrlPathの値は/components/MyDataScrollerComponent.jsp
になります。
次の例では、バインド先のデータソースのスクロール・バーを表示します。この例では、DataScrollerのターゲットはこのコンポーネントを使用するJSPです。(DataScrollerタグをJSPページに挿入すると生成される)DataScrollerコンポーネントのJSPページの位置は、プロジェクトのJSPページと同じレベルです。
<jbo:DataScroller datasource="LocationsView" />
Copyright © 1997, 2004, Oracle. All rights reserved.