これらのオブジェクトは、一般的な方法では使用できません (ユーザーはオブジェクトを作成して使用することはできません)。代わりに、これらのオブジェクトは入力支援の振る舞いによって作成されます。
支援オブジェクトは、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 呼び出しはありません。支援オブジェクトは、振る舞いの実装専用です。
コンバーター |
説明 |
---|---|
タイプ「数値」の入力フィールドに対するキー・ストローク・イベントやマウス・イベントを管理します。 |
|
タイプ「日付/時刻」の入力フィールドに対するキー・ストローク・イベントやマウス・イベントを管理します。 |
|
タイプ「支援」の入力フィールドに対するキー・ストローク・イベントやマウス・イベントを管理します。 |