> 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-combobox.md).

# AX - コンボボックス

ドロップダウンから1つ以上のオプションを選択できます。単一選択または複数選択に対応し、必要に応じて検索や、ドロップダウン内のカスタムアクションも利用できます。

## 概要

**AX - Combobox** Experience Cloud コンポーネントで、Experience Sites ページに設定可能なドロップダウン ピッカーを表示します。

ポータル ユーザーが、固定のオプション一覧または Salesforce から取得した値から選択できるようにします。単一選択または複数選択のコントロールとして使え、必要に応じて検索やカスタムアクションをドロップダウン内に表示できます。オプション、動作、スタイルは Experience Builder でコードなしに設定できます。

フィルター、設定選択、カテゴリ選択、またはユーザーがオプションのセットから選ぶあらゆるフォーム項目に最適です。

## 設定

### データソース

コンボボックスのオプションの取得元を選択します:

| データソースタイプ | 説明                                         | 使用例                 |
| --------- | ------------------------------------------ | ------------------- |
| **手動**    | 各オプションを直接入力します（ラベル、値、補助テキスト、無効）。           | 固定の静的なオプション一覧。      |
| **クエリ**   | クエリを使用して、Salesforce オブジェクトからオプションを自動入力します。 | データと同期して維持すべきオプション。 |

### プロパティ

**API 名** コンポーネントを参照するために使用される一意の識別子です。 **ラベル** コンボボックスの上に表示されるフィールドラベルです。 **フィールドレベルヘルプ** ラベルの横にヘルプテキストのツールチップを追加します。

**既定値** コンポーネントの初回読み込み時に選択されるオプションを設定します。

**バリアント** ラベルの配置を制御します: `標準` （既定）、 `ラベルを横並び`, `ラベルを縦並び`、または `ラベルを非表示`. **プレースホルダー** 選択が行われる前に表示されるテキストです。

**ドロップダウンの配置** 入力欄に対するドロップダウンの位置を指定します — `自動` （既定）、 `左`, `右`, `中央`, `左下`, `下中央` または `右下` — および **ドロップダウンの表示件数** スクロールする前に表示されるオプション数を設定します（`5件`, `7件` （既定）、または `10件`).

**複数選択** ユーザーが複数のオプションを選択できるようにします。 **選択時に開いたままにする** 各選択後もドロップダウンを開いたままにします（複数選択で便利です）。

**検索を許可** オプションを絞り込む検索ボックスを追加します。 **検索までオプションを非表示** ユーザーが入力を開始したときのみオプションを表示します。

**必須** この項目を必須としてマークします。 **無効** ユーザーの操作を防止します。

**クリアアイコンを非表示** 現在の選択をクリアするボタンを削除します。 **選択済みオプションを非表示** すでに選択されたオプションをドロップダウン一覧から非表示にします。

**アクション** ドロップダウン内に表示されるカスタムアクションを定義します。各アクションにはラベル、アイコン、位置、クリック時のインタラクションがあり、固定表示する、検索中のみ表示する、結果がないときのみ表示する、といった設定もできます。

**オプション** 手動データソースの選択可能な項目を定義します。各項目にはラベル、値、任意の補助テキスト、無効状態があります。

## インタラクション

[インタラクション](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions.md) ユーザーがコンボボックスを操作したときに何が起こるかを定義します。Experience Builder にはインタラクション タブはありません — 各インタラクションは、属するイベントのプロパティエディタ内で設定します。

### 変更

各オプションにはそれぞれ独自の **変更時** インタラクションがあり、オプションの **オプション** エディタ（手動ソース）で設定されるか、レコードにマップされます（クエリソース）。そのオプションが選択値になると実行されるため、コードなしで選択に応答できます — たとえば、フィルタされたページへ移動したり、選択内容に依存するフローを開いたりできます。

### クリック

「 **アクション** 」以下の各項目には、それぞれ独自の **クリック時** インタラクションがあり、ユーザーがドロップダウン内のそのアクションをクリックすると実行されます。

どちらも次のインタラクションに対応します:

* [トーストを表示](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/show-toast.md)
* [移動](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/navigate.md)
* [ダウンロード](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/download.md)
* [アラートモーダルを開く](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-alert-modal.md)
* [確認ダイアログを開く](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-confirm.md)
* [フロー ダイアログを開く](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-dialog.md)
* [フローを実行](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/execute-flow.md)

## スタイリング

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

{% tabs %}
{% tab title="マージン" %}
コンボボックスの外側の余白を制御します。
{% endtab %}

{% tab title="パディング" %}
コンボボックスの内側の余白を制御します。
{% endtab %}

{% tab title="サイズ" %}
コンボボックスの寸法（幅 / 高さ / オーバーフロー）を制御します。
{% endtab %}

{% tab title="ボーダー" %}
コンボボックスの周囲の枠線（色 / サイズ / スタイル / 角半径）を制御します。
{% 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-combobox.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.