先行入力完了コンポーネント

inputText フィールドに結び付けられた場合、ユーザーがフィールドに入力を行うと、 入力候補のリストが作成され、フィールドに結び付けられたポップアップ・リスト・ボックスに表示されます。 または、ユーザーが入力を行うと、候補をフィールドに自動的に入力することもできます (この場合、ユーザーは、キーボードを使用して追加の候補を選択することができます)。 先行入力は、候補のリストを作成するときに、AJAX 要求を使用してサーバーと通信します。 したがって、リストの作成中もページは引き続き表示されます (送信/再描画されません)。 リストの作成中、ユーザー・インターフェースはアクティブのままになります。
注: <h:inputText> の先行入力サポートは、Web ブラウザーの制限があるため、DBCS (マルチバイト) 文字をサポートしません。

レンダリング

コンポーネントのビジュアル・レンダリングは、選択したコンポーネントによって異なります。

「クイック編集」ビュー

「クイック編集」ビューを使用して、このコンポーネントを構成します。 「クイック編集」ビューを開くには、 「ウィンドウ」 > 「ビューの表示」 > 「クイック編集」とクリックします。

<hx:inputHelperTypeahead> コンポーネントの共通属性を次の表にリストします。

表 1. 「先行入力完了」コンポーネントの属性

属性名

説明

value

実行時に表示されるコンポーネントの初期テキスト値を指定します。 表示される情報が、指定された値または動的な値のポインターのフォームで組み込まれます。

binding

コンポーネントの インスタンス (通常はユーザー・インターフェース・ コンポーネント) を、Bean プロパティー (通常は バッキング・ファイル内にあります) にバインドする式です。

id

コンポーネントに名前を割り当てます。JSP 内で固有の名前にする必要があります。

inProgress

属性はまだ使用可能になっていません。

matchWidth

true の場合、 候補のドロップダウン・メニューは、入力フィールドと同じ幅になります。 false の場合、この幅はドロップダウンの CSS によって決まります。

maxSuggestions

表示される候補の最大数。

rendered

true または false に設定できます。
  • false - コンポーネントは、実行時にブラウザーにレンダリングされません。
  • true - コンポーネントがレンダリングされます。これはデフォルト値です。

size

制御の幅 (文字単位)。CSS を使用すると、幅をより正確に指定できます。

startCharacters

候補が表示される前に入力フィールドに最低限入力する必要のある文字数。

startDelay

候補が表示されるまでの遅延時間 (ミリ秒単位)。つまり、ユーザーが startDelay ミリ秒以内に 2 番目の文字を入力した場合、1 番目の文字に対して候補は表示されません。

styleClass

この要素がレンダリングされるときに適用される、 CSS スタイル・クラスのリスト (スペース区切り)。 この値は、生成されたマークアップの クラス属性として渡されなければなりません。 選択されたコンポーネントのクラス (例えば、スタイルシート) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なクラスを選択してください。

type

ダイアログ・ボックスのタイプ。 モーダル・ダイアログ・ボックスは、 ダイアログの下のウィンドウに対する キーボード入力やマウス入力をブロックします (ダイアログへの 入力後に「OK」または「キャンセル」を押さない限り、 そのページで他の操作を行うことはできません)。 形式なしダイアログ・ボックスは、ダイアログの「下」にあるウィンドウへの入力をブロックしません。
注: 複数の形式なしダイアログ・ボックスを一度に表示できます。 複数のモーダル・ダイアログ・ボックスが 同時に表示されている場合、 各ボックスは重なって表示され、 最上部のダイアログのみがアクティブになります。

oncomplete

要求が成功した場合、 パネルの内容を置換した後で、 ここで指定する JavaScript™ を 実行します。 この関数には、有効な引数がありません。

onerror

onblur が起動して、 フィールド値の妥当性検査が失敗した場合に 実行される JavaScript 関数 (指定 する場合)。 この関数は、アクションが実行される前に実行されます。関数が false を返す場合、アクションは実行されず、イベントの処理は (DOM によって停止される場合) 停止されます。

onstart

振る舞いが開始される際に、 この JavaScript 関数が 実行されます。 この関数には、有効な引数がありません。false を返す場合、実行は停止します。この関数を oncomplete と併せて使用すると、要求の進行中に表示される内容をカスタマイズできます。


フィードバック