コンポーネントからのアクション・チェーンの起動
コンポーネントをページ、レイアウトまたはフラグメントに追加する場合(URLを開くなど)、なんらかの動作をトリガーする場合は、コンポーネント・イベント・リスナーを使用してコンポーネント・イベントを作成する必要があります。
1つのコンポーネントに複数の事前定義済イベントを適用できますが、使用可能なイベントは、通常、コンポーネントによって決定されます。 たとえば、ボタンがクリックされるとojActionイベントがトリガーされるため、通常はボタン・コンポーネントに適用されます(テキスト・フィールド・コンポーネントに適用できませんでした)。 各ボタンには一意のイベントがあり、ボタンojActionイベントをリスニングしているイベント・リスナーがあり、イベントが発生するとリスナーはアクション・チェーン(または複数のアクション・チェーン)を起動します。 各コンポーネント・イベントには、通常、対応するコンポーネント・イベント・リスナーがあります。
ノート:
コンポーネントにイベントを追加できるのは、コンポーネントのプロパティ・ペインのみです。 ページのイベント・タブでは作成できません。コンポーネントでアクションを開始するには:
- コンポーネントの「イベント」タブの「プロパティ」ペインで、「+イベント・リスナー」をクリックします。 提案されたイベントをクイック・スタートとして選択することも、別のイベントを使用するカスタム・イベントを作成することもできます。
クイック・スタート・オプションを使用して新しいイベントを追加すると、アクション・チェーンが作成され、アクション・チェーン・エディタが自動的に開きます。 カスタム・オプションを使用して新しいイベントを追加する場合は、イベントを選択する必要があります。
- カスタム・イベントの場合は、アクション・チェーンのトリガーに使用するイベントを選択します。 「選択」をクリックします。
- イベントをトリガーするアクション・チェーンを選択し、「アクション・チェーンの選択」をクリックします。 または、「新しいアクション・チェーン」をクリックして新しいアクション・チェーンを作成します。
プロパティ・ペインの「そのイベント」タブには、アクション・チェーンをトリガーしてVisual Builderが応答するコンポーネント上のイベントが表示されます。 プロパティを編集して、アクション・チェーンで使用する入力パラメータを追加できます。 入力パラメータによって、コンポーネントとそのページの値がアクション・チェーンに提供され、アクション・チェーンはその動作を決定するために使用できます。 たとえば、表選択イベントでは、アクション・チェーンに選択された行の詳細を提供できます。
「
図event-listener-component-edit.pngの説明」
クイック・スタート・オプションを使用してイベントを追加した場合、新しいイベントに対してコンポーネント・イベント・リスナーが作成され、リスナーは作成したアクション・チェーンにマップされます。 「イベント・リスナー」タブを開くと、コンポーネント「イベント・リスナー」の下に、トリガーされるアクション・チェーンとともにリストされます。
「
図event-listener-component-qs.pngの説明」