イベント・ハンドラー

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

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

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

フィードバック