navigationBarについて

navigationBarコンポーネントは、一連のステップまたはレコード・ブロックの中でのユーザーの現在の位置を示しつつ、作成されたリンクを使用してその前後のステップやレコードに移動できるナビゲータを作成する際に使用します。

pageButtonsコンポーネント内で使用されるnavigationBarコンポーネントは、ページ・タイトルの下のみでなくページの最下部にも表示されます。

navigationBarコンポーネントを使用すると、次の2種類のナビゲータを作成できます。

ステップ・バイ・ステップ・ナビゲータは、ウィザード内のステップなど、既知の一連のステップを通じたタスクの進行状況を示します。デフォルトでは、ステップ・バイ・ステップ・ナビゲータの文字列は「ステップ3/6」の形式で生成されます。生成されるリンクは「戻る」と「次へ」で、これによりユーザーは1ステップずつタスクを移動できます。

Back button, Step 35 of 100, Next button

レコード・ナビゲータは、レコード・セットが非常に多い場合に使用します。レコード・ナビゲータでは1回で1ブロック分のレコードが表示され、設定したblockSize属性に基づいて文字列が生成されます。たとえば、ブロック・サイズが10の場合、このレコード・ナビゲータで生成される文字列は「10-19/100」という形式になります。また、レコードの範囲を参照するリンクは「前の10」および「次の10」という形式で生成されます。

Previous 10, 31-40 of 100 block option, Next 10

blockSize属性は、デフォルトでは定数「-1」に設定されており、ステップ・バイ・ステップnavigationBarがレンダリングされます。これをその他の任意の値に設定すると、navigationBarは現行の表示ブロック・サイズとして指定した数のレコードを持つレコード・ナビゲータとしてレンダリングされます。また、blockSizeのゼロは特殊な値であり、これに設定すると範囲がなくリンクも使用できないnavigationBarがレンダリングされます。

ステップ・バイ・ステップ・ナビゲータまたはレコード・ナビゲータに対して生成されるリンクは、navigationBarコンポーネントのdestination、value、nameという属性に基づいて生成されるURLです。生成されるURLのパラメータは、gotoイベントID、リクエストされて表示すべきステップまたは値、ソース・パラメータとして渡されるナビゲーション・バーのコンポーネント名です。レコード・ナビゲータが表単位でレンダリングされる場合には、表のコンポーネント名がソース・パラメータとして使用されます。

navigationBarコンポーネントでは、JavaScriptを使用してフォーム送信を起動するリンクを生成できます。navigationBarのformSubmitted属性が「true」に設定されている場合にはフォーム送信が有効になっているため、「event」フィールドは「goto」、「source」フィールドはナビゲーション・バーのコンポーネント名、「value」フィールドはリクエストに対して表示するステップまたは値に、それぞれ設定されます。レコード・ナビゲータの場合、ナビゲータが表単位でレンダリングされていれば「source」フィールドが表のコンポーネント名に設定され、「size」フィールドは表示するレコードの数に設定されます。

「すべてを表示」オプションをレコード・ナビゲータで表示するかどうかを指定するには、showAll属性を使用します。

注: navigationBarは、ユーザーがリンクをクリックした時点でgotoイベントを送信します。したがって、リンクが適切に機能するためには、gotoイベント・ハンドラを設定しておく必要があります。

リスト付きステップ・バイ・ステップ・ナビゲータ

読取り専用の「ステップX/Y」文字列をリストで置き換えるには、linkコンポーネントをnavigationBarの子として挿入します。navigationBarはリンク先を無視して同じgotoイベントを起動します。

リストを使用している場合、ユーザーは任意の数のステップをジャンプして元に戻ることができます。しかし、maxVisited属性を設定していない場合には、現在のステップより先に進むことはできません。maxVisited属性は、所定のステップまでジャンプした後で、それより前のステップに戻る場合にのみ設定します。


pageButtonBarについて

レコードnavigationBarの作成
ステップ・バイ・ステップnavigationBarの作成
pageButtonBarの作成
ナビゲーション・コンポーネントの使用

 

Copyright © 1997, 2004, Oracle. All rights reserved.