# アクションエディタ

クションエディタで、コンポーネントの操作によって開始する処理内容を設定します。ボタンのonClickイベントに似ています。

Dashcombでは選択したボタンをクリックした時や[クエリ](https://docs.dashcomb.com/dashcomb-help-center/ide/query-region)の実行が成功・失敗した時など、さまざまな条件を設定できます。実行させる動作にも、[クエリ](https://docs.dashcomb.com/dashcomb-help-center/ide/query-region)実行、ページ遷移、通知表示などさまざまなものを選択できます。

Dashcombが提供しているアクションエディタは、次のアイコンを押すと表示されます。

* コンポーネント[Button](https://github.com/dashcomb/gitbook-doc/blob/master/ide/region/ui-component/button.md)のプロパティ領域の「アクション」項目にあるエディタアイコン
* コンポーネント[Table](https://github.com/dashcomb/gitbook-doc/blob/master/ide/region/ui-component/table.md)のプロパティ領域の「アクション」項目にある「＋」アイコンやエディタアイコン
* クエリ領域の[クエリ](https://github.com/dashcomb/gitbook-doc/blob/master/ide/region/ide/region/query-region.md)の実行が「成功時」や「失敗時」のエディタアイコン

アクションエディタで設定可能な項目は、設定対象のコンポーネントやクエリによって変わります。

例えばクエリ領域のアクションエディタは、「実行や移動」と「通知」の二つに分けて設定できます。

***

## アクションエディタのUI <a href="#action-editor-ui" id="action-editor-ui"></a>

***

<figure><img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-b1214b7056e396ded493b8dfb81d5fdc733cc7d7%2FUI%E3%82%B3%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%8D%E3%83%B3%E3%83%88%EF%BC%9A%E3%82%A2%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%A8%E3%83%87%E3%82%A3%E3%82%BF_02.png?alt=media" alt=""><figcaption></figcaption></figure>

アクションエディタの項目は動作タイプなどによって以下のように変わります。

### **ボタン名称**

[Table](https://docs.dashcomb.com/dashcomb-help-center/ide/ui-component/table)の中のボタンの場合のみ、アクションエディタでラベルを設定します。

通常の[Button](https://docs.dashcomb.com/dashcomb-help-center/ide/ui-component/ui-component-button)は、[プロパティ領域](https://docs.dashcomb.com/dashcomb-help-center/ide/property-region)の「テキスト」項目でラベル名を指定します。

クエリ領域にあるエディタはそもそもボタンがないので、対象外です。

初期値は `Action` で、他の文字列への変更が可能です。`{{}}` 構文は利用できません。

### **タイプ**

動作の種類を設定します。

初期は「アクション無し」です。つまり全てのコンポーネントは、設定しない限り何の動作もしません。

#### アクション無し

設定対象にアクションを設定しません。該当ボタンを押したり、[クエリ](https://docs.dashcomb.com/dashcomb-help-center/ide/query-region)、追加の動作を行いません。

#### クエリ実行

選択したアクションが起こった際に、指定のクエリを実行します。

以下の項目を追加で設定します。

<table><thead><tr><th width="206">設定項目名</th><th>設定内容</th></tr></thead><tbody><tr><td>クエリ</td><td>実行するクエリを選択します。アクションをある<a href="../query-region">クエリ</a>に指定すると、ボタンや<a href="../query-region">クエリ</a>の後続の動作として登録します。<a href="../query-region">クエリ</a>は事前に用意する必要があります。</td></tr><tr><td>バリデーション</td><td>クエリ実行前の画面項目のバリデーションを設定します。<br>なし：　バリデーションのを行いません。<br>セクション：　該当セクションの項目を検証します。<br>全体：　当該画面全体の項目を検証します。</td></tr></tbody></table>

#### メニューに移動

指定のユーザーメニューに移動させます。

以下の項目を追加で設定します。

<table><thead><tr><th width="206">設定項目名</th><th>設定内容</th></tr></thead><tbody><tr><td>メニュー</td><td>遷移先のメニューを設定します。<br>既存のメニューやサブメニューがリスト表示されるため、そこから選択します。</td></tr><tr><td>パラメータ</td><td>遷移先に、パラメータが必要なメニューを選択した場合は、追加で設定します。<code>{{}}</code> 構文を利用できます。</td></tr></tbody></table>

#### URLに移動

指定のURLにリダイレクトします。

以下の項目を追加で設定します。

<table><thead><tr><th width="206">設定項目名</th><th>設定内容</th></tr></thead><tbody><tr><td>URL</td><td><p>移動先のURLを指定します。</p><p><code>https://</code> などのプロトコルから始まるページのURLを設定します。</p><p><code>{{}}</code> 構文を利用できます。</p></td></tr></tbody></table>

#### *通知*

画面に通知ボックスを表示します。

以下の項目を追加で設定します。

<table><thead><tr><th width="206">設定項目名</th><th>設定内容</th></tr></thead><tbody><tr><td>アイコン</td><td><p>表示する通知ボックスのアイコンを設定します。</p><p>成功、失敗、疑問、注意の中から選択します。</p></td></tr><tr><td>テキスト</td><td>通知ボックスに表示するメッセージテキストを設定します。<br><code>{{}}</code> 構文を利用できます。</td></tr></tbody></table>

#### *コピー*

*指定のテキストをクリップボードにコピーします。*

*以下の項目を追加で設定します。*

<table><thead><tr><th width="206">設定項目名</th><th>設定内容</th></tr></thead><tbody><tr><td>テキスト</td><td>クリップボードにコピーするテキストを設定します。<br><code>{{}}</code> 構文を利用できます。</td></tr></tbody></table>

### Table コンポーネントのボタンのアクション

[Button](https://github.com/dashcomb/gitbook-doc/blob/master/ide/region/ui-component/button.md) コンポーネントのアクション指定と違って、[Table](https://github.com/dashcomb/gitbook-doc/blob/master/ide/region/ui-component/table.md)の中のボタンは一律にアクションを指定すれば、全ての行に適用されます。

### ページ内移動

任意の位置にページ内リンクを設置できます。

*以下の項目を追加で設定します。*

| 設定項目   | 設定内容             |
| ------ | ---------------- |
| タイプ    | ページ内移動           |
| オブジェクト | ページ内にあるオブジェクトを選択 |

<figure><img src="https://3498714457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIESKBveovlGvQ1BqYEP%2Fuploads%2Fgit-blob-6c8a577cf3c23ebf326f79e0466b0fc7b890b307%2FBI%20Component%EF%BC%9A%E3%83%9A%E3%83%BC%E3%82%B8%E5%86%85%E3%82%A2%E3%83%B3%E3%82%AB%E3%83%BC%E3%83%AA%E3%83%B3%E3%82%AF.png?alt=media" alt=""><figcaption></figcaption></figure>