> 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 - コンボボックス** は、Experience Sites ページに設定可能なドロップダウンピッカーを表示する Experience Cloud コンポーネントです。

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

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

## 設定

### データソース

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

| データソースの種類 | 説明                                         | ユースケース               |
| --------- | ------------------------------------------ | -------------------- |
| **手動**    | 各オプションを直接入力します（ラベル、値、補足テキスト、無効）。           | 固定の静的なオプションリスト。      |
| **クエリ**   | クエリを使用して Salesforce オブジェクトからオプションを自動入力します。 | データと同期を保つ必要があるオプション。 |

### プロパティ

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

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

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

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

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

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

**必須** フィールドを必須としてマークし、 **無効** ユーザー操作を禁止します。

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

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

**オプション** 手動データソースの選択可能な項目を定義します — それぞれにラベル、値、任意の補足テキスト、無効状態を設定できます。

## スタイリング

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

{% 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.