タブ・パネルのイベント・ハンドラー

多くの Faces コンポーネントは、関連付けられたイベントを持っています。例えば、コマンド - ボタン・コンポーネントには、onclick および onmousedown などのイベントが関連付けられています。選択された Faces コンポーネントのクイック編集ビューを使用して、特定イベントのアクションを定義することができます。

コンポーネントのクイック編集ビューの左側ペインのイベントをいったん選択すると、クイック編集 ビューの右側ペインで JavaScript™ コードを入力することができます。このコードは、イベントが呼び出される時に実行されるアクションを表しています。

次の表は、タブ・パネル・コンポーネントのイベントおよびタブ・パネル・コンポーネントのパネルのイベントを示しています。
イベント 説明 サポートされるコンポーネント
oncancel 使用可能な場合、ユーザーが「キャンセル」をクリックすると、実行されます。このイベントのイベント・ハンドラーで、任意のビジネス・ロジック (幾つかの入力フィールドにユーザーが入力した値の消去など) を追加することができます。イベント・オブジェクトは、次の 1 つのプロパティーを持っています。tabpanelForm - タブ・パネルを囲む HTML フォーム (ある場合)。 タブ・パネル
onenter タブ・パネルのパネルが表示されるときに実行されます。イベント・ハンドラーが true を戻すと、タブ・パネルは新規パネルを表示することができます。イベント・ハンドラーが true を戻さない場合、フォーカスが前のパネル上に残ったままになります。このイベントのイベント・ハンドラーで、ユーザーが入力する情報を確認したり、パネルに表示される情報を用意したりすることができます。イベント・オブジェクトは、次の 1 つのプロパティーを持っています。tobeEnterPanel - 表示対象のパネルの ID。 タブ・パネル内のパネル
onexit タブ・パネルのパネルが終了されるときに実行されます。イベント・ハンドラーは、3 つの異なる値を戻すことができます。パネル ID が戻されると、デフォルトの次のパネルの代わりにその ID のパネルが次に表示されます。true が戻されると、デフォルトの次のパネルが表示されます。false が戻されるか、何も戻されない場合は、フォーカスが現在のパネル上に残ったままになります。このイベントのイベント・ハンドラーで、任意のビジネス・ロジックを追加することができます。例えば、ユーザーによる入力を確認したり、検査が失敗した場合にパネルから離れるのを拒否したり、次のパネルへのフローを制御したりすることができます。タブ・パネルが「次へ」および「前へ」ボタンとともに使用されるとき、複雑なフローを作成するためにこのイベント・ハンドラーを使用できます。イベント・オブジェクトは、次の 1 つのプロパティーを持っています。tobeExitPanel - 表示対象のパネルの ID。 タブ・パネル内のパネル
onfinish onfinish イベントは、タブ・パネル制御でサポートされ、使用可能な場合に、ユーザーが「終了」を押すと実行されます。このイベントのイベント・ハンドラーで、ユーザーによる情報入力の確認やフォームの送信などの、任意のビジネス・ロジックを追加できます。イベント・オブジェクトは、次の 1 つのプロパティーを持っています。tabpanelForm - タブ・パネルを囲む HTML フォーム (ある場合)。 タブ・パネル
oninitialpanelshow このイベントは、タブ・パネルがページに表示される前に実行されます。このイベント・ハンドラーからの戻り値は、どのパネルが最初にアクティブになるかを判別します。戻り値がないと、最初のパネルが表示されます。ユーザーが、最初のパネル以外のパネルを最初に表示するには、戻り値がそのパネルの ID である必要があります。 タブ・パネル
onpanelenter onpanelenter イベントは、タブ・パネル制御でサポートされ、ユーザーがタブ・パネルでパネルを表示するとき実行されます。パネルが、onenter イベントのイベント・ハンドラーを既に持っている場合、そのイベントは onpanelenter イベントより先に呼び出されます。イベント・ハンドラーが true を戻すと、タブ・パネルは新規パネルを表示することができます。イベント・ハンドラーが true を戻さない場合、フォーカスが前のパネル上に残ったままになります。このイベントのイベント・ハンドラーで、パネルを表示する際に呼び出す必要がある共通のビジネス・ロジックを追加することができます。イベント・オブジェクトは、次の 1 つのプロパティーを持っています。tobeEnterPanel - 表示対象のパネルの ID。 タブ・パネル
onpanelexit onpanelexit イベントは、タブ・パネル制御でサポートされ、ユーザーがタブ・パネルでパネルを終了するとき実行されます。パネルが、onexit イベントのイベント・ハンドラーを既に持っている場合、そのイベントは onpanelexit イベントより先に呼び出されます。イベント・ハンドラーが true を戻すと、タブ・パネルはパネルを終了することができます。イベント・ハンドラーが true を戻さない場合、フォーカスが現在のパネル上に残ったままになります。このイベントのイベント・ハンドラーで、パネルの終了時に呼び出される必要がある共通のビジネス・ロジックを追加することができます。イベント・オブジェクトは、次の 1 つのプロパティーを持っています。tobeExitPanel - 終了対象のパネルの ID。 タブ・パネル
フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005