<listOfValues>要素
ネームスペース:  http://xmlns.oracle.com/uix/ui
派生元:  <ui:uinode>要素
グループ:  UIX Components
要素の型:  UINode

<listOfValues>要素は、LOVダイアログ・ウィンドウの内容を記述します。ウィンドウのレイアウトは、BLAFのList Of Valuesテンプレートの定義に従います。

構文
<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つの操作だけがサーバーに対するイベントを生成します。これらのイベントすべてに、非表示フィールドがパラメータとして定義されます。各イベントには、次のパラメータも含まれます。

    また、各イベントは、value、size、<tableName>:length、<tableName>:selectModeと、場合によっては<tableName>:selected:<selectionNumber>などの標準的な表関連パラメータを取得します。ただし、これらの表パラメータは、実行ボタンをクリックして起動されたlovFilterイベントを処理する際には無視されます。

    これら5つのイベントは次のように動作します。

    通常は次のように使用されます。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>

    属性

    説明
    id この要素を一意に識別する文字列。
    string
    searchText 検索される文字列。この値に基づく表への入力を実際に行うのは、resultsTableを指定する開発者の役割です。この値はtextInputフィールドに表示されます。エンド・ユーザーが実行ボタンをクリックすると、lovFilterイベントが生成され、searchTextパラメータは新規の検索テキストを取得します。
    string
    title この値リストが適用されるフィールドを識別します。この属性は、エンド・ユーザーに対して情報を提供するだけです。表示されたダイアログの最上部ヘッダーに表示されます。このフィールドは、BLAF仕様のLabelフィールドに対応します。必須。
    string

    子要素

    説明 必須 組込み可能な数
    <filterChoice> このchoiceノードには、ユーザーが必要な値の検索に使用できるすべての表ヘッダーがリスト表示されます。たとえば、部門を検索する際、有効なフィルタ列は場所列と名前列です。開発者が部門番号を表示しても、ユーザーが部門番号でフィルタリングすることは許可されません。この場合、このchoiceにDepartmentとLocationは含まれますが、Department Numberは含まれません。1つの論理的フィルタ列しかない場合、このノードは省略できます。
    いいえ 1
    <headerInstructions> LOVウィンドウのヘッダー・ブロックに表示される短い説明テキスト。任意のUINodeを使用できますが、BLAFの標準により、厳密にはOraInstructionTextクラスを持つstyledTextだけが現在有効なノード・タイプです。
    いいえ 1
    <searchInstructions> LOVウィンドウの検索ブロックに表示される短い説明テキスト。任意のUINodeを使用できますが、BLAFの標準により、厳密にはOraInstructionTextクラスを持つstyledTextだけが現在有効なノード・タイプです。
    いいえ 1