> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-button.md).

# AX - ボタン

## 概要

**AX - ボタン** は、Experience Site ページ上にクリック可能なボタンを作成し、ナビゲーション、フォーム送信、レコード作成、モーダルの表示などのアクションを実行できるようにする Experience Cloud コンポーネントです。

カスタムの行動喚起を追加したり、フォームを送信したり、特定のページへ移動したり、レコードを作成したり、フローを起動したりするために使用します。Experience Builder で、コードなしでボタンのラベル、スタイル、アイコン、アクションを設定できます。

ポータル用の CTA、カスタムナビゲーション、「お問い合わせ」アクション、レコード作成のワークフロー、または、明確でブランド化されたボタンを必要とするあらゆるユーザー操作に最適です。

## 設定

Experience Builder で AX - Button をページにドラッグした後、設定する主な項目は 2 つです。ボタンの見た目と、ユーザーがクリックしたときに何が起こるかです（ [インタラクション](#interactions)).

### ボタンの外観

これらの設定で、ページ上でのボタンの見た目を制御します。

**ラベル** はボタンに表示されるテキストです。簡潔で、操作を促す表現にしてください（例:「申請を送信」「詳細を表示」「お問い合わせ」）。

**アイコン名** はラベルの横にアイコンを追加し、ユーザーがアクションをすぐに理解できるようにします。Salesforce のアイコンライブラリから選択できます。一般的な選択肢には `utility:download` はダウンロード用、または `utility:email` は問い合わせ用です。 **アイコンの位置** はアイコンを `左` または `右` のどちらに配置するかを指定します。左は多くの場合に適しており、右は前進するナビゲーションを示すのに向いています。

**バリアント** はボタンの視覚スタイルです: `base`, `neutral`, `brand`, `brand-outline`, `border`, `border-filled`, `border-inverse`, `bare`, `bare-inverse`, `inverse`, `container`, `success`, `destructive`、または `destructive-text`。アクションの重要度とページのデザイン言語に合うものを選択してください。

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FHxGDvstEp4whipGzxnuY%2Fax-button-variant.png?alt=media" alt=""><figcaption><p>14 種類のバリアントのうち 11 種類を、明るいページ上で示しています。3 つの inverse バリアントは暗い背景向けのため、ここには表示していません。白背景では、Bare Inverse には表示されるテキストがなく、Border Inverse は空のアウトラインになります。</p></figcaption></figure>

**水平方向の配置** は、ボタンをコンテナ内でどこに配置するかを指定します—`左`, `中央`、または `右`。中央は単独の CTA に適しており、左揃えはフォームボタンに向いています。

**ストレッチ** はボタンをコンテナ全幅に広げます。目立つ CTA に使うか、その上にあるフォームフィールドの幅に合わせる場合に使います。

**無効** はユーザーがボタンをクリックできないようにします。必要な項目を待っている「送信」ボタンなど、アクションがまだ利用できない場合に使用します。

**タイトル** はボタンにカーソルを合わせたときに表示されるツールチップのテキストを設定し、 **代替テキスト** は、ボタンがアイコンのみを表示する場合に、その説明を行うアクセシブルなテキストを提供します。

**CMS 文書のダウンロード** および **文書 URL または式によるダウンロード** を使うと、クリック時にファイルをダウンロードするボタンになります。インタラクションを起動するのではなく、CMS 文書を参照するか、直接 URL を指定します。

## インタラクション

この **リンク先** 設定は、ユーザーがボタンをクリックしたときの動作を決め、8 種類のアクションタイプを提供します。目的に合うものを選んでください。1 つは、下の見出しよりもパネル内で少し長い表記になっています: **確認ダイアログを開く**.

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-fce8b6da22bc7fa9e8724be171e44a69d9a706e1%2F2023-12-30_11-30-24.png?alt=media" alt="" width="188"><figcaption></figcaption></figure>

### [トーストを表示](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/show-toast.md)

ページ上部に短い通知メッセージを表示し、数秒後に消えます。

使用例: 「変更を保存しました」や「リクエストを送信しました」のように、ユーザーの操作を必要としない確認メッセージ。トーストは、ユーザーの作業を中断せずにフィードバックを提供します。

### [移動](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/navigate.md)

Experience Site 内または外部 URL の別ページへユーザーをリダイレクトします。

使用例: 詳細ページへ移動する「もっと詳しく」ボタン、「ホームに戻る」ナビゲーション、外部リソースへのリンク。標準ページ、レコードページ、またはカスタム URL に移動できます。

### [アラートモーダルを開く](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-alert-modal.md)

ユーザーが先に進む前に確認しなければならないメッセージを含むポップアップウィンドウを開きます。

使用例: 規約、プライバシーの開示、またはアクションを続行する前にユーザーが読む必要のある警告など、重要なお知らせ。

### [確認を開く](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-confirm.md)

ユーザーにアクションの確認またはキャンセルを求める確認ダイアログを表示します。

使用例: レコードの削除、送信のキャンセル、アクセスの削除など、元に戻せない結果を伴うアクション。ダイアログにより、続行する前にユーザーが再考できます。

### [フローダイアログを開く](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-dialog.md)

Salesforce Flow をポップアップモーダルウィンドウで起動します。

使用例: サポートケースの送信、アンケートの完了、アカウント情報の更新など、複数ステップのプロセスや、ガイド付きワークフロー全般。Flow Builder でフローを作成し、それをボタンに接続します。フローは現在のページから移動せずにモーダル内で実行されます

### [フローを実行](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/execute-flow.md)

ダイアログやパネルを表示せずに、自動起動の Salesforce Flow をバックグラウンドで実行します。

使用例: リクエストの記録、レコードの更新、通知の送信など、ボタンの裏で行う自動化。フローにユーザーが操作する画面がある場合は、代わりに **フローダイアログを開く** を使用してください。

### [ダウンロード](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/download.md)

Salesforce ファイル、公開リンク、または URL から、ボタンをクリックするとファイルをダウンロードします。

使用例: 価格表、明細書、契約書、またはポータルユーザーが保持する必要のある文書全般。ファイルがボタンに固定されているのではなく、インタラクションによって決まる場合は、 **CMS 文書のダウンロード** 設定よりこちらを優先して使用してください。

### すべてのクエリを更新

ページ上のすべてのクエリを再実行し、ボタン周辺のコンポーネントに最新データを表示します。

使用例: フローダイアログやモーダルでレコードが変更された後、ユーザーに再読み込みを求めずにページの他の部分を最新状態にする場合。

有効にする **更新動作の上書き** をオンにすると、更新後も何を維持するかを選べます。オフの場合、各コンポーネントは独自の既定値を適用します。最初のページに戻り、Data Table は選択した行をクリアし、List と Timeline は選択した項目を保持します。オンの場合、 **現在のページに留まる** はページ上のすべてのコンポーネントを表示中のページに維持し、 **選択した項目を保持** は選択の扱いを決めます。オフにすると、List と Timeline でも選択はクリアされます。オンにすると、選択は保持されます。 **選択した項目を保持** は Data Table、List、Timeline でのみサポートされ、その他のコンポーネントでは無視されます。

プロパティパネルでは、これらの設定は **リンク先** セクションにあり、Type が **タイプ** である場合に、 **すべてのクエリを更新**次の順序で表示されます: **更新動作の上書き**, **選択した項目を保持**, **現在のページに留まる**.

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FLlbRodkvMnQ4SNamTrNb%2Fexperience-ax-button-refresh-all-queries.png?alt=media" alt="Refresh All Queries editor with Override Refresh Behavior turned on" width="320"><figcaption><p>更新動作の上書きとその 2 つのオプション</p></figcaption></figure>

## スタイル

プロパティエディタの **スタイル** セクションから、ボタンの外観をカスタマイズします。

{% tabs %}
{% tab title="余白" %}
各方向（上、下、左、右）のボタン周囲のスペースを制御します。これらを使ってボタンを正確に配置し、他の要素との重なりを避け、ゆとりを持たせます。
{% endtab %}

{% tab title="ラベル/アイコン" %}

* **色:** ボタンのテキストまたはアイコンの既定色です。
* **アクティブ時の色:** ボタンがクリックまたはタップされたときに、テキスト/アイコンが変化する色です。
* **ホバー時の色:** ユーザーがボタン上にマウスを置いたときに、テキスト/アイコンが変化する色です。
* **フォントファミリー:** ボタンのテキストラベルに使用する書体を指定します。サイト全体のデザインに合い、読みやすいものにしてください。
* **フォントサイズ:** ラベルのテキストサイズを制御します。必要に応じて、可読性や強調のために調整してください。
* **フォントスタイル:** normal、italic、oblique など、テキストのスタイルを設定します。特別な強調にのみ控えめに使用してください。
* **フォントウェイト:** テキストの太さを決定します。主要ボタンと補助ボタンを区別するために、異なるウェイトを使うことを検討してください。
  {% endtab %}

{% tab title="背景" %}

* **背景色:** ボタン背景の既定色です。
* **アクティブ時の背景色:** クリックまたはタップされたときのボタン背景色です。
* **ホバー時の背景色:** ユーザーがボタン上にマウスを置いたときの背景色です。
  {% endtab %}

{% tab title="境界線" %}

* **境界線の色:** ボタンの境界線の色です。
* **アクティブ時の境界線の色:** ボタンがアクティブなときの境界線の色です。
* **ホバー時の境界線の色:** ユーザーがボタン上にマウスを置いたときの境界線の色です。
* **境界線のサイズ:** 境界線の太さ（ピクセル単位）です。
* **境界線のスタイル:** 境界線の種類: solid、dotted、dashed など。
* **境界線の角丸:** ボタンの角の丸みを制御します。値が大きいほど、より柔らかく、角の丸いボタンになります
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-button.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
