> 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-language-selector.md).

# AX - 言語セレクター

## 概要

**AX - 言語セレクター** Experience Sites ページ上に言語ピッカーを表示し、ポータルユーザーが利用可能な言語を切り替えられる Experience Cloud コンポーネントです。

国際的な顧客やパートナー向けに多言語サポートを提供するために使用します。このコンポーネントは、Experience Site に設定されたすべての有効な言語を表示し、ユーザーが別の言語を選択するとページの内容を更新します。

グローバルな顧客ポータル、国際的なパートナーサイト、複数地域のサポートセンター、または異なる言語を話すユーザーに対応するあらゆるポータルに最適です。

<details>

<summary>🔀 Salesforce 標準言語選択と Avonni Language Selector の違い</summary>

Avonni Language Selector は、次の機能により Salesforce 標準の言語選択を上回ります。

1. **言語グループ化:** 地域やその他の基準で言語を整理し、ユーザーフレンドリーな体験を実現します。
2. **ビジュアルカスタマイズ:** セレクターの見た目と操作感を、Web サイトのデザインに合わせて調整できます。
3. **高度な機能:** 標準セレクターにはない、メニュー nubbin のカスタマイズや柔軟なメニュートリガーなどの機能を活用できます。

Avonni Language Selector を使えば、機能的で見た目にも魅力的、そして Web サイト独自のアイデンティティに完全に一致した多言語体験を作成できます。

</details>

## **準備を整える: 基本設定**

### **ラベル**

* 言語選択メニューの上に表示されるラベルをカスタマイズします。
* または、「現在の言語をラベルとして使用」オプションを切り替えて、現在選択されている言語をラベルとして動的に表示します。

<figure><img src="/files/74c1b2eea57a3c38d859d678775b67e83417b752" alt="" width="563"><figcaption></figcaption></figure>

### **言語グループ**

* Language Groups 機能を使用して、複数の言語を別々の列に整理します。
* 選択した言語が有効で、サイトで利用可能であることを確認してください。

<figure><img src="/files/e0cc70644d8b3def2c88a9e56f3a925b7c8ce128" alt="" width="306"><figcaption></figcaption></figure>

## **ビジュアルカスタマイズ**

### **アイコン名とサイズ**

言語の多様性を表すシンボル（たとえば地球儀）を選び、サイトのデザインに合うようにサイズを調整します。

### **バリアント**

サイトの美観に合うビジュアルスタイル（bare、bare-inverse、base、border、border-filled など）を選択します。

### **メニューの配置**

サイトの美観に合うビジュアルスタイル（bare、bare-inverse、base、border、border-filled など）を選択します。

## **メニューの動作**

### **メニューの起動方法**

訪問者がボタンをクリックする、ホバーする、またはフォーカスすることで言語オプションを表示しますか？ 見込みユーザーにとって最も直感的な操作を選択してください。

### **メニュー ヌビン**

この小さな矢印は、案内標識のようにメニューからコンポーネントへ向かうことを示すさりげない演出です。

### **メニュータイトル**

わかりやすくするために、メニューに明確なタイトル（例: 「言語を選択」）を付けます。

## **役立つヒントとアクセシビリティ**

### **ツールチップ**

ユーザーがコンポーネントにホバーしたときに、ツールチップで簡単な説明や手順を表示します。

### **下矢印を非表示**

よりすっきりした見た目にしたい場合は、通常ドロップダウンに付随する下向き矢印アイコンを非表示にできます。

### **拡張**

このオプションを使用すると、コンポーネントが拡張してコンテナいっぱいに表示され、洗練された見た目になります。

### **無効**

必要に応じて言語選択機能を一時的に無効にします。

### **水平方向の配置**

コンテナ内でのコンポーネントの水平方向の配置（左、中央、右）を制御します。

Avonni Language Selector を使用すると、Experience Cloud サイトは世界中のユーザーを歓迎するハブになります。訪問者は好みの言語を簡単に選択でき、コンテンツをスムーズかつ快適に閲覧できます。


---

# 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-language-selector.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.
