JSF 支援

JSF 支援オブジェクトは、特定タイプの入力フィールドに対するキーボードおよびマウス対話を管理します。すなわち、フィールドの「入力支援」対話をサポートします。 コンバーターやバリデーターと同様に、これらのオブジェクトも日付用、マスク用、および数値用のタイプがあります。

これらのオブジェクトは、一般的な方法では使用できません (ユーザーはオブジェクトを作成して使用することはできません)。代わりに、これらのオブジェクトは入力支援の振る舞いによって作成されます。

支援オブジェクトは、3 つのその他の JSF オブジェクトを使用します。適切なタイプのコンバーター・オブジェクト (例えば、日付/時刻コンバーター)、適切なタイプのバリデーター・オブジェクト (フィールドが妥当性検査される場合)、および入力状態オブジェクト (振る舞いにより作成され、汎用のキーボード・イベントおよびマウス・イベントを提供) です。

各支援オブジェクトは、キーボード/マウス対話を処理する一連の呼び出しをサポートします。例えば、onfocus ハンドラー、onblur ハンドラー、keypress ハンドラー、cut ハンドラー、paste ハンドラーなどがあります。フィールドに対してイベントが生成されると、イベントは一般のキーボード/マウス状態管理を処理する、そのフィールドの入力状態オブジェクトに送信されます。 入力状態オブジェクトは次に、各イベントにタイプ固有のサポートを提供する、適切な支援オブジェクトを呼び出します。 例えば、ユーザーが左矢印を押した場合、コントロール・キーを判別する入力状態オブジェクトによりキャッチされたイベントが押され、フィールドの状態は「処理中」に設定され、これが、該当する支援オブジェクトの onChangeKeyCode ハンドラーを呼び出します。 キー・コード・ハンドラーは次に、左矢印キーがこのタイプの値に対してどのように処理されるかを決定します。 キーは処理され、フィールドの状態が更新されます。 コントロールは入力状態マネージャーに戻ります。入力状態マネージャーは、状態処理の次のステップを決定します (例えば、フィールドがいっぱいで自動タブを呼び出す必要があるかなどをチェックします)。

3 つの支援オブジェクトの資料では、サポートされている各タイプについて、支援がどのように機能するかの概要を説明しています。

コンストラクター構文

new hX_5.NameAssist(_elem, _state, _converter, _validator, _promptChar)); 各部の意味は次のとおりです。

id

このコンバーターに割り当てられる ID。 この ID は、ページ (またはポータル) 内で作成される、 すべてのコンバーター間で固有でなければなりません。 任意の文字列値を、ID として使用できます。

Name

JSF 支援の名前。 支援オブジェクトのリストについては、以下を参照してください。

_elem

入力フィールドの DOM オブジェクト。

_state

JSF の振る舞いに関連する入力状態オブジェクト。

_converter

フィールドのパターン/フォーマットを定義するコンバーター・オブジェクト。

_validator

振る舞いに関連する、オプションのバリデーター。

_promptChar

このフィールドの入力援助で使用するプロンプト文字 (単一文字)。

API 呼び出し

支援には共通の API 呼び出しはありません。支援オブジェクトは、振る舞いの実装専用です。

支援オブジェクトのリスト

コンバーター

説明

NumberAssist

タイプ「数値」の入力フィールドに対するキー・ストローク・イベントやマウス・イベントを管理します。

DateTimeAssist

タイプ「日付/時刻」の入力フィールドに対するキー・ストローク・イベントやマウス・イベントを管理します。

MaskAssist

タイプ「支援」の入力フィールドに対するキー・ストローク・イベントやマウス・イベントを管理します。

関連概念
JSF ウィジェット・ライブラリー (JWL)

フィードバック