振る舞いのコンポーネント

Java™ ウィジェット・ライブラリー (JWL) 振る舞いは、それを収容するタグに、共通機能を実行するイベント・ハンドラーを追加します。 例えば、onblur イベントの起動時に タグの値を検証する入力タグの onblur ハンドラー に、JWL 振る舞いを追加できます。

振る舞いが呼び出されると、用意された Javascript とともに 1 つ以上の JWL アクションが実行されます。 JWL アクションは、「フィールドの使用不可化」、「フィールドの非表示」、「アラート・ボックスの表示」などといった、Javascript の定義済みブロックになります。 また、いくつかの振る舞い (特に、検証に関する振る舞い) では、フィールドと関連付けられる CSS クラス (および既存の機能およびアクション) を切り替えることができます。

JWL 振る舞いは、オブジェクトのイベント・ハンドラーに対して、置き換えではなく追加を行います。 例えば、オブジェクトの onblur ハンドラーに JavaScript™ 関数を 与えて、さらに onblur 関数に振る舞いを与えることができます。 イベント・ハンドラーと振る舞いはともに、イベントが発火したときに実行されます。

実行の順序

ある振る舞いがユーザー提供の Javascript 関数を実行できる場合、 その関数は JWL アクションの前に実行されます。 関数が false を戻すと、アクションは実行されません。 同様に、関数が false を戻した場合には、どの CSS スタイルも適用されません。 Actions も同じように振る舞います。アクションが false を戻した場合、追加アクションは実行されません。

この振る舞いのほかに Javascript イベント・ハンドラーが提供されている場合 (例えば、スクリプトが onblur イベント・ハンドラーに結び付けられていて、同じ onblur イベント・ハンドラーに振る舞いが結び付けられている場合)、提供された JavaScript は、イベントに応じて最初または最後に実行されます。 JavaScript イベント・ハンドラーが最初に実行されて false を戻した場合、その振る舞いは実行されません。

使用可能な behavior タグは以下のとおりです。

この表では、パレットで最初は非表示になっているコンポーネントの名前の横には、アスタリスク (*) が付けられています。

表 1. イベント・ハンドラーとして使用される振る舞いタグ
コンポーネント タグ名 説明
一般的な振る舞い <hx:behavior> JWL アクション、JavaScript、またはその両方を DOM イベント・ハンドラーに割り当てます。
キー・プレスの振る舞い <hx:behaviorKeyPress> コンポーネント またはコンポーネントの内容がフォーカスされている ときに、JWL アクション、JavaScript またはその両方を、ファンクション・キーまたはコントロール・キーを押す操作に割り当てます。
右マウス・クリックの振る舞い <hx:behaviorRightMouse> JWL アクションおよび/または Javascript を、コンポーネントまたはコンポーネントのコンテンツに対する右マウス・ボタンのクリック操作に割り当てます。
入力支援の振る舞い <hx:inputHelperAssist> クライアント・サイドの検証、入力プロンプト、自動タブ設定などを inputText フィールドに割り当てます。
フィールド・トラッキングの振る舞い <hx:inputHelperFormTracker> フィールド/カーソルのトラッキングを使用可能にし、 フォームが送信されたときに、 フォーカス/カーソルが最後に存在した場所に関する情報が送信の一部として伝送されます。 このタグは、主として、iSeries ベースのアプリケーションで使用されます。
キー・バインドの振る舞い <hx:inputHelperKeybind> 現在では使用すべきではなくなっています。 hx:behaviorKeyPress によって置き換えられました。
初期フォーカス設定の振る舞い <hx:inputHelperSetFocus> ページがロードされるときに、初期フォーカスをページ内のコントロールに合わせます。
先行入力完了コンポーネント <hx:inputHelperTypeahead> 先行入力サポート (自動候補またはオートコンプリート) を inputText フィールドに割り当てます。
関連概念
非同期の JavaScript コンポーネントおよび XML (AJAX) コンポーネント
JavaServer Faces (JSF) の概要
JSF ウィジェット・ライブラリー (JWL)
JavaServer Faces (JSF) を使用した Web アプリケーションの開発

フィードバック