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

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

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

以下のテーブルは、タブ・パネル・コンポーネントに関するイベント、 およびタブ・パネル・コンポーネント内のパネルに関するイベントを示しています。
イベント 説明 サポートされるコンポーネント
oncancel ユーザーが「キャンセル」を クリックした時に、使用可能であれば起動される。 このイベントのイベント・ハンドラーを使用すると、いくつかの入力フィールドにユーザーが入力した値をクリアするなどの、 任意のビジネス・ロジックを追加することができます。 このイベント・オブジェクトには 1 つのプロパティーがあります。 tabpanelForm - タブ・パネルを囲む HTML フォーム (あれば)。 タブ・パネル
onenter タブ・パネル内のパネルに入った時に起動される。 イベント・ハンドラーが「真」を戻した場合、タブ・パネルは新規パネルに入ることができます。 「真」を戻さない場合は、フォーカスは直前のパネルに置かれたままになります。 このイベントのイベント・ハンドラーを使用すると、ユーザーが入力した値の検査や、 パネルに表示される情報の準備などが行えます。 このイベント・オブジェクトには 1 つのプロパティーがあります。 tobeEnterPanel - 進もうとしているパネルの ID。 タブ・パネル内のパネル
onexit タブ・パネル内のパネルが終了された時に起動される。 イベント・ハンドラーは 3 つの異なる値を戻すことができます。 「パネル ID」の場合は、デフォルトの次パネルではない、次に進むべきパネルです。 「真」では、デフォルトの次パネルが表示されます。「偽」または何も戻さない場合は、 フォーカスは現行パネルのままです。 このイベントのイベント・ハンドラーを使用すると、ユーザーによる入力を検査したり、 検証が失敗した場合にパネルを終了することを拒否したり、 次の画面へのフローをコントロールしたり、といった任意のビジネス・ロジックを追加することができます。 このイベント・ハンドラーを使用して、 タブ・パネルが「次へ」ボタンまたは「前へ」ボタンとともに使用された時の複雑なフローを作成することができます。 このイベント・オブジェクトには 1 つのプロパティーがあります。 tobeExitPanel - 終了しようとしているパネルの ID。 タブ・パネル内のパネル
onfinish onfinish イベントは、タブ・パネル制御によってサポートされ、 ユーザーが「終了」を押した時に使用可能であれば起動される。 このイベントのイベント・ハンドラーを 使用すると、ユーザーが入力した情報を検査したり、フォームを実行する、といった任意のビジネス・ロジックを 追加することができます。 このイベント・オブジェクトには 1 つのプロパティーがあります。tabpanelForm - タブ・パネルを 囲む HTML フォーム (あれば)。 タブ・パネル
oninitialpanelshow このイベントは、タブ・パネルがページ上でレンダリングされる前に起動される。 このイベント・ハンドラーからの戻り値は、どのパネルが最初にアクティブになるべきかを決定します。 戻り値がない場合は、最初のパネルが表示されます。 ユーザーが最初のパネル以外のパネルを最初に表示したい場合は、 戻り値は、表示したいパネルの ID でなければなりません。 タブ・パネル
onpanelenter onpanelenter イベントは、タブ・パネル制御によってサポートされ、 ユーザーがタブ・パネル内の任意のパネルに入った時に起動される。 そのパネルに既に onenter イベント用のイベント・ハンドラーが存在している場合は、 このイベントより前にそのイベントが呼び出されます。 イベント・ハンドラーが「真」を戻した場合、タブ・パネルは新規パネルに入ることができます。 「真」を戻さない場合は、直前のパネルにフォーカスされたままになります。 このイベントのイベント・ハンドラーを使用すると、 任意のパネルに入った時に起動される必要があるビジネス・ロジックを追加することができます。 このイベント・オブジェクトには、プロパティーが 1 つあります。 tobeEnterPanel - 進もうとしているパネルの ID。 タブ・パネル
onpanelexit onpanelexit イベントは、タブ・パネル制御によってサポートされ、 ユーザーがタブ・パネル内の任意のパネルを終了する時に起動される。 そのパネルに既に onexit イベント用のイベント・ハンドラーが存在している場合は、 このイベントより前にそのイベントが呼び出されます。 イベント・ハンドラーが「真」を戻した場合、タブ・パネルはそのパネルを終了することができます。 「真」を戻さない場合は、現行パネルにフォーカスされたままになります。 このイベントのイベント・ハンドラーを使用すると、 任意のパネルを終了する時に起動される必要があるビジネス・ロジックを追加することができます。 このイベント・オブジェクトには、プロパティーが 1 つあります。 tobeExitPanel - 終了しようとしているパネルの ID。 タブ・パネル
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved. (C) Copyright IBM Japan 2005