<uix:listOfValues>タグ |
 |
ネームスペース: |
http://xmlns.oracle.com/uix/ui |
派生元: |
<uix:base>タグ |
タグの型: |
UINode |
<listOfValues>要素は、LOVダイアログ・ウィンドウの内容を記述します。
構文 |
 |
<uix:listOfValues > </uix:listOfValues>
注意:
このタグは派生元タグのすべての属性と子タグを持つことができます。
説明 |
 |
<listOfValues>要素は、LOVダイアログ・ウィンドウの内容を記述します。この要素は、<lovInput>要素とともに使用するように設計されています。
<listOfValues>要素は、一般的な説明の付いたヘッダー、検索条件ブロックおよび結果表を表示するためのレイアウトを定義します。これらのセクションを使用して、ユーザーは適切な値を検索して選択できます。
<listOfValues>要素では、コンテンツとして任意のUINodeを使用できます。この要素で表示可能なコンテンツは、proxiedおよびformSubmittedが指定された単一表のみです。この表には、有効な値のデータ・セット全体に対して現在の検索基準をフィルタとして使用することによって決定された、すべての有効な値が表示されます。表のすべての管理は開発者が行います。<listOfValues>要素は、表をそのまま表示するだけです。詳細な情報の追跡が必要な場合、開発者は、表とともにflowLayoutの1つ以上の<formValue>要素(非表示フィールド)を指定できます。
LOVウィンドウが開くと、ユーザーが最初に入力したテキストに基づいて予想された完成表が表示されます。ユーザーは、取消を選択することも(その場合、元のlovInputフィールドは変更されません)、表示された1つまたは複数の行を選択する、表内の別の行へ移動する、別のカテゴリについて検索する、あるいは新規の検索文字列/フィルタ基準を入力することもできます。
LOVウィンドウには、検索用パラメータを設定するための検索ブロックが表示されます。このブロックでは、4つの異なるモードがサポートされています。モードは、searchAreaMode属性を使用して設定します。検索領域ブロックは、「検索」ラベル、「Go」ボタンおよび様々な入力フィールドとともにレンダリングされます。入力フィールドは、searchAreaModeによって次のように異なります。
- basic検索: 1つの検索テキストの入力フィールドがレンダリングされます。
- filter検索: 1つの検索テキストのフィールド、およびカテゴリの選択プルダウンがレンダリングされます。カテゴリの選択項目によって、入力した検索テキストが適用される列を選択できます。カテゴリの選択項目は、名前の付けられた子であるfilterChoiceを使用して、開発者が指定します。名前の付けられた子であるfilterChoiceが指定されていない場合、このモードでは、basicモードとまったく同じ内容がレンダリングされます。
- simple検索: このモードでは、filter検索モードと同じ内容がレンダリングされますが、検索ブロックの端に「拡張検索」トグル・ボタンもレンダリングされます(このボタンの詳細は後述を参照)。
- advanced検索: このモードでは、テキスト要素および入力要素が任意のレイアウトでレンダリングされます。検索ブロックの端に「Simple Search」トグル・ボタンもレンダリングされます(このボタンの詳細は後述を参照)。要素のレイアウトは、名前の付けられた子であるadvancedChoicesを使用して、開発者が指定します。
いずれのモードでも、検索領域の最後の要素として「Go」ボタンがレンダリングされます。検索領域の「Go」ボタンをクリックした場合、すべてのフォーム要素でlovFilterイベントが生成されますが、関係するパラメータは次の4つのみです。
- searchText: 検索対象となる値または値の一部です。LOV表の作成時に必要なデータセットのフィルタリングに使用します。
- <choice element name>: このパラメータにより、名前の付けられた子要素であるfilterChoiceの選択オプションが指定されます。注意: 実際のパラメータ名は<choice element name>ではなく、名前の付けられた子であるfilterChoiceとして定義された<choice>要素のname属性です。
- source: このLOVウィンドウを表示したメイン・ページのlovInputフィールドが指定されます。これによって、LOV検索の進捗を最初から最後まで追跡できます。
- searchAreaMode: 現在の検索ブロック・モードが指定されます。
前述のように、simpleモードとadvancedモードの両方で、トグル・ボタンがレンダリングされます。このボタンをクリックすると、lovSearchModeイベントが起動されます。このイベントによって、開発者はsearchAreaModeのsimpleモードとadvancedモードを切り替えることができます。関係するパラメータは次の2つのみです。
- source: このLOVウィンドウを表示したメイン・ページのlovInputフィールドが指定されます。これによって、LOV検索の進捗を最初から最後まで追跡できます。
- searchAreaMode: ターゲットの検索ブロック・モードが指定されます。(searchAreaModeが現在advancedに設定されている場合、「Simple Search」ボタンが表示されます。このボタンをクリックすると、searchAreaModeパラメータがsimpleに指定されたlovSearchModeイベントが生成されます。)
LOVウィンドウが表示された後、エンド・ユーザーは次の8つの操作を行えます。
- 検索フィルタのカテゴリを変更(filterChoiceのプルダウンを使用)
- 検索フィルタ・テキストを編集
- 表示された表から1つ以上の行を選択/選択解除
- 検索ブロックのいずれかのボタンをクリック(「Go」ボタン、またはいずれかのsearchAreaModeトグル・ボタン)
- 表操作を実行(表の1ページに表示可能な行数を超える行がデータセットにある場合、別の行セットに移動するなど)
- 「選択」ボタンをクリック
- 「取消」ボタンをクリック
- LOVウィンドウを閉じる
後半の5つの操作のみがサーバーに対するイベントを生成します。検索ブロックのトグル・ボタンの詳細は、前述の説明を参照してください。残りのイベントすべてに、非表示フィールドがパラメータとして定義されます。各イベントには、次のパラメータも含まれます。
- <choice element name>: このパラメータにより、名前の付けられた子要素であるfilterChoiceの選択オプションが指定されます。送信時に返される実際のパラメータ名は、名前の付けられた子であるfilterChoiceとして定義された<choice>要素のname属性です。
- searchText: 検索対象となる値または値の一部です。
また、各イベントは、value、size、<tableName>:length、<tableName>:selectModeと、場合によっては<tableName>:selected:<selectionNumber>などの標準的な表関連パラメータを取得します。
これら5つのイベント生成ユーザー操作は、次のように動作します。
通常は次のように使用されます。<listOfValues>要素は<lovInput>要素とともに使用するように設計されています。ここでは、両方の要素の属性に対応した方法を説明します。
- ユーザーがlovInputテキスト・フィールドを変更するか、または検索アイコンをクリックします(あるいはその両方)。
- onLovValidateコールバックが起動されます。クライアントは、検証URLに渡されるパラメータを追加、削除または更新できます。テキストを変更せずに検索アイコンをクリックした場合、onLovValidateイベントは起動されずにLOVウィンドウが直接表示されます。
- onLovValidateがfalseを返した場合、変更せずにメイン・ページに戻ります。
- trueを返した場合、lovValidateイベントはサーバーに送信されます。このイベントには次の2つのパラメータがあります。sourceパラメータには<lovInput>要素の名前が含まれ、searchTextパラメータにはlovInputテキスト入力フィールドからのデータが含まれます。このイベントの送信に使用されるURLには、クライアントがonLovValidateコールバックで追加または変更したパラメータが含まれます。
- lovValidateハンドラは事前チェックを行い、trueまたはfalseを返すように<lovInput>要素のshowWindow属性のデータ・プロバイダを設定します。
- showWindow属性がfalseに設定された場合、メイン・ページが(lovValidateイベント・ハンドラで更新された値を使用して)再度レンダリングされ、LOVウィンドウは表示されません。
- showWindow属性がtrueに設定された場合、LovInputサポート・ライブラリのLOVウィンドウを開く関数をコールするJavaScriptコールがブラウザに送信されます。
- onLovInitコールバックが定義されている場合は、それがコールされます。このコールバックには、onLovValidateと同じインタフェースがあります。クライアントは、LOVウィンドウURLに渡されるパラメータを追加、削除または更新できます。
- <lovInput>要素のdestination属性として定義されているURL、およびonLovInitコールバックに追加されたパラメータを使用して、LOVウィンドウが開きます。LOVウィンドウのフォームには、メインの表セクションがあります。これは<listOfValues>要素の索引付けされた子です。コンテンツには任意のUINodeを使用できますが、表示可能な要素は表のみです。ここで非表示フィールドを追加して、任意のボタン操作または表操作によってレンダリングすることができます。
- ユーザーが選択をクリックした場合、lovSelectイベントが起動されます。このイベントのハンドラは、プロバイダを更新する必要があります。
- ユーザーが取消をクリックするか、ウィンドウを閉じた場合、イベントは起動されず、再レンダリングは行われません。すべての値は、LOVウィンドウが開く前と変わりません。
- LOVウィンドウが閉じます。lovUpdateイベントが起動されます。lovUpdateハンドラは、必要なすべてのクリーンアップを行う必要があります。メインのlovInputフィールドとともに再レンダリングが必要になる依存フィールドがクライアントにある場合、lovUpdateハンドラの部分ターゲット・リストに追加する必要があります(ページの部分的な更新が可能な環境の場合のみ)。
- 更新された値を使用してメイン・ウィンドウが再レンダリングされます。
onLovValidateコールバックでfalseを返すか、<lovInput>要素のunvalidated属性をtrueに設定することで、検証ステップ全体をスキップできます。同様に、onLovInitコールバックでfalseを返すことで、クライアントはLOVウィンドウを開かないようにできます。
ページの部分リフレッシュとともにメイン・ページの再レンダリングも実行されます(可能な場合)。
ページを部分的に更新できない環境の場合、検証は行われず、ユーザーは検索アイコンを明示的にクリックする必要があります(onChangeイベント・ハンドラは生成されません)。メイン・ページの再レンダリングは、ページ全体に対して行われます。
ほとんどのPDAブラウザでは複数のウィンドウが使用できないため、アプリケーションではlovInputページとの間で切替えを行う必要があります。サーバー上のlistOfValuesページへフォワードしたり、このページからlovInputページへのリダイレクトする必要があります。フォワード先およびリダイレクト先はアプリケーションによって異なります。PDAでは、listOfValuesページからの検索の実行はサポートされていません。
属性 |
 |
|
説明 |
型 |
destination |
フォームの送信先のURL。通常はNULLであるか、LOVがコールされたメイン・ページをポイントしています(デフォルト)。 |
string |
searchAreaMode |
検索領域の表示方法。有効な値はbasic、filter、simpleおよびadvancedです。デフォルトはbasicです。下位互換性を保つために、子であるfilterChoiceが存在し、searchAreaModeが設定されていない場合、検索ブロックはfilterモードでレンダリングされます。このフォールバックは推奨されていません。searchAreaModeは常に、必要なモードに設定することをお薦めします。将来のリリースでは、どの名前の付けられた子が存在する場合でも、デフォルトは常にbasicとなります。 |
string |
searchText |
検索される文字列。この値に基づく表への入力を実際に行うのは、resultsTableを指定する開発者の役割です。この値はtextInputフィールドに表示されます。エンド・ユーザーが「Go」ボタンをクリックすると、lovFilterイベントが生成され、searchTextパラメータは新規の検索テキストを取得します。 |
string |
stateCheck |
onLovSelectコールバックの直前、およびlovSelectイベントの配信の直前にコールされるJavaScript関数の名前。通常は、lovSelectイベントの配信直後にLOVウィンドウは閉じます。ただし、この属性が指定されており、指定したメソッドがFALSEを返す場合、ウィンドウは閉じません。この機能によって、クライアントに表選択の状態をチェックする方法が提供されます。ユーザーが(現在表示中の行セット、または以前に表示されていた行セットの)表データから選択を行っていない場合、クライアントではLOVウィンドウが表示されたままになりますが、<messages>という名前の付けられた子によってエラー・メッセージが表示されます。 |
string |
title |
この値リストが適用されるフィールド。この属性は、エンド・ユーザーに対して情報を提供するだけです。表示されたダイアログの最上部ヘッダーに表示されます。 必須。 |
string |
|
子タグ |
 |
|
説明 |
必須 |
最大値 |
<uix:advancedChoices> |
テキスト入力フィールドおよび選択フィールドのレイアウト。このレイアウトは、searchAreaMode属性をadvancedに設定した場合にのみ表示されます。通常は、一連のtextInputフィールドまたは<choice>要素(あるいはその両方)が表示され、ユーザーは複数列の検索を実行できます。 ダイアログのレイアウトは、labeledFieldLayoutとともに使用すると最適です。 |
いいえ |
1 |
<uix:contents> |
Beanの索引付けされた子。 |
いいえ |
1 |
<uix:filterChoice> |
このchoiceノードには、ユーザーが必要な値を検索するためのすべての表ヘッダーがリスト表示されます。たとえば、部門を検索する際、有効なフィルタ列は場所列と名前列です。開発者が部門番号を表示しても、ユーザーが部門番号でフィルタリングすることは許可されません。この場合、このchoiceにDepartmentとLocationは含まれますが、Department Numberは含まれません。1つの論理的フィルタ列しかない場合、このノードは省略できます。 |
いいえ |
1 |
<uix:headerInstructions> |
LOVウィンドウのヘッダー・ブロックに表示される短い説明テキスト。OraInstructionTextクラスを持つstyledTextノードである必要があります。 |
いいえ |
1 |
<uix:messages> |
関連するエラー・メッセージを表示するメッセージ・ボックス。 |
いいえ |
1 |
<uix:searchInstructions> |
LOVウィンドウの検索ブロックに表示される短い説明テキスト。OraInstructionTextクラスを持つstyledTextノードである必要があります。 |
いいえ |
1 |
|
This document was generated on Wed Jul 07 19:23:45 PDT 2004
Copyright 2001, 2004, Oracle.All rights reserved.