<uix:lovInput>タグ
ネームスペース:  http://xmlns.oracle.com/uix/ui
派生元:  <uix:textInput>タグ
グループ:  UIX Components
タグの型:  UINode

このタグは、LOVモーダル・ウィンドウを起動するためのテキスト・フィールドとして使用されます。

構文
<uix:lovInput
    [ destination="anyURI" ]
    [ destinationBinding="data binding to anyURI" ]
    [ onLovInit="string" ]
    [ onLovInitBinding="data binding to string" ]
    [ onLovSelect="string" ]
    [ onLovSelectBinding="data binding to string" ]
    [ onLovValidate="string" ]
    [ onLovValidateBinding="data binding to string" ]
    [ showWindow="boolean" ]
    [ showWindowBinding="data binding to boolean" ]
    [ unvalidated="boolean" ]
    [ unvalidatedBinding="data binding to boolean" ]
    [ validateBlanks="boolean" ]
    [ validateBlanksBinding="data binding to boolean" ]
>
</uix:lovInput>

注意: 
  • このタグは派生元タグのすべての属性と子タグを持つことができます。

  • 説明

    このタグは、LOVウィンドウを起動するためのテキスト・フィールドとして使用されます。この要素は、listOfValues要素とともに使用するように設計されています。詳細は、listOfValues要素のトピックを参照してください。

    この要素はtextInputフィールドと検索アイコンを表示します。アイコンがクリックされた場合(あるいはページの部分リフレッシュ環境でテキストが変更された場合)、一連のコールバックおよびイベントが起動され、フィールド内のテキストが検証されて、場合によってはLOVウィンドウが表示されます。unvalidated属性をfalseに設定することで、この一連の動作の検証部分だけを完全に無効にできます。

    最初に、onLovInitコールバックが実行されます。コールバックがtrueを返した場合、lovInput要素のdestination属性で指定したページを表示するモーダル・ウィンドウが開きます。このページを開くURLには、onLovInitコールバックで追加、変更または更新されたパラメータが含まれます。リンク先ページは、開いた後で、2つの関連パラメータを持つlovFilterイベントを受け取ります。

    LOVウィンドウが開くと、ユーザーが最初に入力したテキストに基づいて予想された完成表が表示されます。ユーザーは、取消を選択することも(その場合、lovInputのtextInputフィールドは変更されません)、表示された行の1つを選択する、表内の別の行へ移動する、別のカテゴリについて検索する、あるいは新規の検索文字列を入力することもできます。詳細は、listOfValues要素のトピックを参照してください。

    LOVウィンドウが閉じると、onLovSelectコールバック(指定されている場合)が実行されます。その後、lovCloseイベントが生成されます。

    ページの部分リフレッシュ環境では、lovInput要素の一部が拡張されます。

    ユーザーが検索アイコンをクリックした場合、または入力フィールドのテキストが変更された場合(フィールド全体に空白が入力されている場合でも、validateBlanks属性が検証を制御します)、最初にonLovValidateコールバックが実行されます。クライアントはこのコールバックを使用して、ページから追加のデータを取得できます。イベントのURLで送信されるパラメータは、追加、更新または削除(あるいはそのすべて)ができます。onLovValidateコールバックがfalseを返した場合、検証プロセスは停止します。onLovValidateコールバックがtrueを返した場合、2つの関連パラメータを持つlovValidateイベントが生成されます。

    lovValidateハンドラでは、クライアントは入力が有効かどうか、または一意の一致であるかどうかをチェックする必要があります。一意の一致とは、ユーザーが「san fran」と入力し、データ値がCaliforniaの都市名であるときに、一致する可能性があるのは「San Francisco」のみである場合などを指します。データが有効な場合、showWindow属性はfalseに設定されます(一部かつ一意の一致の場合、テキスト・フィールドのプロバイダを更新して、前述の例でいう「San Francisco」という値全体が指定されるようにする必要があります)。データが有効でない場合、showWindow属性はtrueに設定されます。showWindowのデフォルト設定はfalseであるため、showWindowは必要な場合にのみEventResultで指定します。

    lovInputは部分リフレッシュの要求を受け取ると、showWindow属性をチェックします。showWindowがfalseである場合、単にテキスト・フィールドが再レンダリングされます。showWindowがtrueである場合、LOVウィンドウが開きます。

    ユーザーが入力フィールドのテキストに変更を加えず、lovInputの検索アイコンをクリックした場合、検証イベントは生成されません。LOVウィンドウが直接作成されます。


    属性

    説明
    destination LOVウィンドウを移入するページへのパス。
    URI
    onLovInit LOVウィンドウが開く前にコールされるJavaScript関数の名前。シグネチャは次のとおりです。

    function initCallBack(params)

    params引数は、LOVウィンドウを開く際に使用するURLに含まれるすべてのパラメータによって構成される単純なオブジェクトです。開発者は、このコールバックのパラメータを追加、削除または更新できます。
    string
    onLovSelect LOVウィンドウが閉じた後にコールされるJavaScript関数の名前。シグネチャは次のとおりです。

    function selectCallBack(Win, field, event)

    引数は次のとおりです。
    • Win: LOVウィンドウ。開発者がLOVウィンドウからデータを取得できる最後の機会です。LovSelectコールバックは、小さなデータセットからのデータをlovInputテキスト・フィールドに戻すような単純なケースに使用します。このコールバックはPPR環境ではラウンドトリップを、PPR以外の環境ではリフレッシュを保存できます。将来、データの移動を容易にする一連のプロキシ・ルーチンが提供される予定ですが、現在のリリースには含まれていません。
    • field: fieldは、LOVダイアログを起動したlovInput要素のテキスト・フィールド部分を示します。
    • event: ウィンドウを閉じるイベント。

    string
    onLovValidate lovValidateイベント送信の直前にコールされるJavaScript関数の名前。シグネチャは次のとおりです。

    function initCallBack(params)

    params引数は、イベント送信の際に使用するURLに含まれるすべてのパラメータによって構成される単純なオブジェクトです。開発者は、このコールバックのパラメータを追加、削除または更新できます。
    string
    showWindow テキスト・フィールドの値が有効と判断されると、showWindow属性はfalseに設定されます。lovInputノードのページの部分リフレッシュ時にshowWindowがtrueである場合、LOVウィンドウを表示するためのスクリプトが作成されます。showWindowがfalseの場合、特別な処理は行われません。
    boolean
    unvalidated この値をtrueに設定すると、検証ステップが実行されません。onChangeハンドラは生成されず、lovValidateイベントも生成されません。エンド・ユーザーは、LOVウィンドウを表示することはできますが、検索アイコンのクリック(ページの部分リフレッシュをサポートしていない環境でのデフォルト動作)によってのみ表示できます。
    boolean
    validateBlanks デフォルトでは、入力フィールドが空白であるか、すべて空白文字である場合(有効なテキストから変更された空白文字の場合を含む)、lovValidateイベントは起動されません。この属性をtrueに設定すると、フィールドが空または空白文字のみに変更された場合に、lovValidateイベントが起動されます。
    boolean