機械翻訳について

「アプリケーション」でのイベントの定義

イベントは、applicationで何かが発生したときに発生します。 たとえば、ページがロードされる(ライフサイクル・イベント)、ボタンがクリックされる(コンポーネント・イベント)、変数値が変更される(可変イベント)などです。 イベント・タイプは、トリガー方法によって異なります。たとえば、ボタンやメニューによってコンポーネント・イベントがトリガーされます。

イベントおよびイベント・リスナーの定義方法は、イベントのタイプおよびスコープによって異なります。 次の表では、イベントのタイプと定義方法について説明します:
イベントのタイプ 説明 定義方法
コンポーネント・イベント

動的コンポーネントに含まれるものを含む、ページのUIコンポーネントに関連付けられたイベント。 コンポーネントがトリガーするイベントを選択できますが、使用可能なイベントはコンポーネントによって異なります。 たとえば、ojActionのようなイベントはボタンで使用できますが、入力テキスト・フィールドには使用できません。

ページ・デザイナのコンポーネント・プロパティ・ペインで、コンポーネント・イベントおよびイベント・リスナーを定義します。 「コンポーネントからのアクション・チェーンの起動」を参照してください。

変数イベント

変数に格納されている値が変更されたときに発生する変数に固有のイベント。 使用可能な変数イベントはonValueChangedのみです。

変数エディタで変数イベントおよびイベント・リスナーを定義します。 「変数が変更された場合のアクション・チェーンの開始」を参照してください。

カスタム・イベント
アクション・チェーンを開始するユーザー定義イベント。 アクション・チェーンのファイア・イベント・アクション、またはモジュール・ファンクション(JavaScriptファンクション)でイベント・ヘルパーのfireCustomEvent()メソッドを使用してトリガーできます。 参照:

アクション・チェーン・エディタまたはイベント・エディタでカスタム・イベントを作成し、イベント・リスナー・エディタでカスタム・イベントのイベント・リスナーを作成します。 「カスタム・イベントの起動によるアクション・チェーンの開始」を参照してください。

ヒント:

イベント・エディタから直接、カスタム・イベントのイベント・リスナーを作成することもできます。 イベント・エディタでカスタム・イベントを右クリックし、「イベント・リスナーの作成」をクリックして、イベントと同じ範囲で(eventId)Listenerというイベント・リスナーを作成します。
ライフサイクル・イベント

ページのライフサイクル中に自動的にトリガーされる事前定義済イベント:

  • vbBeforeEnterは、ページに移動する前にトリガーされます。
  • vbEnterは、すべてのフロー変数またはページ変数が初期化されたときにトリガーされます。

  • vbBeforeExitは、ページから移動する前にトリガーされます。

    vbBeforeExitイベントでは、オプションで、プロパティcancelledがtrueに設定されたオブジェクトを返すことによって、ナビゲーションを取り消すことができます(たとえば、ページに未保存の変更がある場合)。 ブラウザ(戻るボタンまたは進むボタン)を使用する場合、イベントのペイロードは、デフォルト・パラメータ値を含むオブジェクトです。 「Oracle Visual Builder Studioページ・モデル・リファレンス」のvbBeforeExitの説明を参照してください。

  • vbExitは、フローまたはページから移動する前にトリガーされます。
  • vbAfterNavigateは、ページへのナビゲーションが完了するとトリガーされます。

アクション・チェーンをこれらのイベントに関連付けて、ページまたはフローのデフォルト・ライフサイクルを強化できます。 たとえば、ページのオープン時に一部のコンポーネント変数を初期化する場合は、vbEnterイベントをリスニングするイベント・リスナーをアーティファクトに作成してから、コンポーネント変数に値を割り当てるアクション・チェーンをトリガーするようにイベント・リスナーを設定できます。

その他の事前定義済イベントは次のとおりです:
  • vbNotification: 通知メッセージをブラウザに表示するために「通知の起動」アクションによってトリガーされます。
  • vbDataProviderNotification: データ・プロバイダによってトリガーされ、暗黙的なフェッチ中に問題が発生したときに発生する可能性のある致命的なエラーをユーザーに通知します。
  • vbResourceChanged: 更新されたアプリケーションを表示するためにリフレッシュする必要があることをユーザーに通知するためにアプリケーションが更新されたときにトリガーされます。

イベント・リスナー・エディタで、ライフサイクル・イベントのイベント・リスナーを作成します。 「ライフサイクル・イベントからのアクション・チェーンの開始」を参照してください。

フラグメント内のイベントは、ページ、フローまたはアプリケーション内とほぼ同じですが、ページ、フローまたはアプリケーション・スコープ内でサポートされているすべてのイベントがフラグメント内で使用できるわけではありません。 「フラグメントでの処理およびイベントの定義」を参照してください。