<listOfValues>要素 |
![]() |
ネームスペース: | http://xmlns.oracle.com/uix/ui |
派生元: | <ui:base>要素 |
グループ: | UIX Components |
要素の型: | UINode |
構文 |
![]() |
<listOfValues
title="string"
[ destination="string" ]
[ searchAreaMode="string" ]
[ searchText="string" ]
[ stateCheck="string" ] > <advancedChoices></advancedChoices> <contents><!-- indexed children --></contents> <filterChoice></filterChoice> <headerInstructions></headerInstructions> <messages></messages> <searchInstructions></searchInstructions> </listOfValues>
説明 |
![]() |
<listOfValues>要素は、LOVダイアログ・ウィンドウの内容を記述します。 この要素は、<lovInput>要素とともに使用するように設計されています。 <listOfValues>要素は、一般的な説明の付いたヘッダー、検索条件ブロックおよび結果表を表示するためのレイアウトを定義します。 これらのセクションを使用して、ユーザーは適切な値を検索して選択できます。 <listOfValues>要素では、コンテンツとして任意のUINodeを使用できます。 この要素で表示可能なコンテンツは、proxiedおよびformSubmittedが指定された単一表のみです。 この表には、有効な値のデータ・セット全体に対して現在の検索基準をフィルタとして使用することによって決定された、すべての有効な値が表示されます。 表のすべての管理は開発者が行います。 <listOfValues>要素は、表をそのまま表示するだけです。 詳細な情報の追跡が必要な場合、開発者は、表とともにflowLayoutの1つ以上の<formValue>要素(非表示フィールド)を指定できます。 LOVウィンドウが開くと、ユーザーが最初に入力したテキストに基づいて予想された完成表が表示されます。 ユーザーは、取消を選択することも(その場合、元のlovInputフィールドは変更されません)、表示された1つまたは複数の行を選択する、表内の別の行へ移動する、別のカテゴリについて検索する、あるいは新規の検索文字列/フィルタ基準を入力することもできます。 LOVウィンドウには、検索用パラメータを設定するための検索ブロックが表示されます。 このブロックでは、4つの異なるモードがサポートされています。 モードは、searchAreaMode属性を使用して設定します。 検索領域ブロックは、「検索」ラベル、「Go」ボタンおよび様々な入力フィールドとともにレンダリングされます。 入力フィールドは、searchAreaModeによって次のように異なります。
いずれのモードでも、検索領域の最後の要素として「Go」ボタンがレンダリングされます。 検索領域の「Go」ボタンをクリックした場合、すべてのフォーム要素でlovFilterイベントが生成されますが、関係するパラメータは次の4つのみです。
前述のように、simpleモードとadvancedモードの両方で、トグル・ボタンがレンダリングされます。 このボタンをクリックすると、lovSearchModeイベントが起動されます。 このイベントによって、開発者はsearchAreaModeのsimpleモードとadvancedモードを切り替えることができます。 関係するパラメータは次の2つのみです。
LOVウィンドウが表示された後、エンド・ユーザーは次の8つの操作を行えます。
後半の5つの操作のみがサーバーに対するイベントを生成します。 検索ブロックのトグル・ボタンの詳細は、前述の説明を参照してください。 残りのイベントすべてに、非表示フィールドがパラメータとして定義されます。 各イベントには、次のパラメータも含まれます。
また、各イベントは、value、size、<tableName>:length、<tableName>:selectModeと、場合によっては<tableName>:selected:<selectionNumber>などの標準的な表関連パラメータを取得します。
これら5つのイベント生成ユーザー操作は、次のように動作します。
lovSelectイベントがキューイングされた後、LOVウィンドウが閉じます。 終了すると、lovWindowはlovUpdateイベントを送信します。 このイベントは管理者に、LOVウィンドウが終了し、すべてのデータ・プロバイダを更新する必要があることを通知します。 このイベントは、元の<LovInput>要素がレンダリングされたメイン・ページのフォームを送信します。 sourceパラメータには、元の<lovInput>要素のname属性が含まれます。
通常は次のように使用されます。 <listOfValues>要素は<lovInput>要素とともに使用するように設計されています。 ここでは、両方の要素の属性に対応した方法を説明します。
onLovValidateコールバックでfalseを返すか、<lovInput>要素のunvalidated属性をtrueに設定することで、検証ステップ全体をスキップできます。 同様に、onLovInitコールバックでfalseを返すことで、クライアントはLOVウィンドウを開かないようにできます。
ページの部分リフレッシュとともにメイン・ページの再レンダリングも実行されます(可能な場合)。
ページを部分的に更新できない環境の場合、検証は行われず、ユーザーは検索アイコンを明示的にクリックする必要があります(onChangeイベント・ハンドラは生成されません)。 メイン・ページの再レンダリングは、ページ全体に対して行われます。
ほとんどのPDAブラウザでは複数のウィンドウが使用できないため、アプリケーションではlovInputページとの間で切替えを行う必要があります。 listOfValuesページからサーバー上のlovInputページに戻るか、またはリダイレクトする必要があります。 戻るかまたはリダイレクトする場所の認識は、アプリケーションに依存します。 PDAでは、listOfValuesページからの検索の実行はサポートされていません。
例 |
![]() |
<listOfValues title="LOV field #1"
id="lovHandler"
searchAreaMode="filter"
searchText="${uix.data.fieldData['current'].fieldText}">
<headerInstructions>
<styledText text="Some appropriate instructions about this LOV..."
styleClass="OraInstructionText"/>
</headerInstructions>
<!-- This choice just pulls out the column headers -->
<filterChoice>
<choice name="categoryChoice"
multiple="false"
selectedValue="${uix.data.generalParams.categoryChoice}">
<contents childData="${uix.data.categoryData['.']}">
<option text="${uix.current['.']}"/>
</contents>
</choice>
</filterChoice>
<searchInstructions>
<styledText text="Some appropriate instructions about searching..."
styleClass="OraInstructionText"/>
</searchInstructions>
<contents>
<flowLayout>
<contents>
<table name="lovTbl"
id="lovTbl"
etc... a normal table ...>
<contents>
<!-- Populate the table with data -->
<text text="${uix.current.peak}"/>
etc...
<!-- This element supplies a rowid to show how extra -->
<!-- data could be put on the form. This value will be -->
<!-- submitted with every operation on this table. -->
<formValue name="rowid" value="${uix.current.rowid}"/>
</contents>
</table>
<!-- or the extra data could be supplied outside the table -->
<formValue name="extraData" value="something useful"/>
</contents>
</flowLayout>
</contents>
</contents>
</listOfValues>
属性 |
![]() |
子要素 |
![]() |
|