<listOfValues>要素 |
![]() |
ネームスペース: | http://xmlns.oracle.com/uix/ui |
派生元: | <ui:uinode>要素 |
グループ: | UIX Components |
要素の型: | UINode |
構文 |
![]() |
<listOfValues
title="string"
[ id="string"
]
[ searchText="string"
] >
<filterChoice> </filterChoice>
<headerInstructions> </headerInstructions>
<searchInstructions> </searchInstructions>
</listOfValues>
説明 |
![]() |
<listOfValues>要素は、LOVダイアログ・ウィンドウの内容を記述します。ウィンドウのレイアウトは、BLAFのList Of Valuesテンプレート、バージョン2.1の定義に従います。この要素は、lovInput要素とともに使用するように設計されています。 listOfValues要素は、カテゴリの選択項目、検索テキスト・フィールドおよび表を表示するためのレイアウトを定義します。これらを使用して、ユーザーは適切な値を選択できます。この要素は、lovInputノードからコールされるように設計されています。lovInputノードにより、値リストがモーダル・ウィンドウに表示されます。
listOfValues要素では、コンテンツとして任意のUINodeを使用できます。
この要素で使用できる表示可能なコンテンツは、proxiedおよびformSubmittedが指定された表のみです。この表には、現行のsearchTextに基づくすべての有効な値が表示されます。表のすべての管理は開発者が行います。listOfValues要素は、表をそのまま表示するだけです。詳細な情報の追跡が必要な場合、開発者は、表とともに1つ以上のformValue要素(非表示フィールド)を指定できます。 LOVウィンドウが開くと、ユーザーが最初に入力したテキストに基づいて予想された完成表が表示されます。ユーザーは、取消を選択することも(その場合、元のlovInputフィールドは変更されません)、表示された1つまたは複数の行を選択する、表内の別の行へ移動する、別のカテゴリについて検索する、あるいは新規の検索文字列/フィルタ基準を入力することもできます。 LOVウィンドウには、検索用パラメータを設定するための検索ブロックが表示されます。このブロックには短い説明と、場合によってはカテゴリの選択項目、textInputフィールドおよび実行ボタンが含まれます。実行ボタンをクリックした場合、すべてのフォーム要素でlovFilterイベントが生成されますが、関係するパラメータは次の2つのみです。
LOVウィンドウが表示された後、エンド・ユーザーは次の8つの操作を行えます。
後半の5つの操作だけがサーバーに対するイベントを生成します。これらのイベントすべてに、非表示フィールドがパラメータとして定義されます。各イベントには、次のパラメータも含まれます。
これら5つのイベントは次のように動作します。
選択ボタン: lovSelectイベントが生成されます。すべての表パラメータおよび非表示フィールドが定義されます。sourceパラメータにより要素のID属性が定義されます。選択ボタンがクリックされると、クライアントは残りの選択情報すべてを更新、取得、および格納する必要があります。
lovSelectイベントがキューイングされた後、LOVウィンドウが閉じます。終了すると、lovWindowはlovUpdateイベントを送信します。このイベントは管理者に、LOVウィンドウが終了し、すべてのデータ・プロバイダを更新する必要があることを通知します。このイベントは、元のLovInput要素がレンダリングされたメイン・ページのフォームを送信します。sourceパラメータには、元のlovInput要素のname属性が含まれます。
通常は次のように使用されます。listOfValues要素はlovInput要素とともに使用するように設計されています。ここでは、両方の要素の属性に対応した方法を説明します。
onLovValidateコールバックでfalseを返すか、unvalidated属性をfalseに設定することで、検証ステップ全体をスキップできます。同様に、onLovInitコールバックでfalseを返すことで、クライアントはLOVウィンドウを開かないようにできます。
ページの部分リフレッシュとともにメイン・ページの再レンダリングも実行されます。
ページを部分的に更新できない環境の場合、事前検証は行われず、ユーザーは検索アイコンを明示的にクリックする必要があります(onChangeイベント・ハンドラは生成されません)。メイン・ページの再レンダリングは、ページ全体に対して行われます。
例 |
![]() |
<listOfValues data:searchText="searchText@lov1@LOV:mappedData"
title="LOV field #1"
data:source="source@lov1@LOV:mappedData">
<headerInstructions>
<styledText text="Header instruction text"
styleClass="OraInstructionText"/>
</headerInstructions>
<!-- This choice just pulls out the column headers -->
<filterChoice>
<choice name="categoryChoice"
multiple="false"
data:selectedValue="categoryChoice@LOV:generalParams">
<contents data:childData="category@LOV:categoryData">
<option data:text="catText"/>
</contents>
</choice>
</filterChoice>
<searchInstructions>
<styledText text="Instruction text for the search area "
styleClass="OraInstructionText"/>
</searchInstructions>
<contents>
<flowLayout>
<contents>
<formValue name="hiddenA" value="valA"/>
<formValue name="hiddenB" value="valB"/>
<!-- Here's the table definition -->
<table name="valuesTable1"
width="80%"
minValue="1"
data:maxValue="max@LOV:tableParams"
data:value="start@LOV:tableParams"
data:blockSize="size@LOV:tableParams"
data:alternateText="alternateText@LOV:tableParams"
data:tableData="row@LOV:tableData"
formSubmitted="true"
proxied="true">
<columnHeaderStamp>
<boundText select="hdrText"/>
</columnHeaderStamp>
<boundAttribute name="columnHeaderData">
<dataObject select="header"
source="LOV:headerData"/>
</boundAttribute>
<tableSelection>
<multipleSelection text="select an item"
data:selected="selected"/>
</tableSelection>
<contents>
<!-- Populate with some sample data -->
<boundText select="C1Dat"/>
<boundText select="C2Dat"/>
<boundText select="rowid"/>
<boundText select="AttrDat"/>
</contents>
</table>
</contents>
</flowLayout>
</contents>
</listOfValues>
属性 |
![]() |
子要素 |
![]() |
|